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