Compartilhar via

  • Artigo

Get-CsNetworkInterSitePolicy

 

Tópico modificado em: 2012-03-23

Recupera uma ou mais políticas entre sites de rede, que define limitações de largura de banda entre sites que estiverem diretamente vinculados em uma configuração do CAC (controle de admissão de chamadas).

Sintaxe

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

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

Descrição Detalhada

Quando os sites de rede compartilharem um link direto, será possível definir as limitações de largura de banda de conexões de áudio e vídeo entre esses dois sites. Esse cmdlet recupera uma ou várias políticas de site de rede que associam definições de limitação de largura de banda a sites diretamente conectados.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

XdsGlobalRelativeIdentity

O identificador único da política de site de rede que você deseja recuperar. As políticas de site de rede são criadas apenas no escopo global. Portanto, esse identificador não precisa especificar um escopo. Em vez disto, ele contém uma cadeia de caracteres que é um nome exclusivo que identifica a política.

Filter

Opcional

Cadeia de caracteres

Uma cadeia de caracteres que contém caracteres curinga que buscarão políticas de site com valores de Identidade a eles correspondentes.

LocalStore

Opcional

SwitchParameter

Recupera as informações de política entre sites 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

Remove um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkSitePolicyType.

Exemplo

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

Get-CsNetworkInterSitePolicy

A chamada de Get-CsNetworkInterSitePolicy sem parâmetros irá recuperar todas as políticas de site de rede definidas entre dois sites de redes diretamente vinculados.

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

Get-CsNetworkInterSitePolicy -Identity Reno_Portland

Esse exemplo recupera a política do site de rede com a Identidade Reno_Portland.

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

Get-CsNetworkInterSitePolicy -Filter *Reno*

O Exemplo 3 recupera todas as políticas de site de rede que possuírem a cadeia de caracteres Reno em qualquer posição do valor Identidade. Os caracteres curinga (*) dentro do valor passado para o parâmetro Filtro indicam "qualquer caractere ou conjunto de caracteres". Em outras palavras, a cadeia de caracteres *Reno* corresponderá a valores de Identidade que começarem por qualquer caractere (ou caracteres), seguidos pela cadeia de caracteres Reno e seguidos por qualquer caractere (ou caracteres).

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

Get-CsNetworkInterSitePolicy | Where-Object {$_.BWPolicyProfileID -eq $null}

Esse exemplo recupera todas as políticas de site de rede aos quais não tiver sido atribuído um perfil de política de largura de banda. O comando começa chamando Get-CsNetworkInterSitePolicy, que, como visto no Exemplo 1, recupera uma coleção de todas as políticas de site de rede. Esta coleção será então canalizada para o cmdlet Where-Object. Where-Object restringirá a coleção apenas às políticas de site que não possuírem um perfil de política de largura de banda atribuído. Ele realiza isso mediante comparações, verificando se a propriedade BWPolicyProfileID de cada política de site é igual a (-eq) Null ($null).