Test-CsTopology
トピックの最終更新日: 2012-03-26
Microsoft Lync Server 2010 のインストールに対して、サービスのアクティブ化およびグループのアクセス許可を確認します。
構文
Test-CsTopology [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-Service <String>]
解説
Test-CsTopology コマンドレットを実行すると、Lync Server 2010 がグローバル レベルで正常に機能していることを確認できます。既定では、このコマンドレットによって、Lync Server インフラストラクチャ全体を確認し、必要なサービスが実行されており、これらのサービスと Lync Server のインストール時に作成したユニバーサル セキュリティ グループに適切なアクセス許可が設定されていることを確認します。
Lync Server 全体の有効性を確認する以外に、Test-CsTopology によって、特定のサービスの有効性も確認できます。たとえば、以下のコマンドで、プール atl-cs-001.litwareinc.com の A/V 会議サーバーの状態を確認します。
Test-CsTopology –Service "ConferencingServer:atl-cs-001.litwareinc.com"
このコマンドレットを実行できるユーザー:このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsTopology"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
GlobalCatalog |
省略可能 |
文字列 |
ドメイン内のグローバル カタログ サーバーの完全修飾ドメイン名 (FQDN) です。ドメイン内にアカウントのあるコンピューターで Test-CsTopology を実行している場合、このパラメーターは必要ありません。 |
GlobalSettingsDomainController |
省略可能 |
文字列 |
グローバル設定が保存されているドメイン コントローラーの FQDN です。グローバル設定が Active Directory ドメイン サービス (AD DS) 内のシステム コンテナーに保存されている場合は、このパラメーターでルート ドメイン コントローラーを指定する必要があります。グローバル設定が構成コンテナーに保存されている場合は、すべてのドメイン コントローラーが使用でき、このパラメーターを省略できます。 |
Service |
省略可能 |
サービス の Identity |
指定する場合、Test-CsTopology によって、その有効性の確認が指定したサービスに制限されます (Service パラメーターを使用する場合、一度に指定できるのは 1 つのサービスのみです)。適切なサービス ID を使用して、サービスを指定する必要があります。たとえば、次の構文は、プール atl-cs-001.litwareinc.com のレジストラー サービスを参照します。-Service "Registrar:atl-cs-001.litwareinc.com"。 このパラメーターを指定しない場合は、トポロジ全体が検証されます。 |
Report |
省略可能 |
文字列 |
コマンドレット実行時に作成されるログ ファイルのファイル パスを指定できるようにします。次に例を示します。-Report "C:\Logs\Topology.html" |
Verbose |
省略可能 |
スイッチ パラメーター |
コマンドレット実行中に、画面に詳細情報を表示します。 |
入力の種類
なし。Test-CsTopology はパイプライン処理された入力を受け入れません。
戻り値の種類
Test-CsTopology を実行すると、Microsoft.Rtc.SyntheticTransactions.TaskOutput オブジェクトのインスタンスが戻されます。
例
-------------------------- 例 1 --------------------------
Test-CsTopology
上記のコマンドを実行すると、Lync Server のトポロジ全体が検証されます。
-------------------------- 例 2 --------------------------
Test-CsTopology -Report "C:\Logs\Topology.xml"
例 2 のコマンドは、例 1 のコマンドの変化形です。ただし、この場合、Report パラメーターを使用して出力ファイルを書き込む場所 (C:\Logs\Topology.xml) を指定します。
-------------------------- 例 3 --------------------------
Test-CsTopology -Service "Registrar:atl-cs-001.litwareinc.com"
例 3 では、Test-CsTopology を使用して、単一サービス Registrar:atl-cs-001.litwareinc.com を検証しています。