Remove-CsNetworkRegion
Ultima modifica dell'argomento: 2012-03-25
Rimuove una regione di rete esistente. Le regioni di rete rappresentano hub o backbone di rete in una rete dell'organizzazione.
Sintassi
Remove-CsNetworkRegion -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Una regione di rete collega diverse parti di una rete attraverso molteplici aree geografiche. Ogni regione di rete deve essere associata a un sito centrale. Il sito centrale è il sito del data center su cui è in esecuzione il servizio dei criteri di larghezza di banda. Utilizzare questo cmdlet per rimuovere una regione di rete.
Non è possibile rimuovere una regione di rete se è associata a un sito di rete (vale a dire se il NetworkRegionID di un sito è uguale all'identità della regione). Se si tenta di rimuovere una regione associata a un sito viene visualizzato un messaggio di errore.
Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Remove-CsNetworkRegion 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-CsNetworkRegion"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
XdsGlobalRelativeIdentity |
L'identificatore univoco della regione di rete da rimuovere. L'identità sarà rappresentata da una stringa che identifica in modo univoco tale regione. |
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.NetworkRegionType. Consente di accettare l'input da pipeline di oggetti regione di rete.
Tipi restituiti
Questo cmdlet non restituisce un valore. Consente di rimuovere un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType.
Esempio
-------------------------- Esempio 1 --------------------------
Remove-CsNetworkRegion -Identity NorthAmerica
Con l'esempio 1 viene rimossa la regione di rete con identità NorthAmerica. Poiché le identità sono univoche, con questo comando viene rimossa una sola regione di rete.
-------------------------- Esempio 2 --------------------------
Get-CsNetworkRegion | Where-Object {$_.CentralSite -eq "site:Redmond"} | Remove-CsNetworkRegion
Con questo esempio vengono rimosse tutte le regioni di rete associate al sito centrale Redmond. Per iniziare il comando chiama il cmdlet Get-CsNetworkRegion senza alcun parametro per recuperare una raccolta di tutte le regioni di rete definite per la distribuzione di Microsoft Lync Server 2010. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object. Where-Object filtra questa raccolta per restituire solo quegli elementi (regioni di rete) in cui il valore CentralSite è uguale (-eq) a site:Redmond. Dopo aver circoscritto la raccolta a questi elementi, questa nuova raccolta viene inviata tramite pipe a Remove-CsNetworkRegion, che rimuove ogni elemento nella raccolta.
-------------------------- Esempio 3 --------------------------
Get-CsNetworkSite | Where-Object {$_.NetworkRegionID -eq "NorthAmerica"} | Set-CsNetworkSite -NetworkRegionID $null -BypassID $null
Remove-CsNetworkRegion -Identity "NorthAmerica"
Con questo esempio viene rimossa la regione di rete con identità NorthAmerica. Una regione non può però essere rimossa se è associata a un sito. Pertanto, in questo esempio per prima cosa vengono rimosse le associazioni tra la regione NorthAmerica e un sito.
Per iniziare nell'esempio viene chiamato il cmdlet Get-CsNetworkSite senza alcun parametro per recuperare una raccolta di tutti i siti di rete definiti per la distribuzione di Lync Server. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object. Where-Object filtra questa raccolta per restituire solo quegli elementi (siti di rete) in cui il valore NetworkRegionID è uguale (-eq) a NorthAmerica. Dopo aver circoscritto la raccolta a questi elementi, questa nuova raccolta viene inviata tramite pipe a Set-CsNetworkSite. Per ogni sito contenente il NetworkRegionID NorthAmerica, NetworkRegionID viene impostato su Null ($null). In questo modo viene rimosso il riferimento a quella regione in tale sito. Ad ogni modo, un sito non può disporre di un ID di bypass se non è associato a un sito. Pertanto, oltre a rimuovere il riferimento all'area impostando NetworkRegionID su Null, è necessario rimuovere anche l'associazione di bypass impostando BypassID su Null.
Una volta completata la riga 1, qualsiasi sito associato alla regione NorthAmerica non è più associato a una regione o a qualche impostazione di bypass. A questo punto è possibile chiamare la riga 2, che rimuove la regione di rete.