Article ID: 201793 - View products that this article applies to.
This article was previously published under Q201793
You can use the Remote.exe command-line tool to start a Remote Control session with a Microsoft Systems Management Server (SMS) client. All the Remote Tools functions that are available by using the user interface are also available from the command line when you run Remote.exe to establish a Remote Tools connection. This is useful when you develop programs that require the functionality in SMS Remote Tools.
By default, Remote.exe is located in the %SystemRoot%\SMS\Bin\I386 folder on a primary or secondary site installation. On a computer where only the SMS Administrator console is installed, Remote.exe is located in the %SystemRoot%\SMSADMIN\Bin\I386 folder.
Use Remote.exe with the following syntax:
remote address_type address \\site_server_name\The address_type parameter can have the following values:
Note You can also access syntax information by typing remote.exe /? at a command prompt.
The following are two examples of the correct command-line syntax:
remote 2 172.16.0.0 \\big_server\Note In SMS 2003, the IPX and the NetBIOS address types apply only when you want to connect to SMS 2.0 clients. SMS 2003 clients use only TCP/IP connections.
remote 3 dubn_netbios \\big_server\
When you use Remote.exe, the resource that you specify is always resolved to a resource ID in the SMS database. SMS object security is scanned to determine if the user has the permissions to remotely control the resource. The available remote control features depend on SMS resolving the computer address that you supply, instead of on how security controls are applied.
To establish a Remote Tools connection, you must have the Use Remote Tools permission and the Read permission for the collection that contains the client. If you are not a local administrator, your domain account must also be included in the Permitted Viewers list. To add your account to the Permitted Viewers list in SMS 2003 and SMS 2.0, follow these steps:
315755SMS 2003 does not retrieve the IP address from the SMS database. SMS 2003 instead uses either the IP address that you supply or resolves the computer name to an IP address by using WINS name resolution requests.
(http://support.microsoft.com/kb/315755/ )Remote Tools may connect to the wrong Systems Management Server client
You can connect to a client by using its resource ID. To do this, use the following command syntax, where site_server is the NetBIOS name of your site server:
remote 0 <Resource_ID> \\site server\The following is an example of the correct command-line syntax:
remote 0 2 \\big_server\When you use a resource ID, Remote.exe tries to connect by using all the available protocols for the destination client. To determine the resource ID of a client, follow these steps:
http://www.microsoft.com/downloads/details.aspx?FamilyID=58833cd1-6dbb-45bb-bb77-163446068ef6&DisplayLang=enIf you use Remote.exe without any command-line options, the Remote Tools Address Connection dialog box appears. Click the address type that you want to use, and then type the address.
After you configure the parameters, click OK to connect to the client. A connection to the client is established if all the following conditions are true:
For more information about Remote Tools security, see one of the following documents:
Article ID: 201793 - Last Review: February 27, 2007 - Revision: 5.2