RGSCOT.exe Command-line Options

Topic Last Modified: 2009-03-06

You can use the RGSCOT.exe command-line utility to create and manage Response Group Service Contact objects. Contact objects are Active Directory objects. The Contact object is stored in the container created by Office Communications Server. Each Response Group, or workflow, is associated with a Contact object.

The RGSCOT.exe command-line utility is installed with the Office Communications Server 2007 R2 administrative tools. By default, it is installed in the following location %ProgramFiles%\Common Files\Microsoft Office Communications Server 2007 R2. You must be a member of the RTCUniversalServerAdmins group to run the RGSCOT.exe command-line utility.


RGSCOT /command [/PrimaryURI:<SIP URI of Contact object>] [/DisplayName:<display name>] 
[/PoolFQDN:<FQDN of pool>] [/DisplayNumber:<display number>] [/EnabledForFederation:<True|False>] 
[/LineUri:tel:<actual telephone number>] 


You must specify one of the following commands.

Command Description


Creates a new Contact object. This command requires the /PrimaryUri, /DisplayName, and /PoolFQDN command-line options.


Edits an existing Contact object. This command requires the /PrimaryUri command-line option.


Deletes an existing Contact object. This command requires the /PrimaryUri command-line option.


Displays command-line syntax and options for the tool.

Command-line Options

The following are additional command-line options that you can specify.

Command-line Option Description


Specifies the Session Initiation Protocol (SIP) Uniform Resource Identifier (URI) of the Contact object. After the Contact object is associated with a workflow, this is the URI address that is used to reach that workflow. The URI address cannot be modified.


Specifies the name as it is displayed in the client (for example, Office Communicator).

If the display name has a space, enclose the name in quotation marks (for example, /DisplayName:“Help Desk”).


Specifies the fully qualified domain name (FQDN) of the pool where the Response Group Service is installed.


Specifies whether the Contact object is enabled for federation. Set the option to True if you want to allow federated users to call the Response Group. The default is False.

Agents who are serving a federation-enabled workflow must also be enabled for federation. Otherwise, callers can call the Response Group, but agents cannot connect to the caller.


Specifies the telephone number that is associated with the Contact object.


Specifies the telephone number as it is displayed in the client.

If the display number has a space, enclose the number in quotation mark (for example, /DisplayNumber:“+1 (425) 555-0100”.


The following command creates a new Contact object.

RGSCOT /Create /PrimaryUri:sip:ask.mktg@contoso.com /PoolFQDN:serverA.contoso.com /LineUri:tel:+14255550156

The following command modifies a Contact object to set the display name and enable federation support.

RGSCOT /Edit /PrimaryUri:sip:ask.mktg@contoso.com /DisplayName:“Marketing Questions” /EnabledForFederation:true

The following command deletes a Contact object.

RGSCOT /Delete /PrimaryUri:sip:ask.mktg@contoso.com