Remove-CsNetworkRegion
上次修改主題的時間： 2012-03-25
移除現有網路區域。網路區域代表企業網路中的網路集線器或骨幹。
語法
Remove-CsNetworkRegion -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
網路區域會與跨多個地理區域的網路不同部分交互連線。每個網路區域都必須與中央網站產生關聯。中央網站 是執行頻寬原則服務所在的資料中心站台。使用此指令程式可移除網路區域。
請注意，如果網路區域與某個站台相關聯 (亦即有任何站台的 NetworkRegionID 等於該區域的 Identity)，則無法移除該網路區域。如果您嘗試移除與站台相關聯的區域，則會收到錯誤訊息。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Remove-CsNetworkRegion Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsNetworkRegion"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
XdsGlobalRelativeIdentity |
要移除之網路區域的唯一識別碼。Identity 的格式是可唯一識別該區域的字串。 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType 物件。接受網路區域物件的管線傳送資料。
傳回類型
這個指令程式不會傳回值。它會移除 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType 類型的物件。
範例
-------------------------- 範例 1 --------------------------
Remove-CsNetworkRegion -Identity NorthAmerica
範例 1 會移除 Identity 為 NorthAmerica 的網路區域。因為識別是唯一的，所以此命令只會移除一個網路區域。
-------------------------- 範例 2 --------------------------
Get-CsNetworkRegion | Where-Object {$_.CentralSite -eq "site:Redmond"} | Remove-CsNetworkRegion
此範例會移除與 中央網站 Redmond 相關聯的所有網路區域。命令一開始會先呼叫不含參數的 Get-CsNetworkRegion 指令程式，以擷取為 Microsoft Lync Server 2010 部署定義的所有網路區域集合。此集合會被傳送到 Where-Object 指令程式。Where-Object 會先篩選此集合，僅傳回 CentralSite 值等於 (-eq) Redmond 的項目 (網路區域)。將集合範圍縮小到那些項目後，會將這個新集合傳送到 Remove-CsNetworkRegion，這會移除該集合中的每一個項目。
-------------------------- 範例 3 --------------------------
Get-CsNetworkSite | Where-Object {$_.NetworkRegionID -eq "NorthAmerica"} | Set-CsNetworkSite -NetworkRegionID $null -BypassID $null
Remove-CsNetworkRegion -Identity "NorthAmerica"
這個範例會移除 Identity 為 NorthAmerica 的網路區域。但是如果區域與某個站台相關聯時，則無法移除該區域。所以此範例會先移除 NorthAmerica 區域與站台之間的任何關聯。
範例一開始先呼叫不含參數的 Get-CsNetworkSite 指令程式，以擷取為 Lync Server 部署定義的所有網路站台集合。此集合會被傳送到 Where-Object 指令程式。Where-Object 會先篩選此集合，僅傳回 NetworkRegionID 值等於 (-eq) NorthAmerica 的項目 (網路站台)。將集合範圍縮小到那些項目後，便將這個新集合傳送到 Set-CsNetworkSite。針對每個 NetworkRegionID 為 NorthAmerica 的站台，我們會將 NetworkRegionID 設為 Null ($null)。這會移除對該站台的區域參考。但是，如果旁路 ID 未與站台相關聯，站台便無法擁有旁路 ID。所以除了透過將 NetworkRegionID 設為 Null 來移除該區域的參考外，我們還必須將 BypassID 設為 Null 來移除旁路關聯。
第一行完成後，任何與 NorthAmerica 區域關聯的網站便不再繫結至區域或任何旁路設定。此時我們可呼叫第二行來移除網路區域。