Compartilhar via

  • Artigo

Get-CsCpsConfiguration

 

Tópico modificado em: 2012-03-23

Retorna informações sobre o 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 no sistema inserindo o número correto.

Sintaxe

Get-CsCpsConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsCpsConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrição Detalhada

Este cmdlet é usado para recuperar uma ou mais configurações do serviço Estacionamento de chamadas. 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 (um administrador, por exemplo) ou a um Grupo de Resposta. As chamadas também 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 Get-CsCpsConfiguration localmente: RTCUniversalUserAdmins, 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 "Get-CsCpsConfiguration"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

XdsIdentity

O identificador exclusivo da configuração do serviço Estacionamento de chamadas que se deseja recuperar. O identificador será Global ou site:<sitename>, onde <sitename> é o nome do local ao qual se aplica a configuração.

Filter

Opcional

Cadeia de caracteres

Permite executar uma busca de caracteres curinga, para recuperar somente as configurações com valores de identidade que coincidirem com a cadeia de caracteres curinga.

LocalStore

Opcional

SwitchParameter

Recupera as informações do serviço Estacionamento de chamadas na réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

Recupera um ou mais objetos do tipo Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings.

Exemplo

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

Get-CsCpsConfiguration

O Exemplo 1 recupera uma coleção de todas as configurações do serviço Estacionamento de chamadas que tiverem sido definidas para uso na organização.

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

Get-CsCpsConfiguration -Identity site:Redmond1

O comando anterior recupera apenas as configurações do serviço Estacionamento de chamadas cuja Identidade for site:Redmond1.

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

Get-CsCpsConfiguration -Filter site:*

No Exemplo 3, o parâmetro Filter é usado para retornar todas as configurações do serviço Estacionamento de chamadas que tiverem sido configuradas no escopo de site. O caractere curinga site:* informa a Get-CsCpsConfiguration que retorne somente as definições cuja identidade começar pelo valor de cadeia de caracteres site:.

-------------------------- Exemplo 4 --------------------------

Get-CsCpsConfiguration -Filter *:re*

Como no Exemplo 3, neste exemplo usamos o parâmetro Filter para recuperar um subconjunto de todas as configurações definidas do serviço Estacionamento de chamadas. Neste caso, efetuamos a filtragem da cadeia de caracteres *:re*, que retornará as configurações de Estacionamento de chamadas de todos os sites cujos nomes forem iniciados pelas letras re, como Redmond1, Redmond2 e RemoteComputer.

-------------------------- Exemplo 5 --------------------------

Get-CsCpsConfiguration | Where-Object {$_.EnableMusicOnHold -eq $False}

O comando mostrado acima retorna todas as definições do serviço Estacionamento de chamadas que não reproduzirem música quando um chamador for colocado em espera. Para fazer isto, o comando usa primeiramente Get-CsCpsConfiguration, para recuperar todas as definições do serviço Estacionamento de chamadas configuradas para uso na organização. Esta coleção será então canalizada para o cmdlet Where-Object, que, por sua vez, aplicará um filtro que limita os dados retornados aos itens cuja propriedade EnableMusicOnHold for igual a (-eq) False.