New-CsRgsQueue
Tópico modificado em: 2012-03-23
Cria uma nova fila de espera do 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
New-CsRgsQueue -Parent <RgsIdentity> -Name <String> [-AgentGroupIDList <Collection>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-OverflowAction <CallAction>] [-OverflowCandidate <NewestCall | OldestCall>] [-OverflowThreshold <Nullable>] [-TimeoutAction <CallAction>] [-TimeoutThreshold <Nullable>] [-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 grupo 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.
O cmdlet New-CsRgsQueue permite aos administradores criar com facilidade novas filas de espera do Grupo de Resposta.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-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 "New-CsRgsQueue"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Parent |
Obrigatório |
Identidade do Rgs |
Serviço no qual será hospedada a nova fila de espera. Por exemplo: -Parent "service:ApplicationServer:atl-cs-001.litwareinc.com". |
Name |
Obrigatório |
Cadeia de caracteres |
Nome exclusivo a ser atribuído à fila de espera. A combinação entre as propriedades Parent e Name permite identificar de forma exclusiva as filas de espera do Grupo de Resposta, sem a necessidade de consultar o identificador global exclusivo (GUID) da fila de espera. |
AgentGroupIdList |
Opcional |
coleção AgentGroup |
Identidade dos grupos de operadores do Grupo de Resposta a serem adicionados à fila de espera. As Identidades dos grupos de operadores podem ser recuperadas usando-se o cmdlet Get-CsRgsAgentGroup. Para obter detalhes, consulte a seção Exemplos, neste tópico. Se uma chamada for encaminhada para uma fila de espera à qual não houver atribuição de grupos de operadores (à qual só houver sido atribuídos grupos de operadores vazios), a chamada será desconectada automaticamente. |
Description |
Opcional |
Cadeia de caracteres |
Permite que os administradores forneçam informações adicionais sobre a fila de espera do Grupo de Resposta. |
OverflowAction |
Opcional |
objeto CallAction |
Ação a ser executada se for alcançado o limite de excedente. OverflowAction deve ser criado usando-se o cmdlet New-CsRgsCallAction. |
OverflowCandidate |
Opcional |
Modificador de Lista PS |
Indica qual chamada será atendida caso o limite de excedente seja alcançado. A propriedade OverflowCandidate deve ser definida com um dos dois valores seguintes: NewestCall OldestCall O valor padrão é NewestCall. |
OverflowThreshold |
Opcional |
Inteiro |
Número de chamadas simultâneas que podem estar na fila de espera a qualquer momento antes que a ação excedente seja acionada. OverflowThreshold pode ser qualquer valor inteiro entre 0 e 1.000, inclusive. O valor padrão é Null, o que significa que um número ilimitado de chamadas pode estar na fila de espera a qualquer momento. |
TimeoutAction |
Opcional |
objeto CallAction |
Ação a ser executada se for alcançado o tempo limite. TimeoutAction deve ser criado usando-se o cmdlet New-CsRgsCallAction. |
TimeoutThreshold |
Opcional |
Inteiro |
Período de tempo (em segundos) que uma chamada pode permanecer na fila de espera até que se esgote o seu tempo limite. Nesse momento, o sistema executará a ação especificada pelo parâmetro TimeoutAction. O tempo limite pode ser um valor inteiro entre 10 e 65.535 segundos (aproximadamente 18 horas), inclusive; o valor padrão é nulo, o que significa que a fila de espera nunca tem o tempo limite esgotado. |
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. |
InMemory |
Opcional |
Parâmetro de opção |
Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet. |
Tipos de Entrada
Nenhuma. New-CsRgsQueue não aceita entradas canalizadas.
Tipos de Retorno
O cmdlet New-CsRgsQueue cria novas instâncias do objeto Microsoft.Rtc.Rgs.Management.WritableSettings.Queue.
Exemplo
-------------------------- Exemplo 1 ------------------------
$x = New-CsRgsCallAction -Action TransferToVoicemailUri -Uri "sip:+14255551298@litwareinc.com"
New-CsRgsQueue -Parent service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" -OverflowCandidate "OldestCall" -OverflowAction $x -OverflowThreshold 25
O exemplo 1 cria uma nova fila do Grupo de Resposta para o serviço ApplicationServer:atl-cs-001.litwareinc.com. O primeiro comando neste exemplo usa o cmdlet New-CsRgsCallAction para criar uma ação de chamada para a fila; neste exemplo, qualquer momento que o limite de estouro é excedido, as chamadas serão automaticamente transferidas para a caixa postal. Isto é definido pela configuração do parâmetro Action para TransferToVoicemailUri e a propriedade de URI para o URI de SIP da caixa postal "sip:+14255551298@litwareinc.com".
Depois que a ação de chamada tiver sido configurada (e armazenada na variável $x), utiliza-se o cmdlet New-CsRgsQueue para criar uma nova fila de espera denominada Assistência Técnica. Além de especificar OverflowAction, este comando também configura valores para as propriedades OverflowCandidate e OverflowThreshold.