Compartilhar via


Remove-CsCpsConfiguration

 

Tópico modificado em: 2012-03-27

Remove uma configuração existente de 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. Alguém (não somente a pessoa que originalmente tiver atendido à chamada) pode retomar a conversa de qualquer telefone, bastando digitar o número correto.

Sintaxe

Remove-CsCpsConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Este cmdlet é usado para remover a configuração do serviço Estacionamento de chamadas. Uma configuração do serviço Estacionamento de chamadas especifica o que acontecerá à chamada depois que ela for estacionada. Por exemplo, se uma chamada estacionada não for respondida 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 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.

Este cmdlet pode ser usado para remover quaisquer configurações do Estacionamento de chamadas, inclusive a configuração Global. No caso da configuração Global, entretanto, a configuração na verdade não será removida. Em vez disso, ela será simplesmente redefinida com o seu valor padrão.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-CsCpsConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsIdentity

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

Force

Opcional

SwitchParameter

Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de se realizar as 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 canalizada dos objetos de configuração do serviço Estacionamento de chamadas.

Tipos de Retorno

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

Exemplo

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

Remove-CsCpsConfiguration -Identity site:Redmond1

O comando anterior usa o cmdlet Remove-CsCpsConfiguration para excluir a configuração do serviço Estacionamento de chamadas cuja identidade for site:Redmond1. Uma vez que as identidades são únicas, este comando resultará em somente uma configuração a ser excluída.

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

Get-CsCpsConfiguration -Filter site:* | Remove-CsCpsConfiguration

No Exemplo 2, serão excluídas todas as configurações de serviço Estacionamento de chamadas que tiverem sido definidas no escopo de site. Para executar esta tarefa, o comando usa primeiramente Get-CsCpsConfiguration e o parâmetro Filter, para retornar todas as configurações do serviço Estacionamento de chamadas que tiverem sido definidas no escopo de site; o caractere curinga site:* garante que somente as configurações cuja identidade for iniciada pelo valor da cadeia de caracteres site: serão retornadas. Esta coleção filtrada será então canalizada para Remove-CsCpsConfiguration, que excluirá cada item na coleção. Observe que sempre que se remover as definições do serviço Estacionamento de chamadas de um site, ele passará automaticamente a usar as definições do serviço Estacionamento de chamadas configuradas no escopo global.