Get-CsTopology
トピックの最終更新日: 2012-03-23
内部ドメイン、サイト、クラスター、コンピューター、サービス、および SQL Server のバックエンド インスタンスなどの Microsoft Lync Server 2010 インフラストラクチャーに関する情報を戻します。
構文
Get-CsTopology [-AsXml <SwitchParameter>] [-LocalStore <SwitchParameter>]
解説
Get-CsTopology コマンドレットは、Lync Server 2010 の設定と構成方法に関する情報を戻します。追加パラメーターなしで呼び出すと、このコマンドレットは、Lync Server インフラストラクチャーの概要を戻します。その場合、ドメイン、サイト、Lync Server サービスとサーバーの役割を実行するコンピューターなどの鳥瞰図を示します。あるいは、Get-CsTopology の出力を Select-Object コマンドレットに渡して、トポロジの部分に関する詳細情報を得ることができます。たとえば、以下のコマンドを実行すると、Lync Server によって使用される SQL Server インスタンスに関する詳細情報が戻されます。
Get-CsTopology | Select-Object –ExpandProperty SqlInstances
また、AsXml パラメーターを使用して、トポロジ全体に関する詳細情報を XML 形式で戻すことができます。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが Get-CsTopology コマンドレットのローカルでの実行を承認されています。RTCUniversalUserAdmins、RTCUniversalServerAdmins。
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
AsXml |
省略可能 |
スイッチ パラメーター |
トポロジ情報を XML 形式で戻します。Get-CsTopology、AsXml パラメーター、および Out-File コマンドレットを一緒に使用すると、トポロジを XML ファイルにエクスポートできます。 |
LocalStore |
省略可能 |
スイッチ パラメーター |
トポロジのデータを 中央管理ストア そのものからではなく、中央管理ストア のローカル レプリカから取得します。 |
入力の種類
なし。Get-CsTopology は、パイプ処理された入力を許可しません。
戻り値の種類
Get-CsTopology は、Microsoft.Rtc.Management.Deploy.Internal.DefaultTopology オブジェクトのインスタンスを戻します。
例
-------------------------- 例 1 ------------------------
Get-CsTopology
上記のコマンドは、Lync Server トポロジの完全な詳細を戻します。この処理を実行するには、Get-CsTopology を追加パラメーターなしで呼び出します。
-------------------------- 例 2 ------------------------
Get-CsTopology | Select-Object -ExpandProperty Machines
例 2 は、Lync Server トポロジで検出されたコンピューターに関する情報を戻します。これを行うために、まず、Get-CsTopology を呼び出して、完全な Lync Server トポロジを戻します。次に、この情報は Select-Object コマンドレットにパイプ処理され、その結果、ExpandProperty パラメーターを使用して、そのトポロジ内のすべてのコンピューターの詳細情報が抽出および表示されます。
-------------------------- 例 3 ------------------------
Get-CsTopology -AsXML | Out-File C:\Logs\Topology.xml
例 3 に示すコマンドは、Lync Server トポロジに関する情報を戻し、その情報を XML ファイルに保存します。このタスクを実行するには、まず、Get-CsTopology を AsXml パラメーターとともに呼び出します。それにより、データは書式設定済みの XML として戻されます。書式設定されたこのデータは、Out-File コマンドレットにパイプ処理されて、ファイル C:\Logs\Topology.xml に情報が保存されます。