New-CsNetworkMediaBypassConfiguration
上次修改主題的時間： 2012-03-26
為媒體旁路建立新通用設定。
語法
New-CsNetworkMediaBypassConfiguration [-AlwaysBypass <$true | $false>] [-BypassID <String>] [-Enabled <$true | $false>] [-EnableDefaultBypassID <$true | $false>] [-ExternalBypassMode <Nullable>] [-InternalBypassMode <Nullable>]
詳細描述
這個指令程式會建立音訊連線媒體旁路的通用設定。
與 Microsoft Lync Server 2010 中的 New- 指令程式不同，這個指令程式不會立即儲存新組態，它只會在記憶體中建立設定。這個指令程式所建立的物件必須儲存到變數，然後指派至網路組態的 MediaBypassSettings 屬性 (如需更多詳細資料，請參閱本主題中的＜範例＞區段)。
使用這個指令程式所建立的設定，只能透過存取通用網路組態的 MediaBypassSettings 屬性來擷取。若要擷取這些設定，請執行此命令：(Get-CsNetworkConfiguration).MediaBypassSettings。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsNetworkMediaBypassConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsNetworkMediaBypassConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
AlwaysBypass |
選用 |
布林值 |
將此參數設為 True，將嘗試對所有通話執行媒體旁路。 只有在停用通話許可控制 (CAC) 時，才將這個參數值設為 True。僅在用於滿足下列條件的部署時，才將此參數設為 True： - 不需要頻寬控制。 - 不需要精細的組態來決定旁路的發生時機。 - 閘道和用戶端之間有完整的連線能力。 如果將 Enabled 參數設為 True 並且將 AlwaysBypass 設為 False，旁路邏輯會使用網路組態站台和地區來決定旁路的發生時機。 如果您將 AlwaysBypass 設為 True，但沒有將 Enabled 參數的值也設為 True，則會收到警告訊息：將 Enabled 設為 False 會略過 AlwaysBypass 設定。 同時將 AlwaysBypass 和 Enabled 設為 True 會自動產生旁路 ID，這個旁路 ID 會儲存在 BypassID 屬性中。 預設值：False |
BypassID |
選用 |
字串 |
媒體旁路 ID。如果將 AlwaysBypass 參數設為 True 並提供此參數的值，BypassID 將和所有子網路相關聯。如果 AlwaysBypass 為 False，BypassID 值會和所有位在網路組態站台及區域之外的子網路相關聯。 ID 的格式必須為 GUID (例如，96f14dea-5170-429a-b92b-f1cb909c4bb6)。不過您通常不需要設定或變更此參數。當 Enabled 設為 True 或下列情況下，會自動產生這個值：1) AlwaysBypass 設為 True，或 2) EnableDefaultBypassID 參數設為 True。 |
Enabled |
選用 |
布林值 |
將這個參數設為 True 以啟用媒體旁路。此時，旁路決策將取決於 AlwaysBypass 設定的值，如下所示： - 如果 AlwaysBypass 為 True，則嘗試對所有通話執行旁路。 - 如果 AlwaysBypass 為 False，則會使用網路組態站台和區域來決定執行旁路的時機。 預設值：False |
EnableDefaultBypassID |
選用 |
布林值 |
此值僅適用於當 AlwaysBypass 已設為 False 時。 將這個值設為 True 會自動產生預設旁路 ID。這個自動產生的值會儲存在 BypassID 屬性。 當連線良好的核心包含有頻寬限制連結的遠端站台時，這個參數就很有用。系統管理員只需要透過網路組態站台及區域來定義和遠端站台相關聯的子網路，而不需要定義任何和核心相關聯的子網路。系統會自動在這些子網路之間嘗試執行旁路。 預設值：False |
ExternalBypassMode |
選用 |
BypassModeEnumType |
保留供未來使用。Lync Server 2010 不支援外部媒體旁路。 預設值：Off |
InternalBypassMode |
選用 |
BypassModeEnumType |
此參數的值會控制從組織網路內部進行連線之用戶端能嘗試執行媒體旁路的時機。如果 Enabled 設為 True，這個值會自動變更為 Any。此參數的其他值已獲得保留，以供未來之用。 預設值：Off |
輸入類型
無。
傳回類型
建立 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.MediaBypassSettingsType 類型的物件參考。
範例
-------------------------- 範例 1 --------------------------
$a = New-CsNetworkMediaBypassConfiguration -AlwaysBypass $true -Enabled $true
Set-CsNetworkConfiguration -MediaBypassSettings $a
此範例中的命令可啟用媒體旁路，並設定為永遠嘗試旁路。範例的第一行會呼叫 New-CsNetworkMediaBypassConfiguration 指令程式。我們傳遞兩個參數到此指令程式：AlwaysBypass 和 Enabled，將兩者都設為 True ($true)。Enabled 設為 True 可啟用媒體旁路，AlwaysBypass 設為 True 可確保嘗試對所有通話執行媒體旁路(請注意，設定這兩個參數會自動產生 BypassID 屬性值)。New-CsNetworkMediaBypassConfiguration 只會在記憶體中建立物件，所以我們將該物件指派至變數 $a。
媒體旁路組態會與網路組態設定一起儲存。因此，在範例的第 2 行，利用呼叫 Set-CsNetworkConfiguration 指令程式，將第 1 行所建立之媒體旁路組態物件 ($a) 傳遞給 MediaBypassSettings 參數，以將媒體旁路組態變更儲存至網路組態。
-------------------------- 範例 2 --------------------------
$a = (Get-CsNetworkConfiguration).MediaBypassSettings
$a.AlwaysBypass = $false
Set-CsNetworkConfiguration -MediaBypassSettings $a
Lync Server 中沒有 Set-CsNetworkMediaBypassConfiguration 指令程式，所以為了修改現有設定，您必須建立新組態 (如範例 1 所示) 來取代現有組態，或是修改現有設定，方法是擷取現有設定加以修改，然後使用 Set-CsNetworkConfiguration 指令程式儲存變更。這個範例示範使用後者來關閉 Always Bypass 選項。
範例的第一行擷取現有的媒體旁路設定。其執行方法是呼叫 Get-CsNetworkConfiguration。在括弧內呼叫此指令程式，以確保在執行命令的所有其他部分之前，已先完成該指令程式。Get-CsNetworkConfiguration 會擷取整網路組態的所有設定。因為我們只需要媒體旁路設定，所以我們指定 MediaBypassSettings 屬性，以便只擷取那些設定。將那些設定指派至變數 $a。
在第二行中，我們利用指派 False ($false) 值至 AlwaysBypass 屬性，來修改儲存在變數 $a 的設定。最後，在第 3 行中呼叫 Set-CsNetworkConfiguration，將變數 $a 傳遞給 MediaBypassSettings 參數，來儲存我們對 AlwaysBypass 屬性所做的變更。