Get-CsRgsAgentGroup
Tópico modificado em: 2012-03-23
Retorna informações sobre os grupos de operadores do Grupo de Resposta configurados para uso em sua organização. Um grupo de operadores é um conjunto de operadores atribuídos a uma fila de espera do Grupo de Resposta. Os operadores são os usuários designados a atender chamadas direcionadas a uma fila de espera.
Sintaxe
Get-CsRgsAgentGroup [-Identity <RgsIdentity>] [-Name <String>]
Descrição Detalhada
Quando alguém chama um número de telefone associado ao Aplicativo Grupo de Resposta, o aplicativo determina inicialmente o fluxo de trabalho que corresponde ao número que foi chamado. Com base na configuração desse fluxo de trabalho, a chamada pode ser roteada para um conjunto de perguntas de resposta Interativa de voz (IVR) (no qual o chamador é solicitado a responder a uma pergunta do tipo: "Essa pergunta é sobre suporte de hardware ou suporte de software?"). Como alternativa, a chamada pode ser colocada em uma fila de espera do Grupo de Resposta; o chamador será colocado em espera até que uma pessoa designada esteja disponível para atender à chamada. As pessoas designadas para atender a chamadas são conhecidas como operadores e um conjunto de operadores é denominado grupo de operadores do Grupo de Resposta. Os grupos de operadores são associados a fluxos de trabalho e a responsabilidades de trabalho semelhantes: as equipes de Help Desk podem ser agrupadas no grupo de operadores de Help Desk, enquanto os operadores de atendimento ao cliente podem ser agrupados no grupo de operadores de Atendimento ao Cliente.
O cmdlet Get-CsRgsAgentGroup permite retornar informações sobre os grupos de operadores do Grupo de Resposta em uso na organização (inclusive informações sobre os usuários que tiverem sido atribuídos a cada grupo de operadores).
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsRgsAgentGroup 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-CsRgsAgentGroup"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
Identidade do Rgs |
Representa a Identidade do serviço na qual está hospedado o grupo de operadores do Grupo de Resposta ou a Identidade completa do próprio grupo de operadores. Se você especificar a Identidade do serviço (por exemplo, service:ApplicationServer:atl-cs-001.litwareinc.com), todos os grupos de operadores hospedados naquele serviço serão retornados. Se você especificar a Identidade do grupo, será retornado somente aquele grupo de operadores. Observe que a Identidade de um grupo de operadores consiste na Identidade do serviço, seguida de um identificador global exclusivo (GUID). Por exemplo: service:ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83. Uma maneira alternativa de retornar um único grupo consiste em especificar a Identidade do serviço e, em seguida, incluir o parâmetro Name, seguido do nome do grupo de operadores. Isso permite que você recupere um grupo de operadores específico, sem ter de conhecer o GUID atribuído àquele grupo. Se for chamado sem qualquer parâmetro, Get-CsRgsAgentGroup retornará um conjunto de todos os grupos de operadores configurados para uso na organização. |
Name |
Opcional |
Cadeia de caracteres |
Nome exclusivo dado ao grupo de operadores no momento em que o grupo foi criado. |
Tipos de Entrada
Cadeia de caracteres. Get-CsRgsAgentGroup aceita um valor de cadeia de caracteres que representa a Identidade do grupo de operadores do Grupo de Resposta.
Tipos de Retorno
Get-CsRgsAgentGroup retorna instâncias do objeto Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup.
Exemplo
-------------------------- Exemplo 1 ------------------------
Get-CsRgsAgentGroup
O Exemplo 1 retorna todos os grupos de operadores do Grupo de Resposta configurados para uso na organização. Isto é feito chamando-se Get-CsRgsAgentGroup sem qualquer parâmetro.
-------------------------- Exemplo 2 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com
O comando anterior retorna todos os grupos de operadores do Grupo de Resposta configurados para uso no serviço ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Exemplo 3 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
O comando mostrado no Exemplo 3 retorna um único grupo de operadores do Grupo de Resposta: o grupo denominado Help Desk, localizado no serviço ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Exemplo 4 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.RoutingMethod -eq "RoundRobin"}
No Exemplo 4, retornam-se as informações correspondentes a todos os grupos de operadores do Grupo de Resposta no serviço ApplicationServer:atl-cs-001.litwareinc.com, contanto que esses grupos usem o método de roteamento em rodízio. Para executar essa tarefa, o comando usa inicialmente Get-CsRgsAgentGroup, para retornar um conjunto de todos os grupos de operadores em ApplicationServer:atl-cs-001.litwareinc.com. Esta coleção será canalizada para o cmdlet Where-Object, que selecionará apenas os grupos cuja propriedade RoutingMethod for igual a "RoundRobin".
-------------------------- Exemplo 5 ------------------------
Get-CsRgsAgentGroup -Identity Service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.RoutingMethod -ne "RoundRobin"}
O comando usado no Exemplo 5 é uma variação do comando usado no Exemplo 3; nesse caso, entretanto, retornam-se as informações correspondentes a todos os grupos de operadores do Grupo de Resposta no serviço ApplicationServer:atl-cs-001.litwareinc.com que não utilizarem o método de roteamento em rodízio. Para fazer isso, o comando inicialmente chama Get-CsRgsAgentGroup, para retornar um conjunto de todos os grupos de operadores em ApplicationServer:atl-cs-001.litwareinc.com. Esta coleção será canalizada para o cmdlet Where-Object, que selecionará apenas os grupos de operadores cuja propriedade RoutingMethod não for igual a "RoundRobin".