Compartilhar via

  • Artigo

Get-CsVoiceRoute

 

Tópico modificado em: 2012-03-23

Retorna informações sobre as rotas de voz configuradas para uso na organização.

Sintaxe

Get-CsVoiceRoute [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsVoiceRoute [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrição Detalhada

Use este cmdlet para recuperar uma ou várias rotas de voz existentes. As rotas de voz contêm instruções que informam ao Microsoft Lync Server 2010 como rotear as chamadas de usuários do Enterprise Voice para números de telefone na PSTN (rede telefônica pública comutada) ou na PBX (Central Privada de Comutação).

Este cmdlet pode ser usado para recuperar as informações das rotas de voz, como gateways PSTN aos quais a rota estiver associada (se houver alguma), quais usos da PSTN estão associados à rota, o padrão do telefone (na forma de uma expressão regular) que identifica os números de telefone aos quais a rota se aplicar e as definições do ID de chamador. O uso da PSTN associa a rota de voz a uma política de voz.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

XdsGlobalRelativeIdentity

Uma cadeia de caracteres que identifica unicamente a rota de voz. Se nenhuma identificação for fornecida, todas as rotas de voz da organização são devolvidas.

Filter

Opcional

Cadeia de caracteres

Este parâmetro filtra os resultados da operação Get baseada no valor de caracteres curinga passado para este parâmetro.

LocalStore

Opcional

SwitchParameter

Recupera a rota de voz da réplica local do Repositório de Gerenciamento Central em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

Este cmdlet retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route.

Exemplo

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

Get-CsVoiceRoute

Recupera as propriedades de todas as rotas de voz definidas na organização.

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

Get-CsVoiceRoute -Identity Route1

Recupera as propriedades para a rota de voz Route1.

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

Get-CsVoiceRoute -Filter *test*

Este comando exibe as definições da rota de voz cuja identidade contiver a cadeia de caracteres "test" em qualquer posição do valor. Para localizar a cadeia de caracteres "test" somente no final da identidade, use o valor *test. Da mesma forma, para localizar a cadeia de caracteres "test" somente se ela ocorrer no início da identidade, especifique o valor test*.

-------------------------- Exemplo 4 --------------------------

Get-CsVoiceRoute | Where-Object {$_.PstnGatewayList.Count -eq 0}

Este comando recupera todas as rotas de voz que não tiveram nenhum gateway PSTN atribuído. Primeiro, todas as rotas de voz são recuperadas usando o cmdlet Get-CsVoiceRoute. Estas rotas de voz serão então canalizadas para o cmdlet Where-Object. Where-Object restringe os resultados da operação Get. Neste caso, procura-se cada rota de voz (representada por $_) e se verifica a propriedade Conta da propriedade PstnGatewayList. Se a contagem de gateways PSTN for igual a 0, a lista estará vazia e nenhum gateway foi definido para a rota.