Get-CsRgsConfiguration
Returns information about configuration settings for the Response Group application. This cmdlet was introduced in Lync Server 2010.
Syntax
Get-CsRgsConfiguration
[-Identity] <RgsIdentity>
[<CommonParameters>] Description
The Response Group application provides a way for you to automatically route phone calls to entities such as a help desk or customer support line. When someone calls a designated phone number, that call can be directly routed to the appropriate set of Response Group agents. Alternatively, the call might first be routed to an interactive voice response (IVR) queue. In that queue, the caller will be asked a series of questions (for example, "Are you calling about an existing order?") and then, based on the answers to those questions, be routed to the appropriate Response Group queue.
The Get-CsRgsConfiguration cmdlet provides a way for you to return information about how the Response Group application has been configured. Note that, by default, this cmdlet only returns information from one instance of the Response Group application at a time. For example, if you have separate installations of the Response Group application -- one on ApplicationServer:atl-cs-001.litwareinc.com and one on ApplicationServer:dublin-cs-001.litwareinc.com -- you will typically need to make separate calls to Get-CsRgsConfiguration in order to return information for each of these Response Group instances. However, the Examples section in this topic shows a way to work around this issue.
Examples
-------------------------- Example 1 --------------------------
Get-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com"Example 1 returns the Response Group configuration settings for the service ApplicationServer:atl-cs-001.litwareinc.com. Because there can only be one collection of settings per service, this command will never return more than a single item.
-------------------------- Example 2 --------------------------
(Get-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com").DisableCallContextThe command shown in Example 2 returns the value of a single property -- DisableCallContext -- for the Response Group configuration settings found on the service ApplicationServer:atl-cs-001.litwareinc.com. To accomplish this task, Get-CsRgsConfiguration is first used to retrieve all the property values for the Response Group configuration settings for ApplicationServer:atl-cs-001.litwareinc.com. Note that this command is enclosed in parentheses; that ensures that Windows PowerShell returns all the property values before doing anything else.
After all the property values have been returned, standard "dot notation" is used to display the value of the property DisableCallContext (and only the value of that property). Standard dot notation consists of the object followed by a period (dot) followed by the name of the property to be displayed. For example, to display the value of the AgentRingbackGracePeriod property (and only the value of that property), you can use this command:
(Get-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com").AgentRingbackGracePeriod
-------------------------- Example 3 --------------------------
Get-CsService -ApplicationServer | Where-Object {$_.Applications -contains "urn:application:RGS"} | ForEach-Object {Get-CsRgsConfiguration -Identity $_.Identity}The command shown in Example 3 demonstrates how you can return Response Group configuration information from all the computers running the Application service that host an instance of the Response Group application. To do this, the command first uses the Get-CsService cmdlet and the ApplicationServer parameter to return information about all the servers in the organization that are running the Application service. This collection is then piped to the Where-Object cmdlet, which picks out only those servers where the Applications property contains the application "urn:application:RGS"; that value indicates that the Response Group application is running on the server.
In turn, those servers are piped to the ForEach-Object cmdlet. ForEach-Object then takes each server in the collection and uses Get-CsRgsConfiguration to return Response Group configuration information from each server.
Parameters
-Identity
Name of the service hosting the Response Group configuration settings; for example: -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com". If you do not include this parameter, Get-CsRgsConfiguration will prompt you to supply an Identity.
| Type: | RgsIdentity |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
Inputs
String
A string value representing the Identity of the Response Group configuration settings.
Outputs
Microsoft.Rtc.Rgs.Management.WritableSettings.ServiceSettings