Get-CsNetworkRegion
Ultima modifica dell'argomento: 2012-03-23
Consente di recuperare una o più regioni di rete. Le regioni di rete rappresentano hub di rete o backbone in una rete aziendale.
Sintassi
Get-CsNetworkRegion [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkRegion [-Filter <String>] [-LocalStore <SwitchParameter>]
Descrizione dettagliata
Una regione di rete crea una connessione tra diverse parti di una rete in più aree geografiche. Ciascuna regione di rete deve essere associata a un sito centrale. Utilizzare questo cmdlet per recuperare le informazioni su una o più regioni di rete, incluse le impostazioni e l'elemento sito centrale associato che determinano se sono consentiti percorsi alternativi per le connessioni audio e video e che associano i siti nella regione a una configurazione di bypass degli elementi multimediali.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsNetworkRegion può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkRegion"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
XdsGlobalRelativeIdentity |
L'identificatore univoco della regione di rete che si desidera recuperare. L'identità sarà nella forma di una stringa che identifica in modo univoco quella regione. Si noti che l'identità è la stessa di NetworkRegionID. |
Filter |
Facoltativo |
Stringa |
Questo parametro consente di effettuare una ricerca con caratteri jolly sulle identità di tutte le regioni di rete configurate nell'organizzazione. Utilizzare i caratteri jolly filtrare qualsiasi parte dell'identità. |
LocalStore |
Facoltativo |
Parametro opzionale |
Consente di recuperare le informazioni sulla regione di rete dalla replica locale di archivio di gestione centrale invece che da archivio di gestione centrale. |
Tipi di input
Nessuno.
Tipi restituiti
Consente di recuperare uno o più oggetti di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType.
Esempio
-------------------------- Esempio 1 --------------------------
Get-CsNetworkRegion
L'Esempio 1 recupera tutte le regioni di rete definite nell'organizzazione.
-------------------------- Esempio 2 --------------------------
Get-CsNetworkRegion -Identity NorthAmerica
L'Esempio 2 recupera tutte le regioni di rete con identità NorthAmerica. Poiché le identità sono univoche, questo comando recupera al massimo una regione di rete.
-------------------------- Esempio 3 --------------------------
Get-CsNetworkRegion -Filter *America
Questo esempio consente di recuperare tutte le aree di rete la cui identità termina con la stringa "America". Verranno recuperate regioni con identità come NorthAmerica, SouthAmerica e CentralAmerica.
-------------------------- Esempio 4 --------------------------
Get-CsNetworkRegion | Where-Object {$_.CentralSite -eq "site:Redmond"}
In questo esempio vengono recuperate tutte le regioni di rete associate a sito centrale Redmond. Innanzitutto, il comando utilizza il cmdlet Get-CsNetworkRegion senza alcun parametro per recuperare una raccolta di tutte le regioni di rete definite per una distribuzione di Microsoft Lync Server 2010. Questa raccolta viene quindi inviata tramite pipe al cmdlet Where-Object. Where-Object filtra questa raccolta e restituisce solo gli elementi (regioni di rete) nei quali il valore CentralSite è uguale a (-eq) site:Redmond.