Get-CsNetworkSubnet
Tópico modificado em: 2012-03-23
Recupera informações sobre uma ou várias sub-redes.
Sintaxe
Get-CsNetworkSubnet [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkSubnet [-Filter <String>] [-LocalStore <SwitchParameter>]
Descrição Detalhada
Cada sub-rede deve ser associada a um site de rede, a fim de determinar a localização geográfica do host que pertence a essa sub-rede. Use este cmdlet para recuperar informações sobre a sub-rede, incluindo a Identidade (o ID da sub-rede), o número de bits da máscara, o site de rede associado e a descrição da sub-rede.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsNetworkSubnet 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 foi atribuído (inclusive qualquer função RBAC personalizada que tenha sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkSubnet"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Opcional |
XdsGlobalRelativeIdentity |
O identificador exclusivo da sub-rede que você deseja recuperar. Este valor será um endereço IP (como 174.11.12.0). |
Filter |
Opcional |
Cadeia de caracteres |
Use este parâmetro para realizar uma pesquisa com curingas de todas as sub-redes com base na Identidade. Por exemplo, o valor do Filtro 172.11.* irá recuperar todas as sub-redes cuja Identidade começar com 172.11. (como 172.11.10.0, 172.11.25.0, etc.). |
LocalStore |
Opcional |
SwitchParameter |
Recupera as informações de sub-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
Retorna um ou mais objetos do tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType.
Exemplo
-------------------------- Exemplo 1 --------------------------
Get-CsNetworkSubnet
Este exemplo recupera todas as sub-redes dentro da implantação do Microsoft Lync Server 2010.
-------------------------- Exemplo 2 --------------------------
Get-CsNetworkSubnet -Identity 172.11.15.0
Este exemplo recupera todas as informações sobre a sub-rede com a Identidade (o ID da sub-rede) 172.11.15.0.
-------------------------- Exemplo 3 --------------------------
Get-CsNetworkSubnet -Filter 172.11.*
Este exemplo recupera todas as sub-redes com identidades que começarem com 172.11.
-------------------------- Exemplo 4 --------------------------
Get-CsNetworkSubnet | Where-Object {$_.NetworkSiteID -eq "Vancouver"}
O Exemplo 4 recupera todas as sub-rede associadas ao site de Vancouver. Primeiramente, chama-se o cmdlet Get-CsNetworkSubnet, sem parâmetros, que, como vimos no Exemplo 2, recupera todas as sub-redes definidas. Canaliza-se então essa coleção de sub-redes para o cmdlet Where-Object. Where-Object usa esta coleção e a restringe apenas às sub-redes cujo NetworkSiteID for igual a (-eq) Vancouver.