Set-CsAVEdgeConfiguration
トピックの最終更新日: 2012-03-26
音声ビデオ エッジ サービス が稼働中のコンピューター (音声ビデオ エッジ サーバー) の構成設定を変更できます。音声ビデオ エッジ サーバーを使用すると、内部ユーザーは音声およびビデオのデータを外部ユーザー (内部ネットワークにログオンしていないユーザー) と共有できるほか、ファイルを交換したりデスクトップの共有セッションに参加することができます。
構文
Set-CsAVEdgeConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-MaxBandwidthPerPortKb <UInt32>] [-MaxBandwidthPerUserKb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-WhatIf [<SwitchParameter>]]
Set-CsAVEdgeConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxBandwidthPerPortKb <UInt32>] [-MaxBandwidthPerUserKb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-WhatIf [<SwitchParameter>]]
解説
音声ビデオ エッジ サーバーにより、音声およびビデオのトラフィックを組織のファイアウォールを超えて交換する方法が提供されます。特に、これによりユーザーがインターネットを使用して Microsoft Lync Server 2010 を使用できるようになり、ファイアウォールの内側からシステムにログオンしているユーザーと、音声およびビデオのデータを交換できるようになります。エッジ サーバー 構成設定は、グローバル スコープ、サイト スコープ、およびサービス スコープで割り当てることができます。これらの構成設定を使用すると、管理者が、ユーザー認証の更新が必要になるまでにこれを有効とする期間を管理したり、1 ユーザーまたは 1 ポートで使用できる帯域幅の量を制限したりできます。
Set-CsAVEdgeConfiguration コマンドレットを使用すると、組織で現在使用中の音声ビデオ エッジ構成設定を変更できます。ただし、Microsoft サポート担当者に指示されない限り、管理者は、既定の音声ビデオ設定を変更しないことをお勧めします。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが Set-CsAVEdgeConfiguration コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsAVEdgeConfiguration"}
パラメーター
パラメーター | 必須かどうか | 型 | 説明 |
---|---|---|---|
Identity |
省略可能 |
Xds Identity |
変更する音声ビデオ エッジ構成設定コレクションの一意の識別子。グローバル コレクションを変更するには、次の構文を使用します: -Identity global。サイト コレクションを変更するには、次のような構文を使用します: -Identity site:Redmond。サービス スコープで構成される設定は、次のような構文を使用して参照する必要があります: -Identity service:EdgeServer:atl-cs-001.litwareinc.com |
Instance |
省略可能 |
MediaRelaySettings オブジェクト |
個々のパラメーター値を設定するのではなく、オブジェクトへの参照をコマンドレットに渡せるようにします。 |
MaxBandwidthPerPortKB |
省略可能 |
整数 |
1 ポートに割り当てられる帯域幅の最大値 (Kbps) を指定します。最大帯域幅は、1 秒あたり 1 から 4294967296 (4096 ギガビット) の間のいずれかの整数値に指定できます。既定値は 3000 です。 |
MaxBandwidthPerUserKB |
省略可能 |
整数 |
1 ユーザーに割り当てられる帯域幅の最大値 (Kbps) を指定します。最大帯域幅は、1 秒あたり 1 から 4294967296 (4096 ギガビット) の間のいずれかの整数値に指定できます。既定値は 10000 です。 |
MaxTokenLifetime |
省略可能 |
TimeSpan |
認証トークンの期限が切れ更新の必要が生じる前に、これを使用できる最大時間。トークンの存続時間は次の形式を使用して表します: Days.Hours:Minutes:Secondsたとえば 13 日間は、日数に続けてピリオド (.) を付け、時、分、秒の区切りにコロン (:) を使用して次のように表します。 13.00:00:00 既定値である 8 時間は、次のように表す必要があります。 08:00:00 トークンの存続時間に設定できる最小値は 1 分間 (00:01:00)、最大値は 180 日間 (180.00:00:00) です。 |
Force |
省略可能 |
スイッチ パラメーター |
コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
スイッチ パラメーター |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
スイッチ パラメーター |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings オブジェクト。Set-CsAVEdgeConfiguration は、パイプライン処理されたメディア リレー 設定オブジェクトの入力を受け入れます。
戻り値の種類
Set-CsAVEdgeConfiguration は、値またはオブジェクトを戻しません。代わりに、このコマンドレットは、Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings オブジェクトのインスタンスを構成します。
例
-------------------------- 例 1 ------------------------
Set-CsAVEdgeConfiguration -Identity global -MaxTokenLifetime "04:00:00"
例 1 のコマンドでは、グローバル音声ビデオ エッジ構成設定の MaxTokenLifetime プロパティが変更されます。この例では、最大トークン存続時間は 4 時間に設定されています (04 時間:00 分: 00 秒)。