Get-CsNetworkSite
Tópico modificado em: 2012-03-23
Recupera um ou mais locais de rede definidos para o controle de admissão de chamadas (CAC) ou Enhanced 9-1-1 (E9-1-1).
Sintaxe
Get-CsNetworkSite [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkSite [-Filter <String>] [-LocalStore <SwitchParameter>]
Descrição Detalhada
Os sites de rede são os escritórios ou locais configurados em cada região de uma implantação do CAC ou E9-1-1. Este cmdlet recupera as definições de um ou mais sites existentes.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsNetworkSite 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-CsNetworkSite"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Opcional |
XdsGlobalRelativeIdentity |
O identificador exclusivo do site de rede que se deseja recuperar. Como os sites são criados apenas no escopo global, não é necessário especificar um escopo. Em vez disso, é preciso especificar apenas o ID do site (observe que este é o mesmo valor que o NetworkSiteID de um site de rede.) |
Filter |
Opcional |
Cadeia de caracteres |
Uma cadeia de caracteres curinga permite recuperar múltiplos sites com base na coincidência entre a identidade do site e o valor de filtro. |
LocalStore |
Opcional |
SwitchParameter |
Recupera as informações de local 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.DisplayNetworkSiteType.
Exemplo
-------------------------- Exemplo 1 --------------------------
Get-CsNetworkSite
O ato de chamar Get-CsNetworkSite sem nenhum parâmetro retornará todos os locais de rede configurados para CAC ou E911 na implantação do Microsoft Lync Server 2010.
-------------------------- Exemplo 2 --------------------------
Get-CsNetworkSite -Identity Redmond
Este comando recupera o site com a identidade (e, por definição, o NetworkSiteID) Redmond.
-------------------------- Exemplo 3 --------------------------
Get-CsNetworkSite -Filter NA*
O comando no Exemplo 3 chama Get-CsNetworkSite com o parâmetro Filter. O valor do parâmetro Filter é NA*, indicando que esse comando recuperará todos os sites cuja identidade começar com a cadeia de caracteres NA e seguido de qualquer número de caracteres. Isto retornará sites como NARedmond, NAVancouver e NAChicago.
-------------------------- Exemplo 4 --------------------------
Get-CsNetworkSite | Where-Object {$_.NetworkRegionID -eq "NorthAmerica"}
O Exemplo 4 utiliza dois cmdlets, Get-CsNetworkSite e Where-Object, para recuperar todos os sites que fizerem parte da região NorthAmerica. O comando começa chamando Get-CsNetworkSite sem parâmetros, para recuperar todos os sites da rede. Esta coleção de sites será canalizada para Where-Object, que filtrará a coleção, procurando todos os sites na coleção cuja propriedade NetworkRegionID for igual a (-eq) NorthAmerica.