Compartilhar via

  • Artigo

Get-CsNetworkRegionLink

 

Tópico modificado em: 2012-03-23

Recupera um ou mais links entre regiões de rede configuradas para o controle de admissão de chamadas (CAC).

Sintaxe

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

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

Descrição Detalhada

As regiões dentro de uma rede são vinculadas por meio da conectividade Wan. Esse cmdlet recupera um ou vários links de região que estiverem definidos dentro das definições de configuração da rede para a implantação do Microsoft Lync Server 2010.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

XdsGlobalRelativeIdentity

O identificador exclusivo do link da região de rede que se deseja recuperar. Como os links de região de rede são criados apenas no escopo global, esse identificador não precisa especificar um escopo. Em vez disto, ele contém uma cadeia de caracteres, que é um nome exclusivo que identifica este link (observe que esse valor é o mesmo que NetworkRegionLinkID.)

Filter

Opcional

Cadeia de caracteres

Aceita uma cadeia de caracteres curinga, que é usada para recuperar links de rede com base na correspondência com o valor da Identidade.

LocalStore

Opcional

SwitchParameter

Recupera as informações de link de região de rede na 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

Recupera um ou mais objetos do tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionLinkType.

Exemplo

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

Get-CsNetworkRegionLink

O Exemplo 1 recupera todos os links de região de rede definidos em uma implantação do Lync Server 2010.

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

Get-CsNetworkRegionLink -Identity NA_EMEA

O Exemplo 2 recupera informações sobre (no máximo) um link de região de rede, o link cuja Identidade for NA_EMEA.

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

Get-CsNetworkRegionLink -Filter *EMEA*

Nesse exemplo, utilizamos o parâmetro Filter para recuperar todos os links de região de rede que contiverem a cadeia de caracteres EMEA no seu nome (Identidade). Observe os caracteres *, um antes da cadeia de caracteres EMEA e um depois. Isso significa que qualquer caractere, ou caracteres, pode vir antes ou depois da cadeia de caracteres; a cadeia de caracteres EMEA deve estar incluída em alguma posição da Identidade. Isso irá recuperar links com nomes como NA_EMEA, EMEA_APAC e EMEA2_SA.

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

Get-CsNetworkRegionLink | Where-Object {$_.NetworkRegionID1 -eq "EMEA" -or $_.NetworkRegionID2 -eq "EMEA"}

Esse exemplo recupera todos os links de região de rede que incluírem EMEA como uma das duas regiões a serem ligadas. Inicialmente, o exemplo chama Get-CsNetworkRegionLink, sem parâmetros, recuperando todos os links de região. Esta coleção de links será então canalizada para o cmdlet Where-Object. Where-Object pesquisará cada membro da coleção, verificando os valores das propriedades NetworkRegionID1 e NetworkRegionID2. Se uma dessas propriedades for igual a EMEA, ou seja, se NetworkRegionID1 for igual a (-eq) EMEA ou (-or) NetworkRegionID2 for igual a (-eq) EMEA, esse item será mantido na coleção e exibido.