Compartilhar via

  • Artigo

Set-CsCpsConfiguration

 

Tópico modificado em: 2012-03-26

Modifica uma coleção existente de configurações do serviço de Estacionamento de Chamadas. O estacionamento de chamadas é um serviço que permite a um usuário "estacionar" uma chamada telefônica de entrada. O estacionamento de uma chamada transfere-a para um número em um intervalo especificado, ou órbita, e imediatamente põe a chamada em espera. Alguém (não somente a pessoa que originalmente atendeu à chamada) pode retomar a conversa de qualquer telefone simplesmente inserindo o número correto.

Sintaxe

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

Set-CsCpsConfiguration [-CallPickupTimeoutThreshold <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnableMusicOnHold <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxCallPickupAttempts <Int32>] [-OnTimeoutURI <String>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Este cmdlet é usado para modificar uma configuração existente do serviço de Estacionamento de Chamadas. Uma configuração do serviço de Estacionamento de Chamadas especifica o que acontece a uma chamada uma vez que é estacionada. Por exemplo, se uma chamada estacionada não for respondida depois de um período de tempo, pode ser automaticamente expedida a 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 é esquecida. Além disso, o serviço de Estacionamento de Chamadas pode ser configurado para tocar música de espera para o chamador enquanto a chamada estiver estacionada.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsCpsConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Cadeia de caracteres

Um identificador único da configuração que você deseja modificar. A Identidade especifica o escopo no qual a configuração é aplicada, Global ou um local específico (no local de formato: <nomedolocal>, como local:Redmond).

Instance

Opcional

CallParkServiceSettings

Uma referência de objeto para um objeto de configuração do serviço de Estacionamento de Chamadas, do tipo Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings. Este objeto pode ser recuperado chamando o cmdlet Get-CsCpsConfiguration. O objeto então pode ser modificado e as modificações salvas passando o objeto de volta para Set-CsCpsConfiguration neste parâmetro.

CallPickupTimeoutThreshold

Opcional

TimeSpan

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

Deve ser inserido no formato hh:mm:ss (hh = horas, mm = minutos, ss = 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 toca para o chamador enquanto uma chamada é 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.

MaxCallPickupAttempts

Opcional

Int32

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

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 definidas com o parâmetro MaxCallPickupAttempts. Se o parâmetro for definido como Null, OnTimeoutURI será ignorado e a chamada estacionada será desconectada após tentativas mal-sucedidas de chamadas de retorno.

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

Force

Opcional

SwitchParameter

Suprime eventuais avisos de confirmação que seriam exibidos para a realização de alterações.

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

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings. Aceita entrada em pipeline de objetos do serviço de Estacionamento de Chamadas.

Tipos de Retorno

Modifica um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings.

Exemplo

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

Set-CsCpsConfiguration -Identity site:Redmond1 -MaxCallPickupAttempts 2

O comando mostrado no Exemplo 1 modifica a configuração do serviço de Estacionamento de Chamadas com a Identidade site:Redmond1 definindo o número máximo de vezes em que uma chamada estacionada tocará de volta ao telefone de atendimento como 2. Isto é feito pela inclusão do parâmetro MaxCallPickupAttempts, com valor de parâmetro igual a 2.

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

Get-CsCpsConfiguration | Set-CsCpsConfiguration -MaxCallPickupAttempts 2

O Exemplo 2 é uma variação do comando mostrado no Exemplo 1; mas neste caso, em vez de definirmos apenas uma configuração, definimos todas as configurações do serviço de Estacionamento de Chamadas com o valor de propriedade MaxCallPickupAttempts igual a 2. Para fazer isto, Get-CsCpsConfiguration é usado para recuperar uma coleção de todas as configurações do serviço de Estacionamento de Chamadas em uso na organização. Esta coleção é então canalizada para o cmdlet Set-CsCpsConfiguration, que toma cada item individual na coleção e estabelece o valor da propriedade MaxCallPickupAttempts como 2.

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

Set-CsCpsConfiguration -Identity site:Redmond1 -CallPickupTimeoutThreshold 00:00:45

Este exemplo modifica a configuração do estacionamento de chamadas para o site Redmond1, definindo o tempo que se passará antes que uma chamada estacionada toque de volta (contido na propriedade CallPickupTimeoutThreshold) em 45 segundos.