Remove-CsRgsQueue
Tópico modificado em: 2012-03-23
Exclui uma fila de espera existente em um Grupo de Resposta. 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
Remove-CsRgsQueue -Instance <Queue> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
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 de espera, ou a chamadores que permaneceram em espera por um período de tempo especificado.
Além de criar novas filas de espera, você pode também remover as filas existentes. É para isso que serve o cmdlet Remove-CsRgsQueue. Observe que, por padrão, você receberá uma solicitação se tentar remover uma fila de espera que estiver atribuída a um fluxo de trabalho ativo; essa solicitação pedirá que você verifique se deseja excluir a fila. O Windows PowerShell será interrompido (e nenhuma fila de espera será excluída), até que você responda à solicitação. Para ignorar essa solicitação e excluir as filas de espera que estiverem sendo utilizadas por um fluxo de trabalho ativo, adicione o parâmetro Force. Por exemplo:
Get-CsRgsQueue –Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Remove-CsRgsQueue –Force
Remove-CsRgsQueue sempre verifica se a fila de espera está sendo usada por um fluxo de trabalho ativo, antes de excluí-la. No entanto, o cmdlet não verifica se a fila está sendo usada por outra fila, como fila de espera de tempo limite ou excedente. Isso significa que é possível excluir uma fila que é requisitada por outra fila. Por isso, utilize o cmdlet Get-CsRgsQueue para verificar as propriedades OverflowAction e TimeoutAction das filas dos outros Grupo de Resposta antes de executar o cmdlet Remove-CsRgsQueue para excluir uma fila.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Remove-CsRgsQueue localmente: RTCUniversalServerAdmins. 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 "Remove-CsRgsQueue"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Instance |
Obrigatório |
Objeto Queue |
Referência de objeto que aponta para a fila a ser removida. Ao canalizar objetos de fluxo de trabalho para Remove-CsRgsQueue, é possível omitir o parâmetro Instance. Para usar o parâmetro Instance, use comandos semelhantes a este: $x = Get-CsRgsQueue –Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83 Remove-CsRgsQueue –Instance $x Observe que se pode remover apenas uma fila de cada vez quando se usa o parâmetro Instance. Isso significa que a referência de objeto ($x) não pode conter diversos objetos de filas. |
Force |
Opcional |
Parâmetro de opção |
Força a exclusão de uma fila de espera do Grupo de Resposta. Se esse parâmetro estiver presente, a fila de espera será excluída sem aviso, mesmo se estiver atribuída a um fluxo de trabalho ativo. Se esse parâmetro não estiver presente, você será solicitado a confirmar a exclusão de qualquer fila de espera em uso por um fluxo de trabalho ativo. |
WhatIf |
Opcional |
Parâmetro de opção |
Descreve o que aconteceria se o comando fosse executado sem ser executado de fato. |
Confirm |
Opcional |
Parâmetro de opção |
Solicita confirmação antes da execução do comando. |
Tipos de Entrada
Objeto Microsoft.Rtc.Rgs.Management.WritableSettings.Queue. Remove-CsRgsQueue aceita instâncias canalizadas do objeto fila de espera do Grupo de Resposta.
Tipos de Retorno
Remove-CsRgsQueue exclui instâncias existentes do objeto Microsoft.Rtc.Rgs.Management.WritableSettings.Queue.
Exemplo
-------------------------- Exemplo 1 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Remove-CsRgsQueue
O comando mostrado no Exemplo 1 exclui todas as filas de espera do Grupo de Resposta localizadas no serviço ApplicationServer:atl-cs-001.litwareinc.com. Para isso, o comando primeiramente utiliza Get-CsRgsQueue para retornar um conjunto de todas as filas de espera localizadas em ApplicationServer:atl-cs-001.litwareinc.com. Esse conjunto será então canalizado para Remove-CsRgsQueue, que excluirá cada fila de espera no conjunto.
-------------------------- Exemplo 2 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Queue" | Remove-CsRgsQueue
No Exemplo 2, exclui-se uma única fila de espera do Grupo de Resposta: a fila de espera denominada "Fila Assistência Técnica", localizada no serviço ApplicationServer:atl-cs-001.litwareinc.com. Para excluir essa fila de espera, chama-se Get-CsRgsQueue, juntamente com os parâmetros Identity e Name. A única fila retornada por essa chamada será então canalizada para Remove-CsRgsQueue, que a excluirá.
-------------------------- Exemplo 3 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.OverflowCandidate -eq "NewestCall"} | Remove-CsRgsQueue
O comando anterior exclui todas as filas de espera do Grupo de Resposta localizadas no serviço ApplicationServer:atl-cs-001.litwareinc.com, contanto que a propriedade OverflowCandidate dessas filas esteja definida como NewestCall. Para isso, chama-se inicialmente Get-CsRgsQueue, para retornar uma coleção de todas as filas de espera do Grupo de Resposta localizadas em ApplicationServer:atl-cs-001.litwareinc.com. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará apenas as filas de espera cuja propriedade OverflowCandidate for igual a "NewestCall". Essa coleção filtrada será então canalizada para Remove-CsRgsQueue, que excluirá cada item na coleção.