Set-CsBandwidthPolicyServiceConfiguration
トピックの最終更新日: 2012-03-27
既存の帯域幅ポリシー サービス構成を変更します。
構文
Set-CsBandwidthPolicyServiceConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableLogging <$true | $false>] [-Force <SwitchParameter>] [-LogCleanUpInterval <TimeSpan>] [-MaxLogFileSizeMb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-WhatIf [<SwitchParameter>]]
Set-CsBandwidthPolicyServiceConfiguration [-Confirm [<SwitchParameter>]] [-EnableLogging <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LogCleanUpInterval <TimeSpan>] [-MaxLogFileSizeMb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-WhatIf [<SwitchParameter>]]
解説
通話受付管理 (CAC) を使用すると、音声またはビデオ通話などのリアルタイムの通信セッションを、帯域幅上の制約に基づいて確立できるかどうかを決定できます。Microsoft Lync Server 2010 の CAC 実装内では、地域、サイト、およびサブネット間の帯域幅上の制約を設定するために、これらのエンティティはエンティティ間の関係およびリンクとともにネットワーク内で定義されます。帯域幅ポリシー サービスは Lync Server 2010 の展開内で CAC 機能を実行するコンポーネントで、これにより通話を確立するための十分な帯域幅が存在するかどうかを判断できます。このコマンドレットは、既存の帯域幅ポリシー サービス構成を変更します。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが Set-CsBandwidthPolicyServiceConfiguration コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsBandwidthPolicyServiceConfiguration"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
XdsIdentity |
変更する構成の一意の識別子。この識別子は、スコープ (グローバル構成の場合) またはスコープと名前 ("site:Redmond" など、サイトレベル構成の場合) からなります。 |
Instance |
省略可能 |
BandwidthPolicyServiceConfiguration |
帯域幅ポリシー サービス構成オブジェクトへの参照。このオブジェクトは BandwidthPolicyServiceConfiguration 型である必要があります。これは Get-CsBandwidthPolicyServiceConfiguration コマンドレットを呼び出すと取得できます。 |
EnableLogging |
省略可能 |
ブール値 |
このパラメーターを True に設定すると、帯域幅ポリシー サービスに関連する CAC エラーとリンク ステータスのログが生成されます。 |
LogCleanUpInterval |
省略可能 |
TimeSpan |
CAC エラーとリンク ステータス ログが削除されるまでの期間。 この値は 1 ～ 60 日の範囲にする必要があります。値は、dd.hh:mm:ss の形式で入力する必要があります。ここで、h は時間、m は分、s は秒を表します。たとえば、20 日間の場合は 20.00:00:00 になります。 |
MaxLogFileSizeMb |
省略可能 |
UInt32 |
ログ ファイルに許可された最大サイズ。このパラメーターの値は正の数である必要があり、ファイル サイズをメガバイト単位で指定します。たとえば、ログ ファイルに許可する最大サイズを 10 メガバイトにする場合は、値 10 を入力します。 |
MaxTokenLifetime |
省略可能 |
TimeSpan |
帯域幅ポリシー認証サービスが発行したトークンの最大生存時間量。 この値は 1 ～ 24 時間の範囲にする必要があります。値は、dd.hh:mm:ss の形式で入力する必要があります。ここで、h は時間、m は分、s は秒を表します。たとえば、12 時間の値の場合は 12:00:00 になります。 |
Force |
省略可能 |
SwitchParameter |
変更を行う前に表示されるように設定されているすべての確認メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Settings.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration オブジェクト。帯域幅ポリシー サービス構成オブジェクトのパイプライン処理された入力を受け入れます。
戻り値の種類
このコマンドレットには戻り値はありません。Microsoft.Rtc.Management.WritableConfig.Settings.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration 型のオブジェクトを変更します。
例
-------------------------- 例 1 --------------------------
Set-CsBandwidthPolicyServiceConfiguration -Identity site:Redmond -EnableLogging $true -MaxTokenLifetime 3:00:00 -LogCleanUpInterval 5.00:00:00
この例では、サイト Redmond (-Identity site:Redmond) で構成された帯域幅ポリシー サービスを変更します。ログの記録を有効にし、トークンの最大生存時間を 3 時間に変更し、ログのクリーンアップを実行するまでの日数を 5 日間に変更するという変更を構成で行います。これらすべてが 1 つのコマンドで完了します。ログの記録を有効にするには、EnableLogging パラメーターを True ($true) に設定します。次に、MaxTokenLifetime パラメーターに、3 時間を表す値 3:00:00 を指定します。最後に、LogCleanUpInterval パラメーターに、5 日間を表す値 5.00:00:00 を指定します。