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.
Consulte Também
Outros Recursos
New-CsCpsConfiguration
Set-CsCpsConfiguration
Get-CsCpsConfiguration
Set-CsCallParkServiceMusicOnHoldFile