New-CsNetworkSubnet
上次修改主題的時間： 2012-03-27
建立新的網路子網路。
語法
New-CsNetworkSubnet -Identity <XdsGlobalRelativeIdentity> -MaskBits <Int32> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NetworkSiteID <String>] [-WhatIf [<SwitchParameter>]]
New-CsNetworkSubnet -MaskBits <Int32> -SubnetID <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NetworkSiteID <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
為了判斷屬於此子網路的主機地理位置，每一個子網路都必須與網路網站相關聯。使用此指令程式可建立新的子網路，同時 (選擇性地) 將其指派至網路網站。
在已實作通話許可控制 (CAC) 的大多數 Microsoft Lync Server 2010 部署中，通常有大量子網路。因此，通常建議呼叫 New-CsNetworkSubnet 並搭配 Windows PowerShell 指令程式 Import-CSV。您可以同時使用這兩個指令程式，一次從逗點分隔值 (CSV) 檔案讀入子網路設定並建立多個子網路。如需詳細資料，請參閱此指令程式的＜範例＞區段。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsNetworkSubnet Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsNetworkSubnet"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
必要 |
Xds 通用相對識別碼 |
要建立之子網路的唯一子網路 ID。此 ID 必須是 IP 位址 (例如 174.11.12.0)，而且必須是子網路定義之 IP 位址範圍中的第一個位址。 |
MaskBits |
必要 |
Int32 |
要套用至所建立之子網路的位元遮罩。 有效值：1 到 32 |
SubnetID |
必要 |
字串 |
這是與 Identity 相同的值。您必須指定 Identity 或 SubnetID，但不可兩者皆指定。無論您提供的是哪一個值，都將會自動套用至另一個。 |
Description |
選用 |
字串 |
要建立之子網路的描述。 |
NetworkSiteID |
選用 |
字串 |
此子網路所屬之網站的網站 ID。您可以呼叫 Get-CsNetworkSite 指令程式來擷取部署的網站識別碼。 |
Force |
選用 |
切換參數 |
抑制在進行變更前可能顯示的任何確認提示。 |
InMemory |
選用 |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。
傳回類型
建立 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType 類型的物件。
範例
-------------------------- 範例 1 --------------------------
New-CsNetworkSubnet -Identity 172.11.15.0 -MaskBits 24 -NetworkSiteID Vancouver
此範例會示範如何建立代表子網路 172.11.15.0/24 的新子網路物件。該子網路的 Identity 設為 172.11.15.0。此值會自動被指派為 SubnetID。您必須為子網路定義遮罩位元。這可以透過提供一個值給 MaskBits 參數 (在此例中為 24) 來完成。最後，此網站 ID Vancouver 會傳遞給 NetworkSiteID 參數，讓子網路與該網站產生關聯。
-------------------------- 範例 2 --------------------------
Import-CSV C:\subnet.csv | foreach {New-CsNetworkSubnet -Identity $_.Identity -MaskBits $_.Mask -NetworkSiteID $_.SiteID}
範例 2 會讀取 CSV 檔案，以建立一連串的子網路。此範例中的 CSV 檔案外觀應類似如下：
Identity, Mask, SiteID
172.11.12.0, 24, Redmond
172.11.13.0, 24, Chicago
172.11.14.0, 25, Vancouver
172.11.15.0, 31, Paris
...
此範例會從呼叫 Import-CSV 指令程式開始，並將 CSV 檔的路徑傳遞給它。此指令程式會將該檔案的內容讀入記憶體。接著，這些檔案內容會傳送到 foreach 函數。foreach 函數會一次一行、逐一查看內容。如同您可以在範例檔中看到的一樣，第一行是定義其餘內容的標題清單；foreach 函數將會使用這些標題依名稱存取逗點分隔值。
在 foreach 陳述式內，會呼叫 New-CsNetworkSubnet 指令程式。因為 foreach 會逐一查看檔案內容的每一行，因此該行會當作 New-CsNetworkSubnet 參數的值來傳遞。例如，第一次執行 foreach 陳述式時，New-CsNetworkSubnet 會建立 Identity 為 172.11.12.0 的子網路：這是在以逗點分隔值的第一行中 Identity 位置的值 ($_ 表示 foreach 迴圈中目前的值)。然後，Mask 值 (24) 會傳遞到 MaskBits 參數，而檔案中的 SiteID 值 (Redmond) 會傳遞到 NetworkSiteID 參數。
此處理序會繼續，直到讀取完檔案中的所有行，並使用其值建立新的子網路為止。