Set-CsVoicePolicy

 

Tópico modificado em: 2012-03-27

Modifica uma política de voz existente.

Sintaxe

Set-CsVoicePolicy [-Identity <XdsIdentity>] [-AllowCallForwarding <$true | $false>] [-AllowPSTNReRouting <$true | $false>] [-AllowSimulRing <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableBWPolicyOverride <$true | $false>] [-EnableCallPark <$true | $false>] [-EnableCallTransfer <$true | $false>] [-EnableDelegation <$true | $false>] [-EnableMaliciousCallTracing <$true | $false>] [-EnableTeamCall <$true | $false>] [-Force <SwitchParameter>] [-Name <String>] [-PreventPSTNTollBypass <$true | $false>] [-PstnUsages <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsVoicePolicy [-AllowCallForwarding <$true | $false>] [-AllowPSTNReRouting <$true | $false>] [-AllowSimulRing <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableBWPolicyOverride <$true | $false>] [-EnableCallPark <$true | $false>] [-EnableCallTransfer <$true | $false>] [-EnableDelegation <$true | $false>] [-EnableMaliciousCallTracing <$true | $false>] [-EnableTeamCall <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Name <String>] [-PreventPSTNTollBypass <$true | $false>] [-PstnUsages <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Este cmdlet modifica uma política de voz existente. As políticas de voz são utilizadas para gerenciar tais recursos relacionados ao Enterprise Voice como o toque simultâneo (a capacidade de ter um segundo toque telefônico a cada vez que alguém chamar o seu telefone de escritório) e o encaminhamento de chamadas. Use este cmdlet para alterar as definições que habilitam e desabilitam muitos destes recursos.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-CsVoicePolicy localmente: 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 "Set-CsVoicePolicy"}

Parâmetros

Parâmetro	Obrigatório	Digite	Descrição
Identity	Opcional	Cadeia de caracteres	Um identificador exclusivo que especifica o escopo e, em alguns casos, o nome da política.
Instance	Opcional	VoicePolicy	Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais. Esse objeto deve ser do tipo VoicePolicy e pode ser recuperado chamando-se o cmdlet Get-CsVoicePolicy.
AllowCallForwarding	Opcional	Booleano	Se este parâmetro for definido como True, os usuários atribuídos a essa política poderão encaminhar chamadas. Se este parâmetro for definido como False, as chamadas não poderão ser encaminhadas.
AllowPSTNReRouting	Opcional	Booleano	Quando esse parâmetro for definido como True, as chamadas feitas para os números internos abrigados em outro pool serão encaminhadas através da rede telefônica pública comutada (PSTN) quando o pool ou a WAN estiver indisponível.
AllowSimulRing	Opcional	Booleano	O toque simultâneo é um recurso que permite que diversos telefones toquem quando um único número for discado. A definição deste parâmetro como True habilitará o toque simultâneo. Se este parâmetro for definido como False, o toque simultâneo não poderá ser configurado para nenhum usuário atribuído a esta política.
Description	Opcional	Cadeia de caracteres	Uma descrição da política de voz. Comprimento máximo: 1040 caracteres.
EnableBWPolicyOverride	Opcional	Booleano	As políticas podem ser definidas para limitar a largura de banda e definir várias outras propriedades relacionadas à configuração de rede. A definição deste parâmetro como True permitirá a substituição dessas políticas. Em outras palavras, se esse parâmetro for definido como True, nenhuma verificação de largura de banda será realizada e as chamadas serão efetuadas independentemente das definições do controle de admissão de chamadas (CAC).
EnableCallPark	Opcional	Booleano	O Aplicativo de Estacionamento de Chamada permite que uma chamada seja mantida (estacionada) em um determinado número de um intervalo de números, para recuperação posterior. A definição desse parâmetro como True habilita esse aplicativo para os usuários que tiverem recebido a atribuição dessa política. Se este parâmetro for definido como False, os usuários atribuídos a esta política não poderão estacionar chamadas que tiverem sido feitas para o seu número de telefone.
EnableCallTransfer	Opcional	Booleano	Determina se as chamadas podem ser transferidas para outro número. Se este parâmetro for definido como True, as chamadas poderão ser transferidas; se o parâmetro for definido como False, as chamadas não poderão ser transferidas.
EnableDelegation	Opcional	Booleano	A delegação de chamadas permite a um usuário atender a chamadas de outro usuário ou fazer chamadas em nome de outro. Por exemplo, um gerente pode configurar a delegação de chamada para que todas as chamadas de entrada toquem tanto no seu telefone como no telefone de um administrador. A definição deste parâmetro como True permite que os usuários com esta política configurem a delegação de chamadas. A definição deste parâmetro como False desabilita a delegação de chamadas.
EnableMaliciousCallTracing	Opcional	Booleano	O rastreamento de chamada maliciosa é um padrão em vigor que rastreia as chamadas que um usuário indicar como sendo maliciosas. Essas chamadas podem ser rastreadas mesmo se o ID do chamador for bloqueado. O rastreamento está disponível somente para as autoridades relevantes, e não para o usuário. A definição desta propriedade como True habilita a capacidade de rastrear as chamadas maliciosas.
EnableTeamCall	Opcional	Booleano	A Chamada de equipe permite que um usuário designe um grupo de outros usuários cujos telefones tocarão quando o número desse usuário for chamado. Este recurso é útil em equipes nas quais, por exemplo, qualquer pessoa da equipe pode atender a chamadas feitas pelos clientes. A definição deste parâmetro como True habilita este recurso.
Name	Opcional	Cadeia de caracteres	Um nome intuitivo que descreve esta política.
PreventPSTNTollBypass	Opcional	Booleano	As tarifas PSTN são mais comumente conhecidas como tarifas de longa distância. As organizações podem evitar essas tarifas implementando uma solução de Voz sobre o protocolo de Internet (VoIP), que permite aos escritórios se conectarem através de chamadas pela rede. A definição deste parâmetro como True enviará chamadas pela PSTN e incorrerá em tarifas, em vez de utilizar a rede e obter isenção das tarifas.
PstnUsages	Opcional	PSListModifier	Uma lista de usos da PSTN disponíveis para esta política. O uso da PSTN vincula uma política de voz a uma rota de telefone. Qualquer valor de cadeia de caracteres pode ser colocado nesta lista, contanto que esse valor exista na lista global de usos da PSTN em vigor. (não são permitidas cadeias de caracteres duplicadas; todas as cadeias de caracteres devem ser exclusivas). A lista de usos da PSTN pode ser recuperada chamando-se o cmdlet Get-CsPstnUsage. Lembre-se de que se você usar esse parâmetro para remover todos os usos da PSTN da política, os usuários que tiverem recebido essa política não poderão fazer chamadas de saída da PSTN.
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.Policy.Voice.VoicePolicy. Aceita entradas canalizadas de objetos de política de voz.

Tipos de Retorno

Este cmdlet não retorna um valor ou objeto. Em vez disso, ele configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Voice.VoicePolicy.

Exemplo

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

Set-CsVoicePolicy UserVoicePolicy2 -AllowSimulRing $false -PstnUsages @{remove="Local"}

Este exemplo define a propriedade AllowSimulRing como False para a política por usuário UserVoicePolicy2, indicando que quaisquer usuários atribuídos a esta política não estarão habilitados para o toque simultâneo, um recurso que determina se um segundo telefone (como um celular) pode ser definido para tocar a cada vez que o telefone do escritório do usuário tocar. Este comando também remove "Local" da lista de usos da PSTN desta política (observe que o parâmetro Identity não é especificado explicitamente. O parâmetro Identity é um parâmetro posicional e, portanto, se o valor da identidade for colocado primeiro na lista de parâmetros, não há necessidade de afirmar explicitamente que ele é a identidade.)

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

$a = Get-CsPstnUsage
Set-CsVoicePolicy -Identity site:Redmond -PstnUsages @{replace=$a.Usage}

Este exemplo modifica uma política de voz do site de Redmond, para que todos os usos da PSTN definidos para a organização sejam aplicados a esta política. A primeira linha neste exemplo chama o cmdlet Get-CsPstnUsage, para recuperar o conjunto global de usos da PSTN da organização e salvá-lo na variável $a. A segunda linha chama Set-CsVoicePolicy, para modificar a política de voz do site de Redmond. Um valor é passado para o parâmetro PstnUsages para substituir a lista atual de usos da política pela lista contida no conjunto global de usos da PSTN. Observe a sintaxe do valor substituído: $a.Usage. Isto refere-se à propriedade Usage das configurações de uso da PSTN, que contém a lista de usos de PSTN.

Consulte Também

Outros Recursos

New-CsVoicePolicy
Remove-CsVoicePolicy
Get-CsVoicePolicy
Grant-CsVoicePolicy
Test-CsVoicePolicy
Get-CsPstnUsage