Establishes a connection to another network using a VPN (Virtual Private Network) or dial-up connection. This action can also be used to disconnect a specific VPN or dial-up connection or all presently established connections. This does not take on the redial properties that are specified in the phone book entry. Used to connect to the Internet with a modem or other network device if needed before executing Internet actions.
Declaration
<AMDIALUP ACTION="connect_manual" NUMBER="number" USERNAME="text" PASSWORD="encrypyed text" REDIAL="number" REDIALTIME="number" WAITTYPE="text (options)"/>
Example1 - Establish a dialup connection using manual settings. Attempt to redial a total of 5 times. Pause 1 minute between attempts.
<AMDIALUP ACTION="connect_manual" NUMBER="555-867-5309" USERNAME="theUserName" PASSWORD="AM1TLax4GRtZO1qWN7qDphOEw==aME" REDIAL="5" REDIALTIME="1" WAITTYPE="minutes" />
Example 2 - Disconnect a previously established dialup connection named "myDialupConnection."
<AMDIALUP ACTION="disconnect_phone_book" ENTRY="myDialupConnection" REDIAL="5" REDIALTIME="1" />
See Also: Exchange, Execute Web Service, Get Email, HTTP, Map Drive, MSMQ, Send E-mail, Twitter
To set Connect to Network properties
In the Available Actions pane, open the Network folder and double-click the Connect to Network action or drag it into the Steps pane.
On the General tab, specify the properties that appear as described below.
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 |
|
Connections |
Text |
Yes |
(Empty) |
ENTRY="theConnection" |
Allows the selection of an existing phone book entry created during Dial-Up Networking (DUN) configuration. To select an existing entry, click the Down arrow or manually enter the name in the provided text box. |
|
Action |
Text (options) |
Yes |
(Empty) |
ACTION="disconnect_all" |
Specifies the action that should take place. The available options are:
|
|
Use manual settings |
Yes/No |
No |
No |
ACTION="connect_manual" |
If set to YES, allows manual entry of a dial-up number, user name and password in which to establish a connection with, bypassing the Windows phone book. The connection will be established based on the information entered in the Phone Number, User name and Password parameters. This parameter is valid only if the Action parameter is set to Establish a connection. |
|
Phone number |
Number |
No |
(Empty) |
a)NUMBER="555-867-5309" b)NUMBER="7145551212" |
The phone number that should be used to establish a DUN connection. This option is valid only if the Usparameter is selected in conjunction with the Establish a connection parameter.e manual settings |
|
User name |
Text |
No |
(Empty) |
USERNAME="joe" |
The user name to use when establishing a remote connection. This option is valid only if the Use manual settings parameter is selected in conjunction with the Establish a connection parameter. |
|
Password |
Text |
No |
(Empty) |
PASSWORD="encrypted" |
The password to use when establishing a remote connection. This option is valid only if the Use manual settings parameter is selected in conjunction with the Establish a connection parameter. |
|
Redial Settings |
|
|
|
|
If enabled, allows redial settings to take place as specified via the Redial Attempts and Time Between Attempts parameters. |
|
Redial Attempts |
Number |
No |
(Empty) |
REDIAL="3" |
Specifies the amount of times that the connection should be re-dialed before an error is generated. This option is valid only if the Action parameter is set to Establish a connection. |
|
Time Between Attempts |
Text |
No |
0 |
REDIALTIME="30" |
Specifies the amount of time to wait before attempting to redial the connection. The Wait Type parameter specifies whether this value is referring to seconds or minutes. This option is valid only if the Action parameter is set to Establish a connection. |
|
Wait Type |
Text (options) |
No |
Seconds |
WAITTYPE="minutes" |
Specifies whether the number entered in Time Between Attempts parameter is in seconds or minutes. This option is valid only if the Action parameter is set to Establish a connection. The available options are:
|