Compartilhar via

  • Artigo

New-CsVoiceRoute

 

Tópico modificado em: 2012-03-26

Cria uma nova rota de voz. As rotas de voz contêm instruções que informam ao Microsoft Lync Server 2010 como encaminhar chamadas de usuários do Enterprise Voice para números de telefone na Rede telefônica pública comutada (PSTN) ou em uma Central privada de comutação (PBX).

Sintaxe

New-CsVoiceRoute -Identity <XdsGlobalRelativeIdentity> [-AlternateCallerId <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NumberPattern <String>] [-Priority <Int32>] [-PstnGatewayList <PSListModifier>] [-PstnUsages <PSListModifier>] [-SuppressCallerId <Nullable>] [-WhatIf [<SwitchParameter>]]

New-CsVoiceRoute -Name <String> [-AlternateCallerId <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NumberPattern <String>] [-Priority <Int32>] [-PstnGatewayList <PSListModifier>] [-PstnUsages <PSListModifier>] [-SuppressCallerId <Nullable>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Use este cmdlet para criar uma nova rota de voz. Todas as rotas de voz são criadas no escopo Global. Contudo, é possível definir diversas rotas de voz globais. Isto é realizado mediante o uso do parâmetro Identity, que requer um nome de rota exclusivo.

As rotas de voz são associadas a políticas de voz, por meio dos usos da PSTN. Uma rota de voz inclui uma expressão regular que identifica quais números de telefone serão direcionados por uma determinada rota de voz: os números de telefone que corresponderem à expressão regular serão direcionados por esta rota.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsIdentity

Um nome que identifica unicamente a rota de voz. As rotas de voz podem ser definidas somente no escopo global, portanto a identidade é simplesmente o nome que se deseja dar à rota (é possível que haja espaços no nome da rota. Por exemplo: Rota de Teste, mas a cadeia de caracteres completa deve ser colocada entre aspas duplas na chamada de New-CsVoiceRoute).

Se a Identidade for especificada, o Nome deve ser deixado em branco. O valor da Identidade será atribuído ao Nome.

Name

Obrigatório

Cadeia de caracteres

O nome exclusivo da rota de voz. Se este parâmetro for definido, o valor será automaticamente aplicado à Identidade da rota de voz. Você não pode especificar tanto uma Identidade quanto um Nome.

AlternateCallerId

Opcional

Cadeia de caracteres

Se o parâmetro SuppressCallerId for definido como Verdadeiro, o valor do parâmetro AlternateCallerId será exibido aos destinatários, e não ao número real do chamador. Este número deve ser um número válido e poderia ser usado para representar uma divisão dentro de uma organização, como Suporte ou Recursos Humanos.

Se o parâmetro SuppressCallerId for definido como Falso, o parâmetro AlternateCallerId será ignorado.

Este valor deve corresponder à expressão regular (\+)?[1-9]\d*(;ext=[1-9]\d*)?. Em outras palavras, o valor pode ser iniciado por um sinal de adição (+), mas não é necessário; ele deve consistir em qualquer número de dígitos e pode ser seguido de um ramal iniciado por ;ext= e seguido de qualquer número de dígitos. (observe que se incluir um ramal, a cadeia de caracteres deverá ser colocada entre aspas duplas).

Description

Opcional

Cadeia de caracteres

Uma descrição do objetivo desta rota de voz.

NumberPattern

Opcional

Cadeia de caracteres

Uma expressão regular que especifica os números de telefone aos quais se aplica esta rota. Os números que satisfizerem a este padrão serão roteados segundo as demais definições de roteamento.

Padrão: [0-9]{10}

Priority

Opcional

Int32

Um número pode ser resolvido para diversas rotas de voz. A prioridade determina a ordem na qual serão aplicadas as rotas, se houver mais de uma rota possível.

PstnGatewayList

Opcional

PSListModifier

No Lync Server 2010, um Servidor de Mediação pode ser associado a diversos gateways. Este parâmetro contém uma lista de gateways associados a essa rota de voz. Cada membro desta lista deve ser a Identidade do serviço do gateway PSTN ou Servidor de Mediação. O valor poderá fazer referência a um Servidor de Mediação apenas se a Servidor de Mediação estiver configurado para Microsoft Office Communications Server 2007 ou Microsoft Office Communications Server 2007 R2. Para Lync Server 2010, um gateway PSTN deve ser usado. A Identidade do serviço é uma cadeia de caracteres no formato <ServiceRole>:<FQDN>, onde ServiceRole é o nome da função de serviço (PSTNGateway) e FQDN é o nome de domínio totalmente qualificado do pool ou o endereço IP do servidor. Por exemplo, PSTNGateway:redmondpool.litwareinc.com. As identidades de serviço podem ser recuperadas chamando-se o comando Get-CsService | Select-Object Identity.

Por padrão, esta lista está vazia. Contudo, caso se deixe este parâmetro em branco na criação de uma nova rota de voz, será recebida uma mensagem de aviso.

PstnUsages

Opcional

PSListModifier

Uma lista de usos de PSTN (como Local ou Interurbano) que podem ser aplicados a esta rota de voz. O uso da PSTN deve constar como existente (os usos da PSTN podem ser recuperados chamando-se o cmdlet Get-CsPstnUsage).

Por padrão, esta lista está vazia. Contudo, caso se deixe este parâmetro em branco na criação de uma nova rota de voz, será recebida uma mensagem de aviso.

SuppressCallerId

Opcional

Booleano

Determina se um ID de chamador será revelado em chamadas de saída. Se este parâmetro for definido como True, o ID do chamador será suprimido. No lugar do ID real, será exibido o valor de AlternateCallerId. Quando SuppressCallerId for definido como True, deverá ser fornecido o valor de AlternateCallerId.

Force

Opcional

SwitchParameter

Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de se realizar as alterações.

InMemory

Opcional

SwitchParmeter

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

Cadeia de caracteres

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

Cria um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route.

Exemplo

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

New-CsVoiceRoute -Identity Route1

O comando neste exemplo cria uma nova rota de voz com uma Identidade igual a Route1. Todas as outras propriedades serão definidas com os valores padrão.

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

New-CsVoiceRoute -Identity Route1 -PstnUsages @{add="Long Distance"} -PstnGatewayList @{add="PstnGateway:redmondpool.litwareinc.com"}

O comando neste exemplo cria uma nova rota de voz com uma Identidade igual a Route1. Ele também adiciona o uso de PSTN Interurbano à lista de usos e o ID de serviço PstnGateway:redmondpool.litwareinc.com à lista de gateways PSTN.

-------------------------- Exemplo 3 --------------------------

$x = (Get-CsPstnUsage).Usage
New-CsVoiceRoute -Identity Route1 -PstnUsages @{add=$x}

Este exemplo cria uma nova rota de voz denominada Route1 e preenche a lista de usos da PSTN desta rota com todos os usos da organização. O primeiro comando neste exemplo recupera a lista de usos da PSTN globais. Observe que a chamada para Get-CsPstnUsage está entre parênteses; isto significa que primeiramente iremos recuperar um objeto que contém informações sobre o uso da PSTN Como há só um uso da PSTN global, somente um objeto será recuperado. Em seguida, o comando irá recuperar a propriedade Usage deste objeto. Essa propriedade, que contém uma lista de usos, é atribuída à variável $x. Na segunda linha deste exemplo, New-CsVoiceRoute será chamado para criar uma nova rota de voz. Esta rota de voz terá uma identidade de Route1. Observe o valor passado ao parâmetro PstnUsages: @{add=$x}. Este valor instrui para que se adicione o conteúdo de $x, que contém a lista de usos recuperada na linha 1, à lista de usos da PSTN desta rota.