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 RTCUniversalServerAdminsgroup to run the RGSCOT.exe command-line utility.

Syntax

Copy Code
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 /PoolFQDNcommand-line options.

Edit

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

Delete

Deletes an existing Contact object. This command requires the /PrimaryUricommand-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.

Copy Code
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.

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

The following command deletes a Contact object.

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