Remove-CsNetworkSubnet
Ultima modifica dell'argomento: 2012-03-27
Rimuove una subnet di rete esistente.
Sintassi
Remove-CsNetworkSubnet -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Ogni subnet deve essere associata a un sito di rete allo scopo di determinare la posizione geografica dell'host appartenente alla subnet. Utilizzare questo cmdlet per rimuovere una subnet di rete.
Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Remove-CsNetworkSubnet in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsNetworkSubnet"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
XdsGlobalRelativeIdentity |
Identificatore univoco della subnet da rimuovere. Questo valore è un indirizzo IP (ad esempio 174.11.12.0). |
Force |
Facoltativo |
Parametro opzionale |
Elimina qualsiasi richiesta di conferma che, in caso contrario, sarebbe visualizzata prima di effettuare le modifiche. |
WhatIf |
Facoltativo |
Parametro opzionale |
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente. |
Confirm |
Facoltativo |
Parametro opzionale |
Viene visualizzata una richiesta di conferma prima di eseguire il comando. |
Tipi di input
Oggetto Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType. Consente di accettare l'input da pipeline di oggetti subnet di rete.
Tipi restituiti
Questo cmdlet non restituisce un valore. Consente di rimuovere un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType.
Esempio
-------------------------- Esempio 1 --------------------------
Remove-CsNetworkSubnet -Identity 172.11.15.0
Con questo esempio viene rimossa la subnet con identità (ID di subnet) 172.11.15.0.
-------------------------- Esempio 2 --------------------------
Get-CsNetworkSubnet | Where-Object {$_.NetworkSiteID -eq "Vancouver"} | Remove-CsNetworkSubnet
Con l'esempio 2 vengono rimosse tutte le subnet associate al sito Vancouver. Per ottenere questo risultato, il comando utilizza per primo il cmdlet Get-CsNetworkSubnet. Questo cmdlet recupera una raccolta di tutte le subnet definite nella distribuzione di Microsoft Lync Server 2010. Questa raccolta di subnet viene quindi inviata tramite pipe al cmdlet Where-Object. Where-Object recupera la raccolta e la circoscrive alle subnet con NetworkSiteID uguale a (-eq) Vancouver. Ora che la raccolta è costituita solamente dalle subnet associate al sito Vancouver, è possibile inviare la raccolta tramite pipe a Remove-CsNetworkSubnet, che rimuove ogni elemento nella raccolta.