Set-CsNetworkSubnet
Ultima modifica dell'argomento: 2012-03-26
Consente di modificare una subnet esistente.
Sintassi
Set-CsNetworkSubnet [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-MaskBits <Int32>] [-NetworkSiteID <String>] [-WhatIf [<SwitchParameter>]]
Set-CsNetworkSubnet [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaskBits <Int32>] [-NetworkSiteID <String>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Ciascuna subnet deve essere associata ad un sito di rete per stabilire la località geografica dell'host che appartiene a questa subnet. Utilizzare questo cmdlet per modificare il sito di rete associato alla subnet, la sua descrizione o la maschera di bit.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Set-CsNetworkSubnet può essere utilizzato localmente dai membri dei seguenti gruppi: 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 "Set-CsNetworkSubnet"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
XdsGlobalRelativeIdentity |
L'ID univoco della subnet da modificare. Questo valore può essere un indirizzo IP (ad esempio, 174.11.12.0) o un indirizzo URL che inizia con http: o https:. |
Instance |
Facoltativo |
Tipo subnet |
Un riferimento all'oggetto subnet di rete da modificare. Questo oggetto deve essere di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType e può essere recuperato utilizzando il cmdlet Get-CsNetworkSubnet. |
Description |
Facoltativo |
Stringa |
Una descrizione della subnet da modificare. |
MaskBits |
Facoltativo |
Int32 |
La maschera di bit da applicare alla subnet. |
NetworkSiteID |
Facoltativo |
Stringa |
L'ID del sito di rete a cui applicare la subnet. È possibile ottenere gli ID dei siti per la propria distribuzione utilizzando il cmdlet Get-CsNetworkSite. |
Force |
Facoltativo |
Parametro opzionale |
Consente di evitare la visualizzazione delle richieste di conferma che altrimenti verrebbero visualizzate prima che vengano apportate 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. Accetta input tramite pipeline da oggetti subnet.
Tipi restituiti
Questo cmdlet non restituisce un valore. Consente di modificare un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType.
Esempio
-------------------------- Esempio 1 --------------------------
Set-CsNetworkSubnet -Identity 172.11.15.0 -MaskBits 25 -NetworkSiteID Chicago
In questo esempio viene modificata la subnet con Identity (ID subnet) 172.11.15.0. Alla subnet viene applicato un nuovo valore MaskBits (25) e un nuovo NetworkSiteID (Chicago).
-------------------------- Esempio 2 --------------------------
Get-CsNetworkSubnet | Where-Object {$_.NetworkSiteID -eq "Vancouver"} | Set-CsNetworkSubnet -NetworkSiteID Chicago
Nell'Esempio 2, tutte le subnet del sito Vancouver vengono spostate nel sito Chicago. Per ottenere questo risultato, il comando utilizza il cmdlet Get-CsNetworkSubnet. In questo modo, si otterrà 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 esamina la raccolta e seleziona solo quelle subnet in cui NetworkSiteID è uguale a (-eq) Vancouver. Ora che comprende solo le subnet associate al sito Vancouver, la raccolta viene inviata tramite pipe al cmdlet Set-CsNetworkSubnet. Viene specificato un parametro per il cmdlet Set-CsNetworkSubnet: NetworkSiteID. Se si specifica Chicago come valore del parametro, il cmdlet Set-CsNetworkSubnet cambierà l'ID del sito di rete di ogni membro della raccolta impostandolo su Chicago.