Windows 7 / Networking

Initiating Remote Assistance from the Command Line

Remote Assistance in Windows 7 and Windows Vista is implemented as a stand-alone executable called Msra.exe. You can initiate Remote Assistance sessions directly from the command line or by using scripts. The syntax and usage for this command is explained in Table below.

Syntax and Usage for Command-Line Remote Assistance (Msra.exe)

/novice	Windows 7 Windows Vista	Starts Remote Assistance as Novice (User) in Solicited RA mode and presents the user with the choice of either sending a Remote Assistance ticket using a SMAPI-enabled e-mail application such as Windows Mail or by saving the invitation as a file. After this choice has been made, Windows Remote Assistance opens on the User's computer in the Waiting For Connect state.
/expert	Windows 7 Windows Vista	Starts Remote Assistance in the Helper mode and presents the choice of either specifying the location of a Remote Assistance ticket to open or specifying the User's computer name or address (Offer RA). The computer name can be either a host name (if the User is on the local subnet) or an FQDN (DNS name), and the address can be either an IPv4 address or an IPv6 address. Unsolicited Remote Assistance without an invitation requires preconfiguration of the remote computer being helped.
/offerRA computer	Windows 7 Windows Vista	Starts Remote Assistance as Helper in Unsolicited (Offer) RA mode and uses DCOM to remotely open Remote Assistance on the User's computer and then connect to the User's computer to initiate a Remote Assistance session. The User's computer can be specified using either its computer name or address. The computer name can be either a host name (if the User is on the local subnet) or a FQDN (DNS name), and the address can be either an IPv4 address or an IPv6 address.
/email password	Windows 7 Windows Vista	Starts Remote Assistance as Novice (User) in Solicited RA mode and creates a passwordprotected RA ticket that is attached to a new Remote Assistance invitation message opened by the default SMAPI-enabled e-mail client (which by default is Windows Mail). The password must be six characters or more and must be relayed separately to the Helper. The e-mail client application launches a window with the invitation file attached. The User must enter the e-mail address of the Helper in the To field to send the message to the Helper.
/saveasfile path password	Windows 7 Windows Vista	Starts Remote Assistance as Novice (User) in Solicited RA mode and creates a passwordprotected Remote Assistance ticket that is saved at the path specified. The path can be either a local folder or network share, and the User must have appropriate permissions on the destination folder to create the file. The path must include a file name for the ticket. (The .MsRcIncident file extension will be automatically added to the file name.) The password must be six characters or more.
/openfile path password	Windows 7 Windows Vista	Starts Remote Assistance as Expert (Helper) in Solicited RA mode and opens a previously created Remote Assistance ticket that was saved within the path specified. The path may be either a local folder or network share, and the Helper must have appropriate permissions on the destination folder to open the file. The path must include the file name of a valid ticket that has the .MsRcIncident file extension. The password must be the same password that was used by the User to secure the ticket when it was created.
/geteasyhelp	Windows 7 only	Starts Remote Assistance as Novice (User) in Solicited RA mode and with the Easy Connect option already selected. After the Remote Assistance invitation has been posted to the PNRP cloud, the User is presented with a 12-character password that she must communicate OOB to the Expert (Helper), which the Helper can then use to accept the invitation and initiate the Remote Assistance session.
/offereasyhelp address	Windows 7 only	Starts Remote Assistance as Expert (Helper) in Offer RA mode and with the Easy Connect option already selected. The Helper is presented with a dialog box for entering the 12-character password that was communicated OOB to him by the Novice (User), which is needed by the Helper to accept the invitation and initiate the Remote Assistance session.
/getcontacthelp address	Windows 7 only	Starts Remote Assistance as Novice (User) in Solicited RA mode with the Easy Connect option already selected and with the Remote Assistance history contact specified by address already selected. You can find address for a contact in your Remote Assistance history by opening the RAContacthistory.xml file located in the \Users\Username\Appdata\Local folder on your computer. The format for address is a 40-character hexadecimal string with .RAContact appended to it.
/offercontacthelp address	Windows 7 only	Starts Remote Assistance as Expert (Helper) in Offer RA mode with the Easy Connect option already selected and with the Remote Assistance history contact specified by address already selected. You can find address for a contact in your Remote Assistance history by opening the RAContacthistory.xml file located in the \Users\Username\Appdata\Local folder on your computer. The format for address is a 40-character hexadecimal string with .RAContact appended to it.

Note There is no support for Windows Management Instrumentation (WMI) scripting of Msra.exe.

[Previous] [Contents] [Next]

Initiating Remote Assistance from the Command Line

Syntax and Usage for Command-Line Remote Assistance (Msra.exe)

In this tutorial: