Remove-CsRgsAgentGroup
Tópico modificado em: 2012-05-21
Remove um grupo de operadores existente no Grupo de Resposta. 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 determinada fila de espera.
Sintaxe
Remove-CsRgsAgentGroup -Instance <AgentGroup> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Quando alguém chama um número de telefone associado ao Aplicativo Grupo de Resposta, o serviço determina inicialmente qual fluxo de trabalho 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 permanecerá em espera até que alguém esteja disponível para atender à chamada. As pessoas designadas para atender a chamadas são conhecidas como operadores e um agrupamento de operadores é denominado grupo de operadores do Grupo de Resposta. Os grupos de operadores são associados a fluxos de trabalho e são também associados a responsabilidades de trabalho semelhantes; por exemplo, a equipe da assistência técnica pode ser agrupada no grupo de operadores Help Desk, enquanto os operadores de atendimento ao cliente podem ser agrupados no grupo de operadores Customer Support.
O cmdlet New-CsRgsAgentGroup permite criar novos grupos de operadores. Se você precisar excluir um grupo de operadores, chame o cmdlet Remove-CsRgsAgentGroup. Observe que esse cmdlet exclui todo o grupo e todos os operadores nesse grupo. Se desejar remover somente um único operador de um grupo, use o cmdlet Set-CsRgsAgentGroup.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-CsRgsAgentGroup 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-CsRgsAgentGroup"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Instance |
Obrigatório |
Objeto AgentGroup |
Referência de objeto que aponta para o grupo de agente a ser removido. Ao canalizar objetos de fluxo de trabalho para Remove-CsRgsAgentGroup, é possível omitir o parâmetro Instance. Para usar o parâmetro Instance, use comandos semelhantes a este: $x = Get-CsRgsAgentGroup –Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83 Remove-CsRgsAgentGroup –Instance $x Observe que se pode remover apenas um grupo de agente 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 grupos de agentes. |
Force |
Opcional |
Parâmetro de opção |
Força a remoção do grupo de operadores. Se esse parâmetro estiver presente, o grupo de operadores será excluído sem aviso, mesmo se for usado por um fluxo de trabalho ativo. Se esse parâmetro não estiver presente, você será solicitado a confirmar a exclusão de qualquer grupo de operadores usado 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.AgentGroup. Remove-CsRgsAgentGroup aceita instâncias canalizadas do objeto de grupo de operadores do Grupo de Resposta.
Tipos de Retorno
Remove-CsRgsAgentGroup exclui instâncias existentes do objeto Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup.
Exemplo
-------------------------- Exemplo 1 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Remove-CsRgsAgentGroup
O comando anterior exclui todos os grupos de operadores do Grupo de Resposta que tiverem sido configurados para uso no serviço ApplicationServer:atl-cs-001.litwareinc.com. Para fazer isso, o comando usa inicialmente Get-CsRgsAgentGroup para retornar todos os grupos de operadores de ApplicationServer:atl-cs-001.litwareinc.com. Esses grupos serão então canalizados para o cmdlet Remove-CsRgsAgentGroup, que os removerá.
-------------------------- Exemplo 2 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" | Remove-CsRgsAgentGroup
No Exemplo 2, é removido um único grupo de operadores do Grupo de Resposta: o grupo denominado Assistência Técnica. Para isso, Get-CsRgsAgentGroup é usado inicialmente para retornar o grupo de operadores da Assistência Técnica (-Name "Assistência Técnica") de ApplicationServer:atl-cs-001.litwareinc.com. Esse grupo será então canalizado para Remove-CsRgsAgentGroup, que removerá o grupo do serviço.
-------------------------- Exemplo 3 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.RoutingMethod -ne "RoundRobin"} | Remove-CsRgsAgentGroup
O Exemplo 3 exclui todos os grupos de operadores do Grupo de Resposta em ApplicationServer:atl-cs-001.litwareinc.com que não utilizarem o método de roteamento em rodízio. Para fazer isso, o Get-CsRgsAgentGroup é inicialmente chamado para retornar uma coleção de todos os grupos de operadores localizados no serviço ApplicationServer:atl-cs-001.litwareinc.com. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará apenas os grupos cuja propriedade RoutingMethod não for igual a (-ne) RoundRobin. A coleção filtrada será então canalizada para Remove-CsRgsAgentGroup, que excluirá todos os itens da coleção.