Get-CsRgsQueue
Tópico modificado em: 2012-03-23
Recupera informações sobre as filas de espera do Grupo de Resposta em uso na organização. Graças ao Aplicativo Grupo de Resposta, as chamadas telefônicas são colocadas em uma fila de espera e os chamadores são colocados em espera até que um operador do Grupo de Resposta esteja disponível para atender à chamada.
Sintaxe
Get-CsRgsQueue [-Identity <RgsIdentity>] [-Name <String>]
Descrição Detalhada
Quando alguém chama um número de telefone associado ao Aplicativo Grupo de Resposta, uma de duas coisas normalmente acontece: a chamada será transferida para uma pergunta que o chamador deve responder para continuar (por exemplo: "Pressione 1 para suporte de hardware. Pressione 2 para suporte de software") ou a chamada será colocada em uma fila de espera até que um operador do Grupo de Resposta esteja disponível para atender à chamada.
Em vez de haver uma única fila de espera para todas as chamadas telefônicas, o Aplicativo Grupo de Resposta permite a criação de várias filas de espera, que podem ser associadas a diferentes fluxos de trabalho e diferentes grupos de operadores do Grupo de Resposta. Por sua vez, isso significa que as filas de espera podem responder de maneira diferente a eventos como um número designado de chamadas sendo mantidas simultaneamente na fila ou a chamadores que permaneceram em espera por um número especificado de segundos.
O cmdlet Get-CsRgsQueue fornece uma maneira de retornar as informações sobre as filas de espera do Grupo de Resposta configuradas para uso em sua organização.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Get-CsRgsQueue 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-CsRgsQueue"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
Identidade do Rgs |
Representa a Identidade do serviço no qual a fila de espera do Grupo de Resposta está hospedada ou a Identidade completa da própria fila. Se você especificar a Identidade do serviço (por exemplo, service:ApplicationServer:atl-cs-001.litwareinc.com), serão retornadas todas as filas de espera do Grupo de Resposta hospedadas nesse serviço. Se você especificar a Identidade da fila de espera, será retornada somente a fila de espera especificada do Grupo de Resposta. Observe que a Identidade de uma fila de espera 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 uma única fila de espera do Grupo de Resposta é especificar a Identidade do serviço e, em seguida, incluir o parâmetro Name seguido do nome da fila de espera. Isso permite que você recupere uma fila de espera específica do Grupo de Resposta, sem ter de conhecer o GUID atribuído àquela fila. Se for chamado sem nenhum parâmetro, Get-CsRgsQueue retornará todas as filas de espera do Grupo de Resposta configuradas para uso na organização. |
Name |
Opcional |
Cadeia de caracteres |
Nome exclusivo dado à fila de espera do Grupo de Resposta no momento em que foi criada. |
Tipos de Entrada
Cadeia de caracteres. Get-CsRgsQueue aceita um valor de cadeia de caracteres que representa a Identidade da fila de espera do Grupo de Resposta.
Tipos de Retorno
Get-CsRgsQueue retorna instâncias do objeto Microsoft.Rtc.Rgs.Management.WritableSettings.Queue.
Exemplo
-------------------------- Exemplo 1 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com
O comando anterior retorna informações sobre todas as filas de espera do Grupo de Resposta configuradas para uso na organização. Isto é feito chamando-se Get-CsRgsQueue, sem qualquer parâmetro.
-------------------------- Exemplo 2 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com
O comando mostrado no Exemplo 2 retorna informações sobre todas as filas de espera do Grupo de Resposta localizadas no serviço ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Exemplo 3 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
No Exemplo 3, retornam-se informações relativas a uma única fila de espera do Grupo de Resposta: a fila de espera denominada "Assistência Técnica", localizada no serviço ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Exemplo 4 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Select-Object -ExpandProperty TimeoutAction
O comando mostrado no Exemplo 4 exibe as informações detalhadas sobre a propriedade TimeoutAction para cada fila de espera do Grupo de Resposta localizada no serviço ApplicationServer:atl-cs-001.litwareinc.com. Para executar essa tarefa, o Get-CsRgsQueue é usado inicialmente para retornar as informações sobre todas as filas de espera localizadas em ApplicationServer:atl-cs-001.litwareinc.com. Estas informações são passadas para o cmdlet Select-Object, que expande o valor armazenado na propriedade TimeoutAction. Quando se expande o valor da propriedade TimeoutAction, exibe-se cada propriedade do objeto incorporado que compõe o valor da propriedade. Prompt; TargetQuestion; Target; TargetQueueID; e TargetUri.
-------------------------- Exemplo 5 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.OverflowCandidate -eq "NewestCall"}
O comando anterior retorna informações sobre todas as filas de espera do Grupo de Resposta em ApplicationServer:atl-cs-001.litwareinc.com cuja propriedade OverflowCandidate estiver definida como NewestCall. Para realizar essa tarefa, o comando usa inicialmente Get-CsRgsQueue, para retornar uma coleção de todas as filas de espera do Grupo de Resposta localizadas no serviço especificado. Esta coleção será então canalizada ao cmdlet Where-Object, que selecionará apenas as filas de espera cuja propriedade OverflowCandidate for igual a "NewestCall".