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.

Syntax

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>] 

Commands

You must specify one of the following commands.

Command	Description
Create	Creates a new Contact object. This command requires the /PrimaryUri, /DisplayName, and /PoolFQDN command-line options.
Edit	Edits an existing Contact object. This command requires the /PrimaryUri command-line option.
Delete	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
PrimaryUri	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.
DisplayName	Specifies the name as it is displayed in the client (for example, Office Communicator). Note: If the display name has a space, enclose the name in quotation marks (for example, /DisplayName:“Help Desk”).
PoolFQDN	Specifies the fully qualified domain name (FQDN) of the pool where the Response Group Service is installed.
EnabledForFederation	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. Note: 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.
LineUri:tel	Specifies the telephone number that is associated with the Contact object.
DisplayNumber	Specifies the telephone number as it is displayed in the client. Note: If the display number has a space, enclose the number in quotation mark (for example, /DisplayNumber:“+1 (425) 555-0100”.

Examples

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