Set-CsQoEConfiguration
トピックの最終更新日: 2012-03-26
QoE (Quality of Experience) 設定の既存のコレクションを変更します。
構文
Set-CsQoEConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableExternalConsumer <$true | $false>] [-EnablePurging <$true | $false>] [-EnableQoE <$true | $false>] [-ExternalConsumerIssuedCertId <IssuedCertId>] [-ExternalConsumerName <String>] [-ExternalConsumerURL <String>] [-Force <SwitchParameter>] [-KeepQoEDataForDays <UInt32>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]
Set-CsQoEConfiguration [-Confirm [<SwitchParameter>]] [-EnableExternalConsumer <$true | $false>] [-EnablePurging <$true | $false>] [-EnableQoE <$true | $false>] [-ExternalConsumerIssuedCertId <IssuedCertId>] [-ExternalConsumerName <String>] [-ExternalConsumerURL <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-KeepQoEDataForDays <UInt32>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]
解説
QoE 指標では、失われたネットワーク パケット数、背景ノイズ、"ジッター" (パケット遅延の差分) 量など、組織で行われる音声通話とビデオ通話の品質を追跡します。これらの指標は、他のデータ (詳細な通話の記録など) とは別にデータベースに格納されます。このため、QoE は他のデータ記録と関係なく有効および無効にすることができます。このコマンドレットを使用して、グローバル レベルまたはサイト レベルで QoE を構成する設定を変更します。
QoE は 監視サーバー の役割の一部です。したがって、QoE 記録を有効にする前または QoE データを収集する前に、Microsoft Lync Server 2010 インストールに 監視サーバー を展開する必要があります。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、Set-CsQoEConfiguration コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsQoEConfiguration"}
パラメーター
パラメーター | 必須かどうか | 型 | 説明 |
---|---|---|---|
Identity |
省略可能 |
XdsIdentity |
変更する設定の一意の識別子。有効な値は global および site:<サイト名> です。<サイト名> は、変更を適用する Lync Server 2010 展開内のサイトの名前を表します。 |
Instance |
省略可能 |
QoESettings |
QoE 構成オブジェクトへのオブジェクト参照。このオブジェクトは、QoESettings 型である必要があります。このオブジェクトを取得するには、Get-CsQoEConfiguration を呼び出します。 |
EnableExternalConsumer |
省略可能 |
ブール値 |
外部コンシューマーが QoE レポートを受信できるかどうかを指定します。 |
EnablePurging |
省略可能 |
ブール値 |
KeepQoEDataForDays プロパティで定義されている期間が経過した後で、レコードを削除するかどうかを指定します。 |
EnableQoE |
省略可能 |
ブール値 |
QoE レコードを収集して、監視データベースに保存するかどうかを指定します。 EnableQoE が True に設定されている場合でも、監視サーバー が展開され、レジストラー プールに関連付けられていない限り、QoE データは収集されません。 |
ExternalConsumerIssuedCertId |
省略可能 |
IssuedCertId |
外部コンシューマー Web サービスへのアクセスを許可する証明書の証明書 ID。 |
ExternalConsumerName |
省略可能 |
文字列 |
QoE レポートの外部コンシューマーのフレンドリ名。 |
ExternalConsumerURL |
省略可能 |
文字列 |
QoE レポートを公開する外部コンシューマーの URL。 |
KeepQoEDataForDays |
省略可能 |
UInt32 |
データベースから削除するまで QoE データを格納する日数。EnablePurging を False に設定している場合、この値は無視されます。 1 ~ 2562 の値を指定します。 |
PurgeHourOfDay |
省略可能 |
UInt32 |
KeepQoEDataForDays プロパティに指定されている日数を超えた QoE レコードを削除する時刻。 時刻を表す 0 ~ 23 の値を指定します。たとえば、0 は午前 0 時、13 は午後 1 時です。 |
Force |
省略可能 |
SwitchParameter |
変更を行う前に表示されるように設定されているすべての確認メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Settings.QoE.QoESettings オブジェクト。QoE 構成オブジェクトのパイプライン処理された入力を受け入れます。
戻り値の種類
Set-CsQoEConfiguration を実行しても値やオブジェクトが戻されることはありません。代わりに Microsoft.Rtc.Management.WritableConfig.Settings.QoE.QoESettings オブジェクトのインスタンスを構成します。
例
-------------------------- 例 1 --------------------------
Set-CsQoEConfiguration -Identity site:Redmond -EnableQoE $False
例 1 のコマンドで Set-CsQoEConfiguration コマンドレットを使用し、Redmond サイト (-Identity site:Redmond) の QoE 設定を変更しています。EnableQoE パラメーターを False に設定することで、新しい設定で QoE を無効にしています。
-------------------------- 例 2 --------------------------
Set-CsQoEConfiguration -Identity site:Dublin -KeepQoEDataForDays 45 -PurgeHourOfDay 4
このコマンドで、ダブリン サイトに適用されている QoE 設定を変更しています。この例では、KeepQoEDataForDays パラメーターを 45 に設定しているので、QoE データは 45 日を過ぎるとデータベースから削除されます。さらに、PurgeHourOfDay パラメーターを 4 に設定しており、指定した 45 日を超えたデータが午前 4 時に削除されます。
注: QoE および詳細な通話の記録 (CDR) を有効にしている場合は、パフォーマンス上の理由から、QoE と CDR で PurgeHourOfDay を異なる設定にすることをお勧めします。