Set-CsMediaConfiguration
上次修改主題的時間： 2012-03-26
修改現有的媒體設定集合。
語法
Set-CsMediaConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableQoS <$true | $false>] [-EnableSiren <$true | $false>] [-EncryptionLevel <SupportEncryption | RequireEncryption | DoNotSupportEncryption>] [-Force <SwitchParameter>] [-MaxVideoRateAllowed <CIF250K | VGA600K | Hd720p15M>] [-WhatIf [<SwitchParameter>]]
Set-CsMediaConfiguration [-Confirm [<SwitchParameter>]] [-EnableQoS <$true | $false>] [-EnableSiren <$true | $false>] [-EncryptionLevel <SupportEncryption | RequireEncryption | DoNotSupportEncryption>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxVideoRateAllowed <CIF250K | VGA600K | Hd720p15M>] [-WhatIf [<SwitchParameter>]]
詳細描述
此指令程式會修改定義媒體組態的設定集合。這些動作與用戶端端點之間的音訊和視訊呼叫相關。
誰可以執行這個指令程式：根據預設，下列群組的成員經過授權，可在本機執行 Set-CsMediaConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsMediaConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
XdsIdentity |
您要變更之媒體組態設定的唯一識別碼。此識別碼會指定套用此組態的範圍 (通用、網站或服務)。 |
Instance |
選用 |
MediaSettings |
Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings 物件的執行個體。您可以呼叫 Get-CsMediaConfiguration 並指定特定 Identity 來擷取此物件。接著，您可以將新的值指派給該物件的屬性，再將物件傳遞至 Set-CsMediaConfiguration，以儲存那些變更。 |
EnableQoS |
選用 |
布林值 |
QoS 會監視網路上的語音訊號品質。 |
EnableSiren |
選用 |
布林值 |
根據預設，中繼伺服器不會為本身與其他 Microsoft Lync 2010 用戶端之間的通話協議 Siren 為可能的轉碼器。如果此設定為 True，會將 Siren 包含為可能的轉碼器，用於中繼伺服器和其他Lync 2010用戶端之間。 |
EncryptionLevel |
選用 |
EncryptionLevel |
整合通訊實體之間的加密層級。 有效值： SupportEncryption - 如果可以交涉，則使用安全即時傳輸通訊協定 (SRTP)。 RequireEncryption - 必須交涉 SRTP。 DoNotSupportEncryption - 不得使用 SRTP。 此值不區分大小寫(如需詳細資料，請參閱本主題中的範例)。 預設值：RequireEncryption |
MaxVideoRateAllowed |
選用 |
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 |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings 物件。接受媒體組態物件的管線傳送資料。
傳回類型
Set-CsMediaConfiguration 不會傳回值或物件。反之，指令程式會設定 Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Set-CsMediaConfiguration -Identity site:Redmond1 -MaxVideoRateAllowed hd720p15m
以上所示的範例會修改 Identity 為 site:Redmond1 的媒體設定集合；特別是命令會將 MaxVideoRateAllowed 屬性的值設為 Hd720p15M。請注意，傳遞給 MaxVideoRateAllowed 參數的值必須是參數描述中指定的其中一個值。也請注意，值不區分大小寫；此處輸入為 hd720p15m 的值會自動轉換成適當大小寫 (此例中會轉換成 Hd720p15M)。
-------------------------- 範例 2 --------------------------
Set-CsMediaConfiguration site:Redmond1 -EncryptionLevel donotsupportencryption
此範例會將 Identity 為 site:Redmond1 的媒體組態集合修改為 EncryptionLevel 值等於 DoNotSupportEncryption。請注意，此值不區分大小寫；輸入的值為 donotsupportencryption，但該值可視為有效值，並會自動變更為混合大小寫 (DoNotSupportEncryption)。