Rasdial

Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2

Rasdial

Automates the connection process for any Microsoft client. Used without options, rasdial displays the status of current connections.

Syntax

rasdial ConnectionName [UserName [{Password | *}]] [/domain:Domain] [/phone:PhoneNumber] [/callback:CallbackNumber] [/phonebook:PhonebookPath] [/prefixsuffix]

rasdial [ConnectionName] /disconnect

Parameters
  • ConnectionName
    Required when connecting to a phonebook (.pbk) entry. Specifies an entry in the current .pbk file, located in the systemroot\System32\Ras folder. If the ConnectionName contains spaces or special characters, use quotation marks around the text (that is, "Connection Name").
The Rasphone.pbk file is used unless the **Personal Phonebook** option is selected. If the **Personal Phonebook** option is selected, the file *UserName*.pbk is used. The name is shown on the Rasphone title bar when **Personal Phonebook/p** is selected. Numbers are appended if name conflicts occur.
  • UserName[{ Password| *}]
    Specifies a user name and password with which to connect. If an asterisk is used, the user is prompted for the password, but the characters typed do not display.
  • /domain: Domain
    Specifies the domain in which the user account is located. If unspecified, the last value of the Domain field in the Connect To dialog box is used.
  • /phone: PhoneNumber
    Substitutes the specified phone number for the entry's phone number in Rasphone.pbk.
  • /callback: CallbackNumber
    Substitutes the specified callback number for the entry's callback number in Rasphone.pbk.
  • /phonebook: PhonebookPath
    Specifies the path to the phonebook file. The default is systemroot\System32\Ras\UserName.pbk. You can specify a full path to the file.
  • /prefixsuffix
    Applies the current TAPI location dialing settings to the phone number. These settings are configured in Telephony, which is located in Control Panel. This option is turned off by default.
  • /disconnect
    Required when disconnecting. Disconnects the specified entry. You can also disconnect by typing /d.
Remarks
  • The following Rasphone.exe features are not supported with rasdial:

    • Entries that require Terminal mode user entry during the dial sequence

    • Operator-assisted or manual dialing

Examples

In the following example, this command connects to the OFFICE entry in Rasphone.pbk:

rasdial office

In the following example, this command connects to the OFFICE 2 entry in Rasphone.pbk and specify a callback number:

rasdial "office 2" /callback:555-0100

In the following example, this command disconnects from the EAST OFFICE entry:

rasdial "EAST OFFICE" /d

Formatting legend

Format Meaning

Italic

Information that the user must supply

Bold

Elements that the user must type exactly as shown

Ellipsis (...)

Parameter that can be repeated several times in a command line

Between brackets ([])

Optional items

Between braces ({}); choices separated by pipe (|). Example: {even|odd}

Set of choices from which the user must choose only one

Courier font

Code or program output

See Also

Concepts

Command-line reference A-Z
Command shell overview