次の方法で共有


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 値に等しくない場合は、そのアプリケーションにスクリプトが割り当てられていることを意味します。