New-CsNetworkBWAlternatePath
上次修改主題的時間： 2012-03-26
建立新的設定，這些設定定義了當連線有頻寬限制時，是否可以透過網際網路將媒體轉接至替代路徑。
語法
New-CsNetworkBWAlternatePath -AlternatePath <$true | $false> -BWPolicyModality <Audio | Video>
詳細描述
Microsoft Lync Server 2010 中的通話許可控制 (CAC) 組態內有兩種可能的模式：音訊和視訊。這兩種模式都可以設定頻寬限制。當頻寬限制使得通話無法完成時，可以透過網際網路採取替代路徑，讓通話得以建立。此指令程式可讓您建立設定，定義是否可以根據模式將通話透過網際網路轉接至替代路徑。這些設定是以 CAC 組態內的個別地區為單位套用。
此指令程式不會立即儲存新建立的設定，而是將設定建立在記憶體內。若要對網路內的某個地區套用這些設定，您需要將指令程式的輸出指派給某個變數，然後使用該變數作為 New-CsNetworkRegion 或 Set-CsNetworkRegion 指令程式的 BWAlternatePaths 參數值。請注意，您可以使用 New-CsNetworkRegion 和 Set-CsNetworkRegion 指令程式的 AudioAlternatePath 與 VideoAlternatePath 參數直接套用這些設定，而無須呼叫 New-CsNetworkBWAlternatePath 來建立新的物件。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsNetworkBWAlternatePath Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsNetworkBWAlternatePath"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
AlternatePath |
必要 |
布林值 |
將參數設為 True，以在主要路徑無法提供適當的頻寬時，讓以 BWPolicyModality 參數所指定模式的媒體 (音訊或視訊) 建立的通話能夠轉接經替代路徑。 |
BWPolicyModality |
必要 |
BWPolicyModality |
套用替代路徑設定的模式。 有效值：Audio、Video 完整資料類型：Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyModality |
輸入類型
無。
傳回類型
建立 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWAlternatePathType 類型的物件。
範例
-------------------------- 範例 1 --------------------------
$a = New-CsNetworkBWAlternatePath -BWPolicyModality "audio" -AlternatePath $true
New-CsNetworkRegion -Identity NorthAmerica -CentralSite Redmond-NA-MLS -BWAlternatePaths $a
此範例會建立新的網路頻寬替代路徑，並將這些設定指派給新建立的地區。範例中的第一行會呼叫 New-CsNetworkBWAlternatePath 指令程式，以建立新的替代路徑。替代路徑只有兩個屬性：BWPolicyModality (必須設為 audio 或 video，在此範例中為 audio) 和 AlternatePath (必須為 True 或 False，在此範例中為 True)。我們會將此指令程式的輸出 (新建立之替代路徑物件的參考) 指派給變數 $a。
在此範例中的第 2 行，我們會使用新建立的替代路徑建立新的網路地區。為了執行此工作，我們會以 NorthAmerica 這個 Identity 呼叫 New-CsNetworkRegion。我們會指派必要參數 CentralSite 的值 (在此範例中，此地區的中央站台名稱為 Redmond-NA-MLS)，然後指定 BWAlternatePaths 參數，其中傳遞包含剛建立之替代路徑物件的變數 ($a)。