Get-CsNetworkSubnet
Ultima modifica dell'argomento: 2012-03-23
Recupera informazioni su una o più subnet di rete.
Sintassi
Get-CsNetworkSubnet [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkSubnet [-Filter <String>] [-LocalStore <SwitchParameter>]
Descrizione dettagliata
Ogni subnet deve essere associata a un sito di rete per la determinazione della posizione geografica dell'host appartenente alla subnet. Utilizzare questo cmdlet per recuperare informazioni sulla subnet, inclusa l'identità (ID della subnet), numero di bit di maschera, il sito di rete associato e la descrizione della subnet.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsNetworkSubnet i membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkSubnet"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
XdsGlobalRelativeIdentity |
L'ID univoco della subnet che si desidera recuperare. Questo valore è un indirizzo IP (ad esempio 174.11.12.0). |
Filter |
Facoltativo |
Stringa |
Utilizzare questo parametro per eseguire una ricerca con caratteri jolly di tutte le subnet basate sull'identità. Ad esempio, il valore Filter 172.11.* recupera tutte le subnet con identità che inizia con 172.11. (ad esempio 172.11.10.0, 172.11.25.0 e così via). |
LocalStore |
Facoltativo |
Parametro opzionale |
Recupera le informazioni relative alla subnet di rete dalla replica locale dell'archivio di gestione centrale anziché dall'archivio di gestione centrale stesso. |
Tipi di input
Nessuno.
Tipi restituiti
Restituisce uno o più oggetti di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType.
Esempio
-------------------------- Esempio 1 --------------------------
Get-CsNetworkSubnet
In questo esempio vengono recuperate tutte le subnet della distribuzione di Microsoft Lync Server 2010.
-------------------------- Esempio 2 --------------------------
Get-CsNetworkSubnet -Identity 172.11.15.0
In questo esempio vengono recuperate tutte le informazioni sulla subnet con l'identità (ID della subnet) 172.11.15.0.
-------------------------- Esempio 3 --------------------------
Get-CsNetworkSubnet -Filter 172.11.*
In questo esempio vengono recuperate tutte le subnet con identità che iniziano con 172.11.
-------------------------- Esempio 4 --------------------------
Get-CsNetworkSubnet | Where-Object {$_.NetworkSiteID -eq "Vancouver"}
Nell'esempio 4 vengono recuperate tutte le subnet associate al sito Vancouver. Viene chiamato innanzitutto il cmdlet Get-CsNetworkSubnet senza parametri. Come illustrato nell'esempio 2, in questo modo vengono recuperate tutte le subnet definite. Questa raccolta di subnet viene quindi viene inviata tramite pipe al cmdlet Where-Object. Where-Object utilizza tale raccolta e la circoscrive solo alle subnet con NetworkSiteID uguale a (-eq) Vancouver.