Get-CsNetworkRegion
Tópico modificado em: 2012-03-23
Recupera uma ou mais regiões de rede. Regiões de rede representam hubs de rede ou backbones em uma rede corporativa.
Sintaxe
Get-CsNetworkRegion [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkRegion [-Filter <String>] [-LocalStore <SwitchParameter>]
Descrição Detalhada
Uma região de rede interconecta várias partes de uma rede em múltiplas áreas geográficas. Cada região de rede deve ser associada a um site central. Use este cmdlet para obter informações sobre uma ou mais regiões de rede, incluindo o site central e as configurações associadas que determinam se caminhos alternativos serão permitidos para conexões de áudio e vídeo, e que associam os sites de uma região a uma configuração de passagem livre de mídia.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Get-CsNetworkRegion 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-CsNetworkRegion"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Opcional |
XdsGlobalRelativeIdentity |
O identificador único da região de rede que você quer recuperar. A Identity vai estar na forma de uma cadeia de caracteres que identifica esta região de modo único. (Note que a Identity é a mesma que a NetworkRegionID.) |
Filter |
Opcional |
Cadeia de caracteres |
Este parâmetro permite que você execute um pesquisa com curinga na Identity de todas as regiões de rede configuradas para a organização. Use o caracter curinga para filtrar qualquer parte da Identity. |
LocalStore |
Opcional |
SwitchParameter |
Recupera as informações de região de 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
Retorna um ou mais objetos do tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType.
Exemplo
-------------------------- Exemplo 1 --------------------------
Get-CsNetworkRegion
O Exemplo 1 recupera todas as regiões de rede definidas para a organização.
-------------------------- Exemplo 2 --------------------------
Get-CsNetworkRegion -Identity NorthAmerica
O Exemplo 2 recupera as regiões de rede com a Identity NorthAmerica. Como as identidades são únicas, esse comando recupera no máximo uma região de rede.
-------------------------- Exemplo 3 --------------------------
Get-CsNetworkRegion -Filter *America
Esse exemplo recupera todas as regiões de rede com identidades que terminam com a cadeia de caracteres "America". Isso recuperaria regiões com identidades tais como NorthAmerica, SouthAmerica e CentralAmerica.
-------------------------- Exemplo 4 --------------------------
Get-CsNetworkRegion | Where-Object {$_.CentralSite -eq "site:Redmond"}
Esse exemplo recupera todas as regiões de rede associadas ao site central Redmond. O comando começa chamando o cmdlet Get-CsNetworkRegion, sem nenhum parâmetro, para recuperar uma coleção de todas as regiões de rede definidas para a implantação do Microsoft Lync Server 2010. Esta coleção é então canalizada para o cmdlet Where-Object. Where-Object filtra essa coleção para retornar somente os itens (regiões de rede) nos quais o valor de CentralSite seja igual a (-eq) site:Redmond.