Get-CsServerApplication
トピックの最終更新日: 2012-03-23
組織で使用中のサーバー アプリケーションに関する情報を戻します。サーバー アプリケーションは、Microsoft Lync Server 2010 によってホストされるアプリケーションです。
構文
Get-CsServerApplication [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsServerApplication [-Filter <String>] [-LocalStore <SwitchParameter>]
解説
サーバー アプリケーションは、Lync Server 2010 で実行される個々のプログラムです。Get-CsServerApplication コマンドレットを使用すると、管理者は Lync Server の一部として実行されている、任意またはすべてのアプリケーションに関する情報を戻すことができます。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、Get-CsServerApplication コマンドレットのローカル実行を承認されています。RTCUniversalUserAdmins、RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsServerApplication"}
パラメーター
パラメーター | 必須かどうか | 型 | 説明 |
---|---|---|---|
Identity |
省略可能 |
Xds Identity |
取得するサーバー アプリケーションの一意の識別子です。サーバー アプリケーションの Identity は、アプリケーションをホストしているサービスとアプリケーション名から構成されます。たとえば、QoEAgent という名前のサーバー アプリケーションは、次のような Identity を持ちます。service:Registrar:atl-cs-001.litwareinc.com/QoEAgent。 特定のサービスで実行されているすべてのアプリケーションのコレクションを取得するには、次のようにアプリケーション名を省略するだけです。 -Identity "Registrar:atl-cs-001.litwareinc.com "。 このパラメーターを省略している場合、Get-CsServerApplication を呼び出すと、すべてのサーバー アプリケーションが戻されます。 |
Filter |
省略可能 |
文字列 |
サーバー アプリケーションまたはサーバー アプリケーションのセットを戻すときに、ワイルドカードを使用できます。たとえば、Identity の任意の箇所に "IIMFilter" という文字列値が含まれているすべてのサーバー アプリケーションを戻すには、次の構文を使用します。-Filter "*IIMFilter*"。 |
LocalStore |
省略可能 |
スイッチ パラメーター |
中央管理ストア 自体からではなく、中央管理ストア のローカル レプリカからサーバー アプリケーションのデータを取得します。 |
入力の種類
なし。Get-CsServerApplication は、パイプライン入力を受け入れません。
戻り値の種類
Get-CsServerApplication は、Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application オブジェクトのインスタンスを戻します。
例
-------------------------- 例 1 ------------------------
Get-CsServerApplication
例 1 に示すコマンドでは、現在組織で使用中のすべてのサーバー アプリケーションに関する情報を戻しています。これを行うため、パラメーターを指定せずに Get-CsServerApplication を呼び出しています。
-------------------------- 例 2 ------------------------
Get-CsServerApplication -Identity "service:EdgeServer:atl-edge-001.litwareinc.com"
例 2 では、サービス EdgeServer:atl-edge-001.litwareinc.com で実行中のすべてのサーバー アプリケーションの情報を戻しています。
-------------------------- 例 3 ------------------------
Get-CsServerApplication -Identity "service:Registrar:atl-cs-001.litwareinc.com/ExumRouting"
例 3 では、1 つのサーバー アプリケーションの情報を戻しています。"Registrar:atl-cs-001.litwareinc.com/ExumRouting" という ID を持つアプリケーションの情報です。
-------------------------- 例 4 ------------------------
Get-CsServerApplication -Filter "service:*:atl-cs-001.litwareinc.com*"
上記のコマンドでは、プール atl-cs-001.litwareinc.com 内で使用するよう構成されたすべてのサーバー アプリケーションを戻しています。これを行うため、Filter パラメーターおよびフィルター値 "service:*:atl-cs-001.litwareinc.com*" を使用しています。このフィルター値により、戻されるデータを "service:" という文字で始まり":atl-cs-001.litwareinc.com" という文字が含まれる Identity を持つアプリケーションに制限します。
-------------------------- 例 5 ------------------------
Get-CsServerApplication | Where-Object {$_.Enabled -eq $False}
例 5 では、現在無効となっているすべてのサーバー アプリケーションの情報を戻しています。このタスクを実行するため、コマンドでまず Get-CsServerApplication を呼び出して、組織での使用に構成されているすべてのサーバー アプリケーションのコレクションを戻します。次に、このコレクションを Where-Object コマンドレットにパイプ処理し、Enabled プロパティが False と等しいアプリケーションのみ取得します。
-------------------------- 例 6 ------------------------
Get-CsServerApplication | Where-Object {$_.Critical -eq $True -and $_.Enabled -eq $False}
例 6 は例 5 に示すコマンドを変化させたものです。例 6 では、重要としてマークされていて現在無効になっているすべてのサーバー アプリケーションの情報を戻します。これを行うため、コマンドでまず、パラメーターを指定せずに Get-CsServerApplication を呼び出して、使用するよう構成されているすべてのサーバー アプリケーションのコレクションを戻します。次に、このコレクションを Where-Object にパイプ処理し、次の 2 つの条件を満たすアプリケーションのみ取得します。Critical プロパティが True と等しく、かつ Enabled プロパティが False と等しい。-and 演算子によって、両方の条件を満たすオブジェクトのみが戻されます。
-------------------------- 例 7 ------------------------
Get-CsServerApplication | Where-Object {$_.Uri -like "*routing*"}
例 7 では、URI の一部に文字列値 "routing" を持つすべてのサーバー アプリケーションの情報を戻しています。このタスクを実行するため、まず Get-CsServerApplication を使用して、現在使用中のすべてのサーバー アプリケーションを取得します。次に、取得したコレクションを Where-Object にパイプ処理し、Uri プロパティに文字列値 "routing" が含まれるアプリケーションのみ取得します。
-------------------------- 例 8 ------------------------
Get-CsServerApplication | Where-Object {$_.ScriptName -ne $Null}
上記のコマンドでは、スクリプトが割り当てられているすべてのサーバー アプリケーションの情報を戻しています。これを行うため、コマンドでまず、現在使用中のすべてのサーバー アプリケーションのコレクションを取得します。この情報は、パラエーターを指定せずに Get-CsServerApplication を呼び出して取得します。次に、サーバー アプリケーションの完全なコレクションを Where-Object コマンドレットにパイプ処理し、ScriptName プロパティが Null 値と等しくないアプリケーションのみ取得します。ScriptName プロパティが Null 値に等しくない場合は、そのアプリケーションにスクリプトが割り当てられていることを意味します。