New-CsNetworkRegion
上次修改主題的時間： 2012-03-26
建立新的網路區域。網路區域表示企業網路中的網路集線器或骨幹。
語法
New-CsNetworkRegion -Identity <XdsGlobalRelativeIdentity> -CentralSite <String> [-AudioAlternatePath <$true | $false>] [-BWAlternatePaths <PSListModifier>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-VideoAlternatePath <$true | $false>] [-WhatIf [<SwitchParameter>]]
New-CsNetworkRegion -CentralSite <String> -NetworkRegionID <String> [-AudioAlternatePath <$true | $false>] [-BWAlternatePaths <PSListModifier>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-VideoAlternatePath <$true | $false>] [-WhatIf [<SwitchParameter>]]
詳細描述
網路區域會與跨多個地理區域的網路不同部分交互連線。每個網路區域都必須與中央網站產生關聯。中央網站是資料中心網站，通話許可控制 (CAC) 頻寬原則服務會在其上執行。使用此指令程式來建立新的網路區域。此 Cmdlet 的參數可讓您提供設定，這些設定會決定是否允許替代路徑透過網際網路進行音訊和視訊連線，以及是否可以自動產生略過識別碼。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsNetworkRegion Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsNetworkRegion"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
必要 |
Xds 通用相對識別 |
新建立之網路區域的唯一識別碼。區域只會在全域範圍建立，因此，這個識別碼不需要指定範圍。但是，它包含識別該區域之唯一名稱的字串。 |
CentralSite |
必要 |
字串 |
執行頻寬原則服務的中央網站。必須啟用此服務，才能使用 CAC。此服務在前端伺服器或 Standard Edition Server 上執行。 |
NetworkRegionID |
必要 |
字串 |
此值與 Identity 相同。您無法同時指定 Identity 和 NetworkRegionID；針對其中一個輸入的值將會自動用於兩者。 |
AudioAlternatePath |
選用 |
布林值 |
如果主要路徑中沒有足夠的頻寬，此參數會判斷是否將透過替代路徑來路由傳送音訊通話。 此參數會填入 BWAlternatePaths 屬性。提供給此參數的值會儲存在 AlternatePath 屬性，以使路徑項目取代為 Audio 的 BWPolicyModality 值。 如果為此參數提供值，便無法指定 BWAlternatePaths 參數的值。 預設值：True。只有在您需要針對網際網路關閉卸載時，才將此參數設定為 False。如果您的所有電話都是網際網路電話，此值必須設為 True，無論頻寬設定為何。 |
BWAlternatePaths |
選用 |
PS 清單修飾詞 |
物件清單，這些物件中包含媒體要求無法沿著慣用路徑完成 (例如，如果已經超出該路徑的限制) 時，是否允許替代網際網路連線路徑的相關資訊。您必須呼叫 New-CsNetworkBWAlternatePath 來建立替代路徑物件。 如果您提供此參數的值，您就無法提供 AudioAlternatePath 或 VideoAlternatePath 參數的值。 預設會啟用音訊和視訊的替代路徑 (AlternatePath = True)。 |
BypassID |
選用 |
字串 |
全域唯一識別碼 (GUID)。這個 GUID 可用來將網路區域對應至 CAC 或增強型9-1-1 (E9-1-1) 網路組態內的略過媒體設定 (對 New-CsNetworkMediaBypassConfiguration 呼叫時使用這個 BypassID 值)。 如果您不指定此參數的值，將會自動產生一個值。如果您指定一個值，則該值必須採用 GUID 的格式 (例如，3b24a047-dce6-48b2-9f20-9fbff17ed62a)。建議使用自動產生功能。如果您提供此參數的值，將會收到一個確認提示，詢問您是否確定要提供這個值，而不是讓它自動產生。 |
Description |
選用 |
字串 |
比起單獨使用 Identity 來說，此參數可用來提供更多此區域之用途的描述性說明。 |
VideoAlternatePath |
選用 |
布林值 |
此參數會決定適當的頻寬不存在於主要路徑時，是否要透過替代路徑路由傳送視訊通話。 此參數會填入 BWAlternatePaths 屬性。提供給此參數的值會儲存在 AlternatePath 屬性，以使路徑項目取代為 Video 的 BWPolicyModality 值。 如果為此參數提供值，便無法指定 BWAlternatePaths 參數的值。 預設值：True。只有在您需要針對網際網路關閉卸載時，才將此參數設定為 False。如果您的所有電話都是網際網路電話，此值必須設為 True，無論頻寬設定為何。 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。例如，如果您提供一個值給 BypassID 參數，就不會收到確認的提示。 |
InMemory |
選用 |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。
傳回類型
建立 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType 類型的物件。
範例
-------------------------- 範例 1 --------------------------
New-CsNetworkRegion -Identity NorthAmerica -Description "All North American Locations" -CentralSite Redmond-NA-MLS
在此範例中，會建立一個名稱為 NorthAmerica 的新網路區域。此區域名稱會指定為 Identity 參數的值。系統也會針對選用的 Description 參數指定一個值，將此區域描述為由「All North American Locations」所組成。最後，CentralSite 參數會收到此區域的中央網站名稱值，也就是 Redmond-NA-MLS。
-------------------------- 範例 2 --------------------------
New-CsNetworkRegion -Identity EMEA -CentralSite Dublin-EU-Site -AudioAlternatePath $False
此範例會建立一個名稱為 EMEA 的新網路區域，這個區域包含音訊替代路徑的設定。若要這樣做，我們會呼叫 New-CsNetworkRegion，以傳遞 EMEA 的 Identity。我們會指派必要參數 CentralSite 的值 (在此範例中，此區域的中央網站名稱為 Dublin-EU-Site)，然後我們會指定 AudioAlternatePath 參數，並將 $False 值傳遞給它。將 AudioAlternatePath 設為 False 表示在無法使用適當的頻寬時，不會將音訊通話路由傳送到替代路徑，而只是無法完成這些音訊通話。
-------------------------- 範例 3 --------------------------
$a = New-CsNetworkBWAlternatePath -BWPolicyModality "audio" -AlternatePath $False
New-CsNetworkRegion -Identity EMEA -CentralSite Dublin-EU-Site -BWAlternatePaths $a
此範例所建立的網路區域與在範例 2 中建立的網路區域相同。不過，在此例中，我們使用 BWAlternatePaths 參數 (而不是 AudioAlternatePath 參數) 定義替代路徑設定。範例中的第一行會呼叫 New-CsNetworkBWAlternatePath 指令程式，以建立新的替代路徑。替代路徑只有兩個屬性：BWPolicyModality (必須設為 audio 或 video，在此範例中為 audio) 和 AlternatePath (必須為 True 或 False，在此範例中為 True)。我們會將此指令程式 (剛建立之替代路徑物件的參考) 的輸出指派為變數 $a。
在此範例的第 2 行中，我們會在建立新網路區域時，使用這個新建立的替代路徑。若要這樣做，我們會呼叫 New-CsNetworkRegion，以傳遞 EMEA 的 Identity。我們會指派必要參數 CentralSite 的值 (在此範例中，此區域的中央網站名稱為 Dublin-EU-Site)，然後我們會指定 BWAlternatePaths 參數，並將包含剛建立之替代路徑物件的變數 ($a) 傳遞給它。