Set-CsRgsQueue
Tópico modificado em: 2012-03-23
Modifica a fila de espera de um Grupo de Resposta existente. 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
Set-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: ou a chamada é 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 é colocada em uma fila de espera até que um operador esteja disponível para atender a 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 designado de segundos.
O cmdlet Set-CsRgsQueue permite modificar uma fila de espera existente do Grupo de Resposta. Set-CsRgsQueue não permite que se modifique diretamente a fila de espera. Por exemplo, o cmdlet não inclui parâmetros para alterar o limite de excedente ou a ação excedente. Se você precisar modificar uma fila de espera, terá primeiro de criar uma referência de objeto à fila, usando Get-CsRgsQueue, para recuperar a fila de espera de interesse e, em seguida, armazenando-a em uma variável. São feitas modificações à fila de espera na memória, atribuindo-se novos valores às propriedades da fila. Depois que todas as alterações tiverem sido feitas, chama-se Set-CsRgsQueue, para gravar essas alterações de volta à fila de espera do Grupo de Resposta. Se você não chamar Set-CsRgsQueue, as alterações serão feitas 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-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 "Set-CsRgsQueue"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Instance |
Obrigatório |
objeto Queue |
Referência de objeto à fila de espera do Grupo de Resposta a ser modificada. Uma referência de objeto é normalmente recuperada pelo uso do cmdlet Get-CsRgsQueue e pela atribuição do valor retornado a uma variável. Por exemplo: esse comando retorna uma referência de objeto à fila de espera da Help Desk e armazena esta referência de objeto em uma variável denominada $x: $x = Get-CsRgsQueue -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.Queue. Set-CsRgsQueue aceita instâncias canalizadas do objeto de fila de espera do Grupo de Resposta.
Tipos de Retorno
Set-CsRgsQueue não retorna qualquer objeto ou valor. Em vez disso, o cmdlet modifica instâncias existentes do objeto Microsoft.Rtc.Rgs.Management.WritableSettings.Queue.
Exemplo
-------------------------- Exemplo 1 ------------------------
$x = Get-CsRgsQueue -Identity Service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.OverflowCandidate = "NewestCall"
Set-CsRgsQueue -Instance $x
No Exemplo 1, modifica-se a propriedade OverflowCandidate da fila de espera do Grupo de Resposta Help Desk, encontrada no serviço ApplicationServer:atl-cs-001.litwareinc.com. Para fazer isso, o primeiro comando no exemplo usa Get-CsRgsQueue, para recuperar a fila de espera especificada (-Name "Help Desk") de ApplicationServer:atl-cs-001.litwareinc.com. A fila de espera recuperada é então armazenada em uma variável denominada $x.
Após a recuperação da fila de espera, o segundo comando no exemplo define o valor da propriedade OverflowCandidate dessa fila de espera virtual como sendo NewestCall. Assim que esse comando for concluído, o comando final no exemplo usa Set-CsRgsQueue, para gravar essas alterações à fila de espera real da Help Desk. Observe que, até esse ponto, as alterações ocorreram somente na memória. Até que se chame Set-CsRgsQueue, a fila de espera real do Grupo de Resposta em ApplicationServer:atl-cs-001.litwareinc.com permanecerá inalterada.
-------------------------- Exemplo 2 ------------------------
$x = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Overflow Queue"
$w = New-CsRgsPrompt -TextToSpeechPrompt "Please hold while we transfer your call."
$y = New-CsRgsCallAction -Prompt $w -Action TransferToQueue -QueueID $x.Identity
$z = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$z.OverflowAction = $y
Set-CsRgsQueue -Instance $z
Os comandos mostrados no Exemplo 2 demonstram como se pode criar uma nova ação de chamada do Grupo de Resposta e atribuir esta ação a uma fila de espera existente do Grupo de Resposta. Para executar essa tarefa, a primeira etapa consiste em usar Get-CsRgsQueue para recuperar a Fila de Espera Excedente da Help Desk da fila de espera do Grupo de Resposta em ApplicationServer:atl-cs-001.litwareinc.com. As informações sobre essa fila de espera serão armazenadas em uma variável denominada $x.
Depois que uma fila de espera for recuperada, o cmdlet New-CsRgsPrompt é usado para criar um novo prompt de texto em fala, que é armazenado em uma variável denominada $w. Depois disso, o cmdlet New-CsRgsCallAction é usado para criar uma nova ação de chamada. Três parâmetros são atribuídos a essa ação de chamada: Prompt (o prompt a ser usado pela ação de chamada), Action (indica o que acontecerá se a nova ação de chamada for acionada. O valor de parâmetro TransferToQueue significa que a chamada será transferida a uma outra fila de espera do Grupo de Resposta) e QueueID, a fila de espera alternativa para a qual a chamada será transferida ($x.Identity, que representa a Identidade da fila de espera Fila de Espera Excedente da Help Desk). Essa nova ação de chamada é criada na memória e, em seguida, armazenada em uma variável denominada $y.
O comando seguinte recupera a fila de espera a ser modificada; neste exemplo, é a fila de espera da Help Desk em ApplicationServer:atl-cs-001.litwareinc.com. Depois que Get-CsRgsQueue tiver recuperado essa fila de espera, o objeto da fila de espera será armazenado em uma variável denominada $z.
Quando tudo isso for concluído, você poderá atribuir a nova ação de chamada à Fila de Espera da Help Desk; isso é feito definindo-se o valor da propriedade OverflowAction como $y, a variável que contém a ação de chamada recém-criada.
Depois que a ação de chamada tiver sido atribuída, o comando final no exemplo chamará Set-CsRgsQueue para gravar, em ApplicationServer:atl-cs-001.litwareinc.com, as alterações à instância real da Fila de Espera da Help Desk.