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 コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsMediaConfiguration"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
XdsIdentity |
変更するメディア構成設定の一意の識別子です。この識別子によって、この構成を適用するスコープ (グローバル、サイト、またはサービス) を指定します。 |
Instance |
省略可能 |
MediaSettings |
Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings オブジェクトのインスタンスです。特定の Identity で Get-CsMediaConfiguration を呼び出すことで、このオブジェクトを取得できます。次にオブジェクトのプロパティに新しい値を割り当て、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-解像度が 640 x 480、25 fps、縦横比が 4:3 の VGA です。 CIF250K-15 fps で解像度が 352 x 288 の Common Intermediate Format (CIF) ビデオ形式です。 これらの値では大文字と小文字が区別されないので注意してください。構成の作成時に、値が適切な文字種に変換されます (詳細については、このトピックの例を参照してください)。 既定値は次のとおりです。VGA600K |
Force |
省略可能 |
SwitchParameter |
変更を行う前に表示されるように設定されているすべての確認メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings オブジェクト。パイプライン処理されたメディア構成オブジェクトの入力を受け入れます。
戻り値の種類
Set-CsMediaConfiguration を実行しても値やオブジェクトが戻されることはありません。代わりに、このコマンドレットは、Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings オブジェクトのインスタンスを構成します。
例
-------------------------- 例 1 --------------------------
Set-CsMediaConfiguration -Identity site:Redmond1 -MaxVideoRateAllowed hd720p15m
上記の例では、site:Redmond1 という Identity を持つメディア構成コレクションを変更します。ここでは特に、MaxVideoRateAllowed プロパティを Hd720p15M に設定しています。MaxVideoRateAllowed パラメーターに渡される値は、パラメーターの説明で指定した値のうちの 1 つであることに注意してください。また、この値では大文字と小文字が区別されず、hd720p15m と入力すると、自動的に適切な文字種 (この例の場合は Hd720p15M) に変換されることにも注意してください。
-------------------------- 例 2 --------------------------
Set-CsMediaConfiguration site:Redmond1 -EncryptionLevel donotsupportencryption
この例では、site:Redmond1 という Identity を持つメディア構成コレクションが DoNotSupportEncryption の EncryptionLevel 値を持つよう変更しています。この値は大文字と小文字の区別なく donotsupportencryption と入力されていますが、有効な値として許可され、自動的に大文字と小文字を組み合わせた値 (DoNotSupportEncryption) に変換されることに注意してください。