Compartilhar via

  • Artigo

New-CsVoicePolicy

 

Tópico modificado em: 2012-03-25

Cria uma nova política de voz.

Sintaxe

New-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>] [-InMemory <SwitchParameter>] [-Name <String>] [-PreventPSTNTollBypass <$true | $false>] [-PstnUsages <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Este cmdlet cria uma nova política de voz. As políticas de voz são utilizadas para gerenciar tais recursos relacionados com o 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. A política criada por este cmdlet determina se muitos destes recursos estarão habilitados ou desabilitados.

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

Parâmetros

Parameter Obrigatório Tipo Descrição

Identity

Obrigatório

XdsIdentity

Um identificador exclusivo que especifica o escopo ou o nome da política. Os valores válidos para este cmdlet são:<nome do site> (onde <nome do site> é o nome do site Microsoft Lync Server 2010 ao qual se aplica esta política, como site:Redmond) e uma cadeia de caracteres designando uma política por usuário, como RedmondVoicePolicy. Por padrão, há uma política global.

AllowCallForwarding

Opcional

Booleano

Se este parâmetro for definido como True, as chamadas poderão ser encaminhadas. Se este parâmetro for definido como False, as chamadas não poderão ser encaminhadas.

Padrão: Verdadeiro

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.

Padrão: Verdadeiro

AllowSimulRing

Opcional

Booleano

O toque simultâneo é um recurso que permite que diversos telefones toquem quando um único número é discado. A definição deste parâmetro como True habilita este recurso. Se este parâmetro for definido como False, o toque simultâneo não poderá ser configurado para nenhum usuário ao qual esta política estiver atribuída.

Padrão: Verdadeiro

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 gerenciar a configuração de rede, inclusive para limitar a largura de banda. 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).

Padrão: False

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 deste parâmetro como True habilita o aplicativo. 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.

Padrão: False

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.

Padrão: Verdadeiro

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 chamadas para que todas as chamadas de entrada toquem tanto no telefone do gerente 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.

Padrão: Verdadeiro

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 apropriadas, e não para o usuário. A definição desta propriedade como True habilita a capacidade de atribuir o rastreamento de chamadas maliciosas.

Padrão: False

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.

Padrão: Verdadeiro

Name

Opcional

Cadeia de caracteres

Um nome para exibição que descreve esta política.

Padrão: DefaultPolicy

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 usando 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.

Padrão: False

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.

Por padrão, esta lista está vazia. Se não for fornecido um valor para este parâmetro, será emitida uma mensagem de aviso informando que os usuários aos quais esta política tiver sido concedida não serão capazes de realizar 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.

InMemory

Opcional

SwitchParameter

Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet.

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

Nenhuma.

Tipos de Retorno

Este cmdlet cria uma instância do objeto Microsoft.Rtc.Management.WritableConfig.Voice.VoicePolicy.

Exemplo

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

New-CsVoicePolicy -Identity UserVoicePolicy1

Este exemplo cria uma nova política de voz por usuário com definições padrão, cuja identidade é igual a UserVoicePolicy1.

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

New-CsVoicePolicy UserVoicePolicy2 -AllowSimulRing $false -PstnUsages @{add = "Local"}

Este exemplo cria uma nova política de voz para cada usuário com a identidade igual a UserVoicePolicy2 e define como False a propriedade AllowSimulRing, indicando que quaisquer usuários aos quais esta política for atribuída não estarão habilitados para o toque simultâneo, um recurso que determina se um segundo telefone (como um celular, por exemplo) pode ser definido para tocar a cada vez que o telefone do escritório do usuário tocar. Este comando também adiciona "Local" à lista de usos da PSTN, que associa esta política de voz a uma rota de voz que também usa o uso da PSTN Local. (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 3 --------------------------

$a = Get-CsPstnUsage
New-CsVoicePolicy site:Redmond -PstnUsages @{add = $a.Usage}

Este exemplo cria uma nova política de voz para o site de Redmond e aplica todos os usos da PSTN definidos por esta política na organização. 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 New-CsVoicePolicy para criar a nova política de voz do site de Redmond. Passa-se um valor ao parâmetro PstnUsages, para adicionar a esta política a lista contida no conjunto global de usos da PSTN. Observe a sintaxe do valor adicionado: $a.Usage. Ela se refere à propriedade Usage das definições de uso da PSTN, que contém a lista de usos da PSTN.