Set-CsRgsAgentGroup
Tópico modificado em: 2012-03-23
Modifica o grupo de operadores de um Grupo de Resposta existente. 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
Set-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 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 agrupamento 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 New-CsRgsAgentGroup permite criar novos grupos de operadores. Se precisar fazer alterações em um grupo de operadores após ele ter sido criado, use o cmdlet Set-RgsAgentGroup; entre outras coisas, esse cmdlet pode ser usado para adicionar e remover operadores de um grupo. Observe que Set-CsRgsAgentGroup não modifica diretamente as propriedades de um grupo de operadores. Se precisar modificar um grupo, crie primeiramente uma referência de objeto para esse grupo; isso é feito ao se chamar Get-CsRgsAgentGroup, para recuperar o grupo e, em seguida, armazenar o objeto retornado em uma variável. Após a criação da referência de objeto, você fará as alterações nas propriedades do grupo na memória. Quando você tiver terminado de fazer as modificações, deverá então chamar Set-CsRgsAgentGroup, para gravar as alterações no grupo de operadores do Grupo de Resposta. Se você não chamar Set-CsRgsAgentGroup, as alterações existirão somente na memória e desaparecerão assim que você fechar o Windows PowerShell ou excluir a variável de referência de objeto.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-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 "Set-CsRgsAgentGroup"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Instance |
Obrigatório |
objeto AgentGroup |
Referência de objeto ao grupo de operadores do Grupo de Resposta a ser modificado. Uma referência de objeto é normalmente recuperada pelo uso do cmdlet Get-CsRgsAgentGroup e pela atribuição do valor retornado a uma variável. Por exemplo: esse comando retorna uma referência de objeto ao grupo de operadores da Help Desk e armazena esta referência de objeto em uma variável denominada $x: $x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" |
Force |
Opcional |
Parâmetro de opção |
Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando. |
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. Set-CsRgsAgentGroup aceita instâncias canalizadas do objeto de grupo de operadores do Grupo de Resposta.
Tipos de Retorno
Set-CsRgsAgentGroup não retorna qualquer objeto ou valor. Em vez disso, o cmdlet modifica instâncias existentes do objeto Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup.
Exemplo
-------------------------- Exemplo 1 ------------------------
$x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.RoutingMethod = "RoundRobin"
Set-CsRgsAgentGroup -Instance $x
Os comandos mostrados no Exemplo 1 modificam a propriedade RoutingMethod da Help Desk do grupo de operadores do Grupo de Resposta (localizada no serviço ApplicationServer:atl-cs-001.litwareinc.com). Para realizar essa tarefa, o comando usa inicialmente o cmdlet Get-CsRgsAgentGroup, para recuperar o grupo de operadores da Help Desk (-Name "Help Desk") de ApplicationServer:atl-cs-001.litwareinc.com. Após a recuperação, o objeto do grupo de operadores é armazenado em uma variável denominada $x.
O comando 2 no exemplo modifica o valor da propriedade RoutingMethod. No comando final do exemplo, o cmdlet Set-CsRgsAgentGroup é usado para gravar essas alterações no grupo de operadores da Help Desk.
-------------------------- Exemplo 2 ------------------------
$x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.DistributionGroupAddress = "helpdesk@litwareinc.com"
Set-CsRgsAgentGroup -Instance $x
O Exemplo 2 mostra como você pode modificar o grupo de distribuição atribuído a um grupo de operadores do Grupo de Resposta. Isso é feito usando-se inicialmente Get-CsRgsAgentGroup, para retornar o grupo de operadores a ser modificado; neste exemplo, este é o grupo da Help Desk (-Name "Help Desk"), localizado no serviço ApplicationServer:atl-cs-001.litwareinc.com. Depois que Get-CsRgsAgentGroup tiver retornado esse grupo, o objeto resultante será armazenado em uma variável denominada $x.
O segundo comando no exemplo atribui um novo valor (helpdesk@litwareinc.com) à propriedade DistributionGroupAddress. Após a atribuição do novo valor, utiliza-se Set-CsRgsAgentGroup, para gravar as alterações feitas ao grupo de operadores da Help Desk em ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Exemplo 3 ------------------------
$x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.AgentsByUri.Add("sip:kenmyer@litwareinc.com")
Set-CsRgsAgentGroup -Instance $x
Os comandos mostrados no Exemplo 3 adicionam um novo operador à Help Desk do grupo de operadores do Grupo de Resposta. Para fazer isso, o exemplo usa inicialmente Get-CsRgsAgentGroup, para retornar o grupo da Help Desk (-Name "Help Desk") do serviço ApplicationServer:atl-cs-001.litwareinc.com. O objeto recuperado é armazenado em uma variável denominada $x.
No segundo comando, o método Adicionar é usado para adicionar um novo operador à propriedade AgentsByUri; isso é feito ao se especificar o endereço SIP do novo operador ("sip:kenmyer@litwareinc.com"). No comando 3, utiliza-se Set-CsRgsAgentGroup para gravar as alterações (ou seja, a adição de um novo operador) no Grupo da Help Desk. Observe que, se você não chamar Set-CsRgsAgentGroup, as alterações serão feitas somente na memória e nunca serão aplicadas ao grupo de operadores real.
-------------------------- Exemplo 4 ------------------------
$x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.AgentsByUri.Remove("sip:kenmyer@litwareinc.com")
Set-CsRgsAgentGroup -Instance $x
No Exemplo 4, um operador é removido da Help Desk do grupo de operadores do Grupo de Resposta, localizada no serviço ApplicationServer:atl-cs-001.litwareinc.com. Para fazer isso, o exemplo usa inicialmente Get-CsRgsAgentGroup, para retornar o grupo da Help Desk (-Name "Help Desk") de ApplicationServer:atl-cs-001.litwareinc.com. O objeto do grupo de operadores recuperado é armazenado em uma variável denominada $x.
Após a recuperação do grupo de operadores, utiliza-se o método Remover para remover um operador (cujo endereço SIP for "sip:kenmyer@litwareinc.com") do grupo. No comando 3, chama-se então Set-CsRgsAgentGroup, para gravar as alterações (em outras palavras, para remover o operador) ao grupo. Se você não chamar Set-CsRgsAgentGroup, as alterações serão feitas somente na memória e não serão aplicadas ao grupo de operadores real; o operador será removido somente se você chamar Set-CsRgsAgentGroup.