Set-CsHealthMonitoringConfiguration
トピックの最終更新日: 2012-03-25
稼働状況の監視構成設定の既存のコレクションを変更します。これらの設定により、管理者は必要なテスト アカウントのユーザー名およびパスワードを指定する必要なく、品質保証テストを実行できます。
構文
Set-CsHealthMonitoringConfiguration [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-FirstTestSamAccountName <String>] [-FirstTestUserSipUri <String>] [-Force <SwitchParameter>] [-SecondTestSamAccountName <String>] [-SecondTestUserSipUri <String>] [-WhatIf [<SwitchParameter>]]
Set-CsHealthMonitoringConfiguration [-Confirm [<SwitchParameter>]] [-FirstTestSamAccountName <String>] [-FirstTestUserSipUri <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-SecondTestSamAccountName <String>] [-SecondTestUserSipUri <String>] [-WhatIf [<SwitchParameter>]]
解説
代理トランザクションは Microsoft Lync Server 2010 で使用され、システムへのログオン、インスタント メッセージの交換、公衆交換電話網 (PSTN) 上の電話への発信などの一般的なタスクをユーザーが正常に実行できることを検証するものです。これらのテストは、管理者が手動で実行することも、Microsoft System Center Operations Manager (以前の Microsoft Operations Manager) などのアプリケーションから自動で実行することもできます。
代理トランザクションは、2 つの異なる方法で実行できます。多くの管理者は、CsHealthMonitoringConfiguration コマンドレットを使用して、テスト アカウントを各レジストラー プールに設定します。これらのテスト アカウントとは、代理トランザクションでの使用を目的としてあらかじめ構成されている 1 組のユーザー アカウントのことです (通常、これらはテスト アカウントであり、実際のユーザーのアカウントではありません)。プールにテスト アカウントを構成すると、管理者がテスト用にユーザー アカウント ID を指定したり資格情報を入力したりしなくても、そのプールに対して代理トランザクションを実行できます。代わりに、代理トランザクションがチェックの実行時に構成済みのテスト アカウントを自動的に使用します。
管理者は、実際のユーザー アカウントを使用して代理トランザクションを実行することもできます。たとえば、2 人のユーザーがインスタント メッセージを交換できない場合、管理者は、2 つのテスト アカウントではなく、問題の 2 つのユーザー アカウントを使用して代理トランザクションを実行できます。実際のユーザー アカウントを使用して代理トランザクションを実行する場合は、各ユーザーの資格情報を入力する必要があります。
状態監視構成設定を構成した後で、Set-CsHealthMonitoringConfiguration コマンドレットを使用して、これらの設定をいつでも変更できます。このコマンドレットにより、プールでの使用に構成されているテスト アカウントの一方 (または両方) を変更することができます。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、Set-CsHealthMonitoringConfiguration コマンドレットのローカル実行を承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsHealthMonitoringConfiguration"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
FQDN |
変更対象の状態監視構成設定が割り当てられているプールの完全修飾ドメイン名 (FQDN)。次に例を示します。-Identity atl-cs-001.litwareinc.com。 |
Instance |
省略可能 |
HealthMonitoringSettings オブジェクト |
個々のパラメーター値を設定するのではなく、オブジェクトへの参照をコマンドレットに渡せるようにします。 |
FirstTestSamAccountName |
省略可能 |
文字列 |
最初のテスト ユーザーの SamAccountName。FirstTestSamAccountName は、次のように、domain\username の形式を使用して入力する必要があります。 -FirstTestSamAccountName litwareinc\kenmyer |
FirstTestUserSipUri |
省略可能 |
SIP アドレス |
この状態監視設定のコレクションで使用するよう構成される、最初のテスト ユーザーの SIP アドレスです。SIP アドレスには、sip: というプレフィックスを含める必要があります。次に例を示します。-FirstTestUserSipUri "sip:kenmyer@litwareinc.com"。 |
SecondTestSamAccountName |
省略可能 |
文字列 |
2 番目のテスト ユーザーの SamAccountName。SecondTestSamAccountName は、次のように、domain\username の形式を使用して入力する必要があります。 -SecondTestSamAccountName litwareinc\pilar |
SecondTestUserSipUri |
省略可能 |
SIP アドレス |
この状態監視設定のコレクションで使用するよう構成される、2 番目のテスト ユーザーの SIP アドレスです。SIP アドレスには、sip: というプレフィックスを含める必要があります。次に例を示します。-FirstTestUserSipUri "sip:pilar@litwareinc.com"。 |
Force |
省略可能 |
スイッチ パラメーター |
コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
スイッチ パラメーター |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
スイッチ パラメーター |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Settings.HealthMonitoring.HealthMonitoringSettings オブジェクト。Set-CsHealthMonitoringConfiguration は、状態監視構成オブジェクトのパイプ処理されたインスタンスを受け入れます。
戻り値の種類
なし。代わりに、Set-CsHealthMonitoringConfiguration は、Microsoft.Rtc.Management.WritableConfig.Settings.HealthMonitoring.HealthMonitoringSettings オブジェクトの既存のインスタンスを変更します。
例
-------------------------- 例 1 ------------------------
Set-CsHealthMonitoringConfiguration -Identity atl-cs-001.litwareinc.com -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -FirstTestSamAccountName "litwareinc\kenmyer"
例 1 のコマンドを実行して、atl-cs-001.litwareinc.com プールの状態監視構成設定に割り当てられた最初のテスト ユーザーを構成します。この例では、新しいテスト ユーザーの SIP アドレスが sip:kenmyer@litwareinc.com に設定され、テスト ユーザーの SamAccountName が kenmyer に設定されます。
-------------------------- 例 2 ------------------------
Get-CsHealthMonitoringConfiguration | Set-CsHealthMonitoringConfiguration -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -FirstTestSamAccountName "litwareinc\kenmyer"
上記のコマンドは、例 1 のコマンドの変化形です。ただしこの場合は、同じテスト ユーザーが、組織で使用中の状態監視構成設定の各コレクションに割り当てられます。このタスクを実行するため、コマンドでまず Get-CsHealthMonitoringConfiguration を使用して、すべての状態監視構成設定のコレクションを戻します。次に、このコレクションは Set-CsHealthMonitoringConfiguration にパイプ処理され、同じ最初のテスト ユーザーの SIP アドレスと SamAccountName がコレクション内の各項目に割り当てられます。
-------------------------- 例 3 ------------------------
Get-CsHealthMonitoringConfiguration | Where-Object {$_.FirstTestUserSipUri -eq "sip:pilar@litwareinc.com"} | Set-CsHealthMonitoringConfiguration -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -FirstTestSamAccountName "litwareinc\kenmyer"
例 3 は、状態監視構成設定のコレクションに割り当てられた最初のテスト ユーザーを検索して置換する方法を示しています。この例では、SIP アドレスが sip:pilar@litwareinc.com のユーザーは、コレクション内に最初のテスト ユーザーとして含まれる場合は常に置き換えられます。
このタスクを実行するため、コマンドでまず、パラメーターを指定せずに Get-CsHealthMonitoringConfiguration を呼び出します。これにより、組織で現在使用中のすべての状態監視構成設定のコレクションが戻されます。次に、このコレクションは Where-Object コマンドレットにパイプ処理され、FirstTestUserSipUri プロパティが sip:pilar@litwareinc.com と等しい (-eq) 項目のみ取得されます。そのフィルター処理されたコレクションは Set-CsHealthMonitoringConfiguration にパイプ処理され、コレクション内の各項目について、FirstTestUserSipUri プロパティの値が sip:kenmyer@litwareinc.com に、FirstTestSamAccountName プロパティの値が kenmyer に設定されます。