Set-CsNetworkConfiguration
上次修改主題的時間： 2012-03-27
修改網路組態的設定。這個指令程式最常用來啟用或停用通話許可控制 (CAC)。
語法
Set-CsNetworkConfiguration [-Identity <XdsIdentity>] [-BWPolicyProfiles <PSListModifier>] [-Confirm [<SwitchParameter>]] [-EnableBandwidthPolicyCheck <$true | $false>] [-Force <SwitchParameter>] [-InterNetworkRegionRoutes <PSListModifier>] [-InterNetworkSitePolicies <PSListModifier>] [-MediaBypassSettings <MediaBypassSettingsType>] [-NetworkRegionLinks <PSListModifier>] [-NetworkRegions <PSListModifier>] [-NetworkSites <PSListModifier>] [-Subnets <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Set-CsNetworkConfiguration [-BWPolicyProfiles <PSListModifier>] [-Confirm [<SwitchParameter>]] [-EnableBandwidthPolicyCheck <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-InterNetworkRegionRoutes <PSListModifier>] [-InterNetworkSitePolicies <PSListModifier>] [-MediaBypassSettings <MediaBypassSettingsType>] [-NetworkRegionLinks <PSListModifier>] [-NetworkRegions <PSListModifier>] [-NetworkSites <PSListModifier>] [-Subnets <PSListModifier>] [-WhatIf [<SwitchParameter>]]
詳細描述
網路組態物件含有 Microsoft Lync Server 2010 部署中整個 CAC 組態的所有設定和媒體旁路設定。您可以使用這個指令程式來修改任何部分的 CAC 組態，而如果您需要變更媒體旁路設定，那麼就必須要使用這個指令程式。不過，在修改大部分的 CAC 組態設定時，我們建議您針對特定的物件類型使用專屬的指令程式。例如，在操作網路區域時，請使用以 CsNetworkRegion 一詞結尾的指令程式，而避免使用此指令程式的 NetworkRegions 參數。
此指令程式的主要用途是啟用 (及停用) CAC，以及套用媒體旁路設定。在完成各種組態所需之元件 (例如區域、站台、子網路) 的設定後，您必須先啟用組態才能使其生效。為達成此目的，只要把 EnableBandwidthPolicyCheck 參數設為 True 即可。請記住，執行此指令程式同時將 EnableBandwidthPolicyCheck 設為 True 並無法立即啟用 CAC。因為在啟用 CAC 之前還必須進行一系列的驗證檢查，以確保各項設定均為適當的設定。設定中的任何錯誤或差異都會導致警告提示出現，並會詢問您，是否要在即使發生錯誤的情況下繼續啟用 CAC。如果選擇繼續 (按 Enter 鍵或 Y 鍵)，驗證作業便會繼續進行，並且會在發現其他問題時再次提示您。
如果您完成整個驗證作業並且在每次出現警告時選擇繼續，系統便會將 EnableBandwidthPolicyCheck 設為 True，而 CAC 也會隨著啟用。不過除非您解決各種問題，否則 CAC 很有可能會無法正常運作。如果您在驗證作業的任何階段中選擇停止驗證 (在警告提示中輸入 N)，驗證作業隨即會結束，而 EnableBandwidthPolicyCheck 將維持 False 的設定 (預設值)。
如果已將 EnableBandwidthPolicyCheck 設為 True，您便可以呼叫 Set-CsNetworkConfiguration 並將 True 值傳遞給 EnableBandwidthPolicyCheck 參數以執行驗證而不修改任何設定。此外，當 EnableBandwidthPolicyCheck 為 True 時，任何藉由呼叫 Set-CsNetworkConfiguration 來進行的變更嘗試都會使驗證檢查再次執行。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsNetworkConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsNetworkConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
XdsIdentity |
這個值一律是 Global。 |
Instance |
選用 |
NetworkConfigurationSettings |
網路組態物件的參考。這個物件必須屬於 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkConfigurationSettings 類型 (可藉由呼叫 Get-CsNetworkConfiguration 指令程式擷取)。 |
BWPolicyProfiles |
選用 |
PSListModifier |
所有可指派給站台、站台間原則及網路區域連結之頻寬原則設定檔的集合。每個頻寬原則設定檔都含有針對音訊和/或視訊連線的頻寬限制 (整體限制和工作階段限制)。完整的頻寬原則設定檔清單可藉由呼叫 Get-CsNetworkBandwidthPolicyProfile 指令程式來加以擷取。 |
EnableBandwidthPolicyCheck |
選用 |
布林值 |
將此參數設為 True 可執行整個 CAC 組態的驗證檢查。如果您通過所有驗證檢查或選擇忽略所有警告，CAC 便會啟用。如果您未通過任一項驗證檢查或選擇停止驗證，EnableBandwidthPolicyCheck 的值將不會變更。 將這個值設為 False 會停用 CAC。 預設值：False |
InterNetworkRegionRoutes |
選用 |
PSListModifier |
所有在 CAC 組態中定義之網路區域路由的集合。您可以呼叫 Get-CsNetworkInterRegionRoute 指令程式來擷取這個集合的所有成員。 |
InterNetworkSitePolicies |
選用 |
PSListModifier |
在 CAC 組態中定義之網路站台間原則的集合。您可以呼叫 Get-CsNetworkInterSitePolicy 指令程式來擷取這個集合的所有成員。 |
MediaBypassSettings |
選用 |
MediaBypassSettingsType |
一項物件參考，可定義 CAC 組態的通用媒體旁路設定。這個值的設定會覆寫所有現有的媒體旁路設定。您可以藉由呼叫 New-CsNetworkMediaBypassConfiguration 指令程式來取得此物件參考，並將新的組態設定指派給變數。接著再將這個變數傳遞給 MediaBypassSettings 參數以變更通用媒體旁路設定。 |
NetworkRegionLinks |
選用 |
PSListModifier |
在 CAC 組態中定義之網路區域連結的集合。每個網路區域連結都可定義兩個區域間的連線，以及任何應套用至這些區域間連線的頻寬限制。您可以呼叫 Get-CsNetworkRegionLink 指令程式來擷取這個集合的所有成員。 |
NetworkRegions |
選用 |
PSListModifier |
在 CAC 組態中定義的網路區域集合 (每個網路區域在網路中都代表一個中樞或骨幹)。您可以呼叫 Get-CsNetworkRegion 指令程式來擷取這個集合的所有成員。 |
NetworkSites |
選用 |
PSListModifier |
在 CAC 組態中定義的網路站台集合 (每個網路站台在區域中都代表一間辦公室或一個位置)。您可以呼叫 Get-CsNetworkSite 指令程式來擷取這個集合的所有成員。 |
Subnets |
選用 |
PSListModifier |
在 CAC 組態中定義的子網路集合 (每個子網路都和站台中的某個端點相關聯)。您可以呼叫 Get-CsNetworkSubnet 指令程式來擷取這個集合的所有成員。 |
Force |
選用 |
切換參數 |
這個參數不取用任何值。如果您納入這個參數，任何為組態所做的變更 (包括啟用組態) 都會在未顯示警告或未執行驗證檢查的情況下生效。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkConfigurationSettings 物件。接受網路組態物件管線傳送的輸入。
傳回類型
Set-CsNetworkConfiguration 不會傳回值或物件。而是此指令程式會修改 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkConfigurationSettings 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Set-CsNetworkConfiguration -EnableBandwidthPolicyCheck $True
此範例中的命令會執行整個 CAC 組態的驗證檢查，接著再啟用 CAC (視您對傳回之警告提示的回應而定)。如果 CAC 已啟用 (亦即，如果 EnableBandwidthPolicyCheck 屬性為 True)，執行此命令僅會執行驗證檢查。