Get-CsComputer
トピックの最終更新日: 2012-03-23
Microsoft Lync Server 2010 インフラストラクチャ内でサービスの役割を実行するコンピューターに関する情報を戻します。
構文
Get-CsComputer [-Identity <XdsGlobalRelativeIdentity>] [-Pool <String>]
Get-CsComputer [-Filter <String>] [-Pool <String>]
解説
Get-CsComputer を使用すると、Lync Server 2010 のサービスまたはサーバーの役割を実行しているコンピューターをすばやく識別できます。パラメーターを何も指定せずに Get-CsComputer を呼び出すと、Lync Server 2010 のサービスまたはサーバーの役割を実行しているすべてのコンピューターのコレクションが戻されます。このコレクションには、各コンピューターの ID、プール名、および完全修飾ドメイン名 (FQDN) が含まれています。あるいは、Identity、Filter、または Pool などのオプションのパラメーターを使用して、戻されるデータを単一のコンピューター、またはコンピューターのセットに制限できます。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが Get-CsComputer コマンドレットをローカルで実行することを承認されています。RTCUniversalUserAdmins、RTCUniversalServerAdmins、RTCUniversalReadOnlyAdmins。
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
文字列 |
戻されるコンピューターの FQDN です。次に例を示します。-Identity "atl-cs-001.litwareinc.com"。 このパラメーターを指定しないと、Lync Server 2010 が実行されているすべてのコンピューターが戻されます。 |
Filter |
省略可能 |
文字列 |
戻すコンピューター (複数可) の ID を指定するときに、ワイルドカード文字を使用できます。たとえば、このコマンドでは、文字列値 "atl-" で始まる ID を持つすべてのコンピューターに関する情報を戻しています。-Filter "atl-*"。 |
Pool |
省略可能 |
文字列 |
Lync Server 2010 プールの FQDN です。このパラメーターを使用すると、指定したプール内のすべてのコンピューターに関する情報が戻されます。 |
入力の種類
なし。Get-CsComputer は、パイプライン処理された入力を受け入れません。
戻り値の種類
Get-CsComputer を実行すると、Microsoft.Rtc.Management.Deploy.Internal.Machine オブジェクトのインスタンスが戻されます。
例
-------------------------- 例 1 --------------------------
Get-CsComputer
例 1 では、Get-CsComputer コマンドレットを使用して、Lync Server 2010 インフラストラクチャ内でサービスの役割を実行するすべてのコンピューターに関する情報を戻します。
-------------------------- 例 2 --------------------------
Get-CsComputer -Filter "*.litwareinc.com"
例 2 に示すコマンドは、Filter パラメーターを使用して、litwareinc.com ドメインの一部となっているサービスの役割のコンピューターのみを戻します。ワイルドカード文字列 *.litwareinc.com により、戻される情報を FQDN が ".litwareinc.com" で終わるコンピューターに制限しています。
-------------------------- 例 3 --------------------------
Get-CsComputer -Identity "atl-cs-001.litwareinc.com"
上記の例では、Identity パラメーターを使用して、返りデータを FQDN が atl-cs-001.litwareinc.com になっている 1 台のコンピューターに制限しています。
-------------------------- 例 4 --------------------------
Get-CsComputer -Pool "atl-cs-001.litwareinc.com"
例 4 では、Pool パラメーターを使用して、atl-cs-001.litwareinc.com プールで見つかったすべてのコンピューターに関する情報を戻します。