Get-CsRgsConfiguration
Tópico modificado em: 2012-03-23
Retorna informações sobre as definições de configuração do Aplicativo Grupo de Resposta.
Sintaxe
Get-CsRgsConfiguration -Identity <RgsIdentity>
Descrição Detalhada
O Aplicativo Grupo de Resposta permite rotear automaticamente chamadas telefônicas para entidades, como uma linha de assistência técnica ou atendimento ao cliente. Quando alguém chama um número de telefone designado, a chamada pode ser diretamente roteada para o conjunto apropriado de operadores do Grupo de Resposta. Como alternativa, a chamada pode ser primeiramente roteada para uma fila de espera de resposta interativa de voz (IVR). Nessa fila de espera, uma série de perguntas seriam feitas ao chamador (por exemplo: "Você está telefonando a respeito de um pedido existente?") e então, com base nas respostas às perguntas, ele seria encaminhado à fila de espera apropriada do Grupo de Resposta.
O cmdlet Get-CsRgsConfiguration permite retornar informações sobre como o Aplicativo Grupo de Resposta foi configurado. Observe que, por padrão, este cmdlet só retorna informações de uma instância do Aplicativo Grupo de Resposta por vez. Por exemplo: se houver instalações separadas do Aplicativo Grupo de Resposta (uma em ApplicationServer:atl-cs-001.litwareinc.com e a outra em ApplicationServer:dublin-cs-001.litwareinc.com), normalmente será necessário fazer chamadas independentes a Get-CsRgsConfiguration, para retornar informações sobre cada uma dessas instâncias do Grupo de Resposta. No entanto, a seção de Exemplos deste tópico mostra uma forma de solucionar este problema.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Get-CsRgsConfiguration localmente: RTCUniversalServerAdmins e RTCUniversalReadOnlyAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsRgsConfiguration"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
Identidade do Rgs |
Nome do serviço que hospeda as definições de configuração do Grupo de Resposta; por exemplo: -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com". Se esse parâmetro não for incluído, o cmdlet Get-CsRgsConfiguration solicitará uma Identidade. |
Tipos de Entrada
Cadeia de caracteres. Get-CsRgsConfiguration aceita um valor de cadeia de caracteres que represente a Identidade das definições de configuração do Grupo de Resposta.
Tipos de Retorno
O cmdlet Get-CsRgsConfiguration retorna instâncias do objeto Microsoft.Rtc.Rgs.Management.WritableSettings.ServiceSettings.
Exemplo
-------------------------- Exemplo 1 ------------------------
Get-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com"
O Exemplo 1 retorna as definições de configuração do Grupo de Resposta correspondentes ao serviço ApplicationServer:atl-cs-001.litwareinc.com. Como só pode haver uma coleção de definições por serviço, esse comando nunca retornará mais do que um único item.
-------------------------- Exemplo 2 ------------------------
(Get-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com").DisableCallContext
O comando anterior retorna o valor de uma única propriedade (DisableCallContext) correspondentes às definições de configuração do Grupo de Resposta localizadas no serviço ApplicationServer:atl-cs-001.litwareinc.com. Para executar esta tarefa, utiliza-se primeiramente Get-CsRgsConfiguration, para retornar todos os valores de propriedade das definições de configuração do Grupo de Resposta correspondentes a ApplicationServer:atl-cs-001.litwareinc.com. Observe que esse comando é delimitado por parênteses, garantindo que o Windows PowerShell retorne todos os valores de propriedade antes de executar qualquer outro procedimento.
Depois do retorno de todos os valores de propriedade, utiliza-se a "notação de ponto" padrão, para exibir o valor da propriedade DisableCallContext (e somente o valor dessa propriedade). A notação de ponto padrão consiste no objeto, seguido de um ponto e do nome da propriedade a ser exibida. Por exemplo: para exibir o valor da propriedade AgentRingbackGracePeriod (e somente o valor dessa propriedade), utilize o seguinte comando:
(Get-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com").AgentRingbackGracePeriod.
-------------------------- Exemplo 3 ------------------------
Get-CsService -ApplicationServer | Where-Object {$_.Applications -contains "urn:application:RGS"} | ForEach-Object {Get-CsRgsConfiguration -Identity $_.Identity}
O comando mostrado no Exemplo 3 mostra como é possível retornar informações de configuração do Grupo de Resposta de todos os computadores que estiverem executando o Serviço de aplicativos que hospeda uma instância do aplicativo Grupo de Resposta. Para isso, o comando usa primeiramente o cmdlet Get-CsService e o parâmetro ApplicationServer, para retornar informações sobre todos os servidores na organização que estiverem executando o Serviço de aplicativos. A coleção retornada será então canalizada para o cmdlet Where-Object, que escolherá apenas os servidores cuja propriedade Applications contiver o aplicativo "urn:application:RGS"; este valor indica que o Aplicativo Grupo de Resposta está sendo executado no servidor.
Por sua vez, estes servidores serão canalizados para o cmdlet ForEach-Object. ForEach-Object tratará todos os servidores da coleção e utilizará Get-CsRgsConfiguration para retornar informações de configuração do Grupo de Resposta de cada servidor.