Compartilhar via

  • Artigo

Get-CsNetworkInterRegionRoute

 

Tópico modificado em: 2012-03-23

Recupera uma ou mais rotas que conectam regiões de rede em uma configuração do CAC (controle de admissão de chamadas).

Sintaxe

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

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

Descrição Detalhada

Todas as regiões em uma configuração do CAC precisam ter alguma maneira de acessar todas as outras regiões. Enquanto os links de regiões definem limitações de largura de banda nas conexões entre regiões e também representam os links físicos, uma rota determina qual caminho vinculado a conexão irá transpor de uma região para a outra. O cmdlet recupera informações sobre estas associações de rota.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

XdsGlobalRelativeIdentity

O identificador único para a rota de região de rede que você deseja recuperar. As rotas de regiões de rede são criadas apenas em escopo global, então o identificador não precisa especificar um escopo. Em vez disso, ele contém uma cadeia de caracteres que é um nome exclusivo para identificação de uma rota específica.

Filter

Opcional

Cadeia de caracteres

Uma cadeia de caracteres que permite recuperar rotas correspondendo os valores de identidade à cadeia de caracteres de curinga passada como valor para o parâmetro.

LocalStore

Opcional

SwitchParameter

Recupera as informações de rota inter-região da rede a partir da réplica local do Repositório de Gerenciamento Central, e não do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

O cmdlet retorna um ou mais objetos do tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType.

Exemplo

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

Get-CsNetworkInterRegionRoute -Identity NA_APAC_Route

O Exemplo 1 recupera a rota com identidade NA_APAC_Route.

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

Get-CsNetworkInterRegionRoute -Filter *APAC*

No Exemplo 2, usamos o parâmetro Filter para recuperar todas as rotas que contenham a cadeia de caracteres APAC em qualquer lugar da Identity.

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

Get-CsNetworkInterRegionRoute | Where-Object {$_.NetworkRegionLinks -eq "NA_EMEA"}

Este exemplo recupera todas as rotas de região que usam o link de região de rede NA_EMEA. O comando começa chamando o cmdlet Get-CsNetworkInterRegionRoute. Quando chamado sem parâmetros, este cmdlet recupera todas as rotas definidas com a configuração do CAC. Essa coleção de rotas é então canalizada para o cmdlet Where-Object. Where-Object recupera todos os itens da coleção que tenham o valor NA_EMEA em sua lista NetworkRegionLinks.

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

Get-CsNetworkInterRegionRoute | Where-Object {$_.NetworkRegionID1 -eq "NorthAmerica" -or $_.NetworkRegionID2 -eq "NorthAmerica"}

O Exemplo 4 recupera todas as rotas de região que incluam a região NorthAmerica. A primeira parte do comando é uma chamada ao cmdlet Get-CsNetworkInterRegionRoute. Quando chamado sem parâmetros, este cmdlet recupera todas as rotas de região. A seguir, essa coleção de rotas é canalizada para o cmdlet Where-Object. O cmdlet Where-Object restringe a coleção apenas às rotas que tenham NorthAmerica definido como uma das regiões da rota. Para isso, ele verifica se a rota tem um valor de NetworkRegionID1 igual a (-eq) NorthAmerica, ou (-or) um valor de NetworkRegionID2 igual a NorthAmerica.