Compartilhar via

  • Artigo

Remove-CsVoicePolicy

 

Tópico modificado em: 2012-03-24

Remove a política de voz especificada.

Sintaxe

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

Descrição Detalhada

Este cmdlet remove uma política de voz existente. Políticas de voz são usadas para gerenciar tais características relacionada ao Enterprise Voice como toque simultâneo ( a habilidade de ter um segundo toque do telefone cada vez que alguém chama seu telefone do escritório) e encaminhamento de chamada. Este cmdlet pode também ser usado para remover a política de voz global. Neste caso, no entanto, a política não vai realmente ser removida; ao contrário, as configurações da política vão simplesmente ser redefinidas para seus valores padrões.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Remove-CsVoicePolicy 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 "Remove-CsVoicePolicy"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsIdentity

Um identificador único especificando o escopo, e em alguns casos o nome, da política a ser removida.

Force

Opcional

SwitchParameter

Suprimi qualquer aviso de confirmação que seria de outra forma exibido antes de fazer 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.Policy.Voice.VoicePolicy. Aceita entrada em pipeline dos objetos de diretiva de voz.

Tipos de Retorno

Este cmdlet não retorna um valor. Ele remove uma instância de um objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoicePolicy.

Exemplo

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

Remove-CsVoicePolicy -Identity UserVoicePolicy1

Este exemplo remove as configurações de política de voz por usuário de UserVoicePolicy1.

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

Get-CsVoicePolicy -Filter tag* | Remove-CsVoicePolicy

Este exemplo remove todas as configurações de política de voz que podem ser atribuídas a usuários específicos. Primeiro o cmdlet Get-CsVoicePolicy é chamado com um Filter tag*, que recupera todas as políticas de voz por usuário. Esta coleção de políticas é então direcionada para o cmdlet Remove-CsVoicePolicy para ser removida.