New-CsMediaConfiguration
上次修改主題的時間： 2012-03-26
建立新的媒體設定集合。這些設定可用來指定支援的加密層級和允許的最高視訊解析度等項目。
語法
New-CsMediaConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-EnableQoS <$true | $false>] [-EnableSiren <$true | $false>] [-EncryptionLevel <SupportEncryption | RequireEncryption | DoNotSupportEncryption>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxVideoRateAllowed <CIF250K | VGA600K | Hd720p15M>] [-WhatIf [<SwitchParameter>]]
詳細描述
此指令程式會建立針對特定媒體動作定義行為的新設定集合。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsMediaConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsMediaConfiguration"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
必要 |
Xds 識別 |
指定套用此組態之範圍 (網站或服務) 的唯一識別碼。網站範圍的組態應輸入為 site:<網站名稱>，例如 site:Redmond。服務應輸入為 <伺服器角色>:<fqdn>，例如 MediationServer:pool0.litwareinc.com。在通用範圍內應永遠存在媒體組態，而且不能移除，因此無法建立新的通用組態。 在服務範圍內建立的媒體組態只能針對音訊/視訊會議服務、中繼伺服器及應用程式伺服器建立。 |
EnableQoS |
選用 |
布林值 |
QoS 會監視網路上的語音訊號品質。 預設值：False |
EnableSiren |
選用 |
布林值 |
根據預設，中繼伺服器不會為本身與其他 Microsoft Lync 2010 用戶端之間的通話協議 Siren 為可能的轉碼器。如果此設定為 True，會將 Siren 包含為可能的轉碼器，用於中繼伺服器和其他Lync 2010用戶端之間。 預設值：False |
EncryptionLevel |
選用 |
加密層級 |
整合通訊實體之間的加密層級。 有效值： SupportEncryption - 如果可以交涉，則使用安全即時傳輸通訊協定 (SRTP)。 RequireEncryption - 必須交涉 SRTP。 DoNotSupportEncryption - 不得使用 SRTP。 預設值：RequireEncryption |
MaxVideoRateAllowed |
選用 |
允許的最高視訊速率 |
用戶端端點上傳送視訊訊號的最高速率。 有效值：Hd720p15M、VGA600K、CIF250K Hd720p15M - 高畫質，解析度為 1280 x 720，長寬比為 16:9。 VGA600K - VGA，解析度為 640 x 480，25 fps，長寬比為 4:3。 CIF250K - Common Intermediate Format (CIF) 視訊格式，15 fps，解析度為 352 x 288。 請注意，這些值不區分大小寫；在建立組態時，值會轉換為適當大小寫。 預設值：VGA600K |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
InMemory |
選用 |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。
傳回類型
建立 Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings 類型的物件。
範例
-------------------------- 範例 1 --------------------------
New-CsMediaConfiguration -Identity site:Redmond1 -EncryptionLevel RequireEncryption
範例 1 使用 New-CsMediaConfiguration 來建立 Identity 為 site:Redmond1 的新媒體組態。此新組態要求參與多媒體交談的雙方都使用加密。該需求是經由新增 EncryptionLevel 參數並將參數值設為 RequireEncryption 而建立。
-------------------------- 範例 2 --------------------------
New-CsMediaConfiguration -Identity MediationServer:pool0.litwareinc.com -EnableSiren $True
此範例會使用 New-CsMediaConfiguration 建立 Identity 為 MediationServer:pool0.litwareinc.com 的新媒體組態。這個新組態的 EnableSiren 值為 True，表示已針對與此中繼伺服器相關的電話啟用 Siren。