Connects a drive letter to a network path or disconnects a currently connected drive from a network path. Some networks require a network user name and password to connect. Used to map a network share to a drive letter.
Declaration
<AMNETDRIVE ACTION="text {options]" DRIVELETTER="text" NETPATH="text" USERNAME="text" PASSWORD="text">
Example
<AMNETDRIVE ACTION="connect" DRIVELETTER="G:" NETPATH="\\server\Publicshare1" USERNAME="myusername" PASSWORD="mypassword">
See Also: Send Email, Dial Up, HTTP, Ping
To set Map Drive properties for connecting a network drive
In the Available Actions pane, open the Network folder and double-click the Map Drive action or drag it into the Steps pane.
In the Option box, select Connect using current user or Connect using different user.
In the Drive letter box, enter or select the drive letter to which you want to connect.
In the Network path box enter a UNC (Universal Naming Convention) path. Example: //SERVER1/ Sharename
If you are connecting using a different user, enter the user name and password in the applicable boxes.
To set the Description tab properties, refer to Description Tab Options.
To set the Error Causes and On Error tab properties, refer to Step Error Handling.
When finished, click OK to save settings and close the properties dialog box.
To set Map Drive properties for disconnecting a network drive
In the Available Actions pane, open the Network folder and double-click the Map Drive action or drag it into the Steps pane.
In the Option box, select Disconnect.
In the Drive letter box, enter or select the drive letter from which you want to disconnect.
To set the Description tab properties, refer to Description Tab Options.
To set the Error Causes and On Error tab properties, refer to Step Error Handling.
When finished, click OK to save settings and close the properties dialog box.
|
Property |
Type |
Required |
Default |
Markup |
Description |
|
Option |
Text (options) |
Yes |
|
ACTION="disconnect" |
Specifies the action that should take place on the drive letter.
|
|
Reconnect at logon |
Check box |
No |
Cleared |
|
Available only when Connect using current user is specified. Select the check box if you want to reconnect to the drive when logged on. |
|
Drive Letter |
Text |
Yes |
|
DRIVELETTER="X:" |
Specifies the drive letter that should be mapped or disconnected depending on the value of ACTION=.
|
|
Network Path |
Text
|
Yes |
|
NETPATH="//SERVER1/Sharename" |
Specifies a UNC (Universal Naming Convention - e.g. //SERVER1/Sharename) path to the network share that should be mapped. This option is only valid if the action parameter is set to "connect". |
|
User Name |
Text |
No |
|
USERNAME="MyUserName" |
Specifies a valid network username that has access to map the requested share.
|
|
Password |
Text |
No |
|
PASSWORD="mypassword" |
Specifies a valid password for the user account specified in the User Name parameter [USERNAME=]. If the step is edited in Visual Mode the password is automatically encrypted.
|
This action includes the Description tab for entering a custom step description.
More on setting custom step description
This action also includes the standard Error Causes and On Error failure handling options/tabs.
More on Error Handling Options
All text fields allow the use of expressions, which can be entered by surrounding the expression in percentage signs (example: %MYVARIABLE%, % Left('Text',2)%). To help construct these expressions, you can open Expression Builder from these fields by pressing F2.