Compartilhar via

  • Artigo

New-CsCpsConfiguration

 

Tópico modificado em: 2012-03-23

Cria uma nova coleção de definições do serviço Estacionamento de chamadas. O estacionamento de chamadas é um serviço que permite que um usuário "estacione" uma chamada telefônica recebida. O estacionamento de uma chamada a transfere para um número em um intervalo especificado (órbita) e imediatamente a coloca em espera. Qualquer pessoa (não somente a pessoa que originalmente atendeu a chamada) pode retomar a conversa de qualquer telefone, digitando o número correto.

Sintaxe

New-CsCpsConfiguration -Identity <XdsIdentity> [-CallPickupTimeoutThreshold <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnableMusicOnHold <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxCallPickupAttempts <Int32>] [-OnTimeoutURI <String>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Este cmdlet é usado para criar uma nova configuração do serviço Estacionamento de chamadas. Quando o serviço Estacionamento de chamadas for instalado, configuram-se as definições globais como padrão, que podem ser atualizadas, mas não removidas. ("Remover" as definições globais simplesmente as redefine para os valores padrão.) Por isso, este cmdlet é usado para criar somente definições de site específicas.

Uma configuração do serviço Estacionamento de chamadas especifica o que acontecerá a uma chamada quando ela for estacionada. Por exemplo: se uma chamada estacionada não for atendida após um período de tempo, ela poderá ser automaticamente encaminhada a uma outra pessoa, como um administrador ou a um Grupo de resposta. As chamadas podem ser configuradas para tocar depois de certo período de tempo, para assegurar que a chamada não será esquecida. Além disso, o serviço Estacionamento de chamadas pode ser configurado para tocar música em espera para o chamador enquanto a chamada estiver estacionada.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet New-CsCpsConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet foi atribuído (inclusive qualquer função RBAC personalizada que tenha sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsCpsConfiguration"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

XdsIdentity

O site ao qual estas configurações são aplicadas. Isto deve ser inserido no formato site:<sitename>, como site:Redmond, por exemplo. Uma configuração sempre existirá no escopo global e não poderá ser removida. Portanto, uma configuração global não poderá ser recriada com esse cmdlet.

CallPickupTimeoutThreshold

Opcional

TimeSpan

A quantidade de tempo que passará após uma chamada ser estacionada antes que ela toque de volta no telefone no qual foi atendida a chamada.

Deve ser inserida no formato hh:mm:ss (hh = horas, mm = minutos, ss = segundos)

Padrão: 00:01:30 (90 segundos); Valor Mínimo: 10 segundos (00:00:10); Valor Máximo: 10 minutos (00:10:00)

EnableMusicOnHold

Opcional

Booleano

Determina se a música é reproduzida para o chamador enquanto uma chamada estiver estacionada.

Microsoft Lync Server 2010 envia com uma Música padrão em arquivo Reter. Você pode modificar este arquivo (modificando a música que o chamador ouve enquanto estacionado) com o cmdlet Set-CsCallParkServiceMusicOnHoldFile.

Padrão: Verdadeiro

MaxCallPickupAttempts

Opcional

Int32

O número de vezes que uma chamada estacionada tocará de volta ao telefone de atendimento antes de ser abandonada e encaminhada ao URI (Uniform Resource Identifier). O URI de fallback é estabelecido com o parâmetro OnTimeoutURI.

Padrão: 1; Valor Mínimo: 1; Valor Máximo: 10

OnTimeoutURI

Opcional

Cadeia de caracteres

O endereço SIP do usuário ou Grupo de Resposta ao qual as chamadas estacionadas sem resposta serão roteadas. A chamada estacionada será roteada depois do número de chamadas de retorno, definido com o parâmetro MaxCallPickupAttempts. Se esse parâmetro for definido como Null, OnTimeoutURI será ignorado e a chamada estacionada será desconectada depois das tentativas de chamada de retorno sem sucesso.

Os valores devem ser SIP URIs, começando com a cadeia de caracteres sip:. Por exemplo, sip:rgs1@litwareinc.com.

Force

Opcional

SwitchParameter

Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de se realizar as alterações.

InMemory

Opcional

SwitchParameter

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.

WhatIf

Opcional

SwitchParameter

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

SwitchParameter

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

Este cmdlet apaga um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings.

Exemplo

-------------------------- Exemplo 1 --------------------------

New-CsCpsConfiguration -Identity site:Redmond1 -EnableMusicOnHold $False

O comando mostrado no Exemplo 1 usa o cmdlet New-CsCpsConfiguration, para criar uma configuração do serviço Estacionamento de chamadas do site Redmond1. Esta configuração será criada com valores padrão, com exceção de EnableMusicOnHold. Este comando define esta propriedade como False, indicando que o chamador cuja chamada foi estacionada não ouvirá nada enquanto esta estiver em espera (por padrão, EnableMusicOnHold é definida como True, presumindo-se que o serviço Estacionamento de chamadas tenha sido implantado).

-------------------------- Exemplo 2 --------------------------

New-CsCpsConfiguration -Identity site:Redmond1 -OnTimeoutURI sip:kenmyer@litwareinc.com

O comando mostrado no Exemplo 2 usa o cmdlet New-CsCpsConfiguration, para criar uma configuração do serviço Estacionamento de chamadas do site Redmond1. Por padrão, nenhum OnTimeoutURI é fornecido. Portanto, este exemplo adiciona um valor àquele parâmetro. Neste caso, o OnTimeoutURI é definido como sip:kenmyer@litwareinc.com. O valor passado a este parâmetro deve começar com a cadeia de caracteres "sip:" e deve apontar para um usuário ou Grupo de Resposta que receberá chamadas estacionadas que não são buscadas depois de um número especificado de tentativas de retorno de chamada.

-------------------------- Exemplo 3 --------------------------

New-CsCpsConfiguration -Identity site:Redmond1 -MaxCallPickupAttempts 2

O comando usa o cmdlet New-CsCpsConfiguration para criar uma configuração do serviço Estacionamento de chamadas do site Redmond1. Para este site, MaxCallPickupAttempts foi definido como 2. Isto significa que a chamada tocará de volta até duas vezes.