Set-CsNetworkSubnet
上次修改主題的時間： 2012-03-26
修改現有的網路子網路。
語法
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>]]
詳細描述
為了判斷屬於此子網路的主機地理位置，每一個子網路都必須與網路站台相關聯。使用此指令程式可修改相關聯的網路網站、變更子網路的描述，或是修改子網路的遮罩位元。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsNetworkSubnet Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsNetworkSubnet"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
Xds 通用相對識別碼 |
要修改之子網路的唯一子網路 ID。此值必須是 IP 位址 (例如 174.11.12.0) 或以 http: 或 https: 開頭的 URL。 |
Instance |
選用 |
子網路類型 |
要修改之網路子網路物件的參考。此物件的類型必須是 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType，可透過呼叫 Get-CsNetworkSubnet 來擷取。 |
Description |
選用 |
字串 |
要修改之子網路的描述。 |
MaskBits |
選用 |
Int32 |
要套用至子網路的位元遮罩。 |
NetworkSiteID |
選用 |
字串 |
要套用此子網路之網站的站台識別碼。您可以呼叫 Get-CsNetworkSite 指令程式來擷取部署的站台識別碼。 |
Force |
選用 |
切換參數 |
抑制在進行變更前可能顯示的任何確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType 物件。接受網路子網路物件的管線傳送資料。
傳回類型
這個指令程式不會傳回值。它會修改 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType 類型的物件。
範例
-------------------------- 範例 1 --------------------------
Set-CsNetworkSubnet -Identity 172.11.15.0 -MaskBits 25 -NetworkSiteID Chicago
此範例會修改 Identity (子網路 ID) 為 172.11.15.0 的子網路。此子網路會修改為新的 MaskBits 值 (25) 以及新的 NetworkSiteID (Chicago)。
-------------------------- 範例 2 --------------------------
Get-CsNetworkSubnet | Where-Object {$_.NetworkSiteID -eq "Vancouver"} | Set-CsNetworkSubnet -NetworkSiteID Chicago
範例 2 會將 Vancouver 網站上的所有子網路移至 Chicago 網站。若要這樣做，我們可以從呼叫 Get-CsNetworkSubnet 指令程式開始。這樣會擷取 Microsoft Lync Server 2010 部署中定義之所有子網路的集合。接著，子網路的這個集合會傳送到 Where-Object指令程式。Where-Object 採用該集合並縮小範圍至只有 NetworkSiteID 等於 (-eq) Vancouver 的子網路。既然此集合僅由與 Vancouver 站台的子網路所組成，因此我們將該集合傳送到 Set-CsNetworkSubnet。我們為 Set-CsNetworkSubnet 提供一個參數：NetworkSiteID。透過將 Chicago 的值傳遞給參數，我們指示 Set-CsNetworkSubnet 將集合中每個成員的網路站台識別碼變更為 Chicago。