Get-CsService

 

トピックの最終更新日: 2012-03-23

Lync Server インフラストラクチャで使用しているサービスとサーバーの役割に関する情報を戻します。サービスとは、Lync Server プールに展開されたロールのインスタンスです。たとえば、監視サービスを実行しているコンピューターから成るプールが存在していることがあります。UNRESOLVED_TOKEN_VAL(ps-intro-in-LS2010)

構文

Get-CsService [-Identity <XdsGlobalRelativeIdentity>] <COMMON PARAMETERS>

Get-CsService [-ApplicationServer <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-ApplicationDatabase <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-ArchivingServer <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-ArchivingDatabase <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-BackupServer <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-CentralManagement <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-CentralManagementDatabase <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-ConferencingServer <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-Director <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-EdgeServer <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-TrustedApplicationPool <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-FileStore <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-PersistentChatServer <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-PersistentChatComplianceDatabase <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-PersistentChatDatabase <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-ManagementServer <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-MediationServer <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-MonitoringServer <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-MonitoringDatabase <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-PstnGateway <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-Registrar <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-UserServer <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-UserDatabase <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-WacServer <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-WebServer <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-VideoInteropServer <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-MediaProcessor <SwitchParameter>] <COMMON PARAMETERS>

Get-CsService [-Filter <String>] <COMMON PARAMETERS>

COMMON PARAMETERS: [-PoolFqdn <String>]

例 1

例 1 に示すコマンドにより、組織で現在実行されているすべての Lync Server サービスとサーバーの役割に関する情報が戻されます。

Get-CsService

例 2

例 2 では、アプリケーション サービス に関する情報のみを戻します。適切なパラメーターを使用すると、単純に他のサービス/サーバーの役割に関する情報を戻すことができます。たとえば、次のコマンドはファイル ストアに関する情報を戻します。

Get-CsService -ApplicationServer

例 3

例 3 は、atl-cs-001.litwareinc.com プールに配置されている各サービスに関する ID が戻されます。このタスクを実行するため、コマンドはまず、Get-CsService コマンドレットと PoolFqdn パラメーターを呼び出し、atl-cs-001.litwareinc.com プールで見つかったサービスとサーバーの役割のみを戻します。次に、コレクションを Select-Object コマンドレットにパイプ処理し、このコマンドレットはコレクション内の各項目に関する Identity をレポートします。

Get-CsService -PoolFqdn "atl-cs-001.litwareinc.com" | Select-Object Identity

例 4

例 4 では、Redmond サイトで見つかったすべてのサービスとサーバーの役割に関する情報が戻されます。これを実行するには、最初にパラメーターなしで Get-CsService コマンドレットを呼び出します。この結果、組織で現在使用されているすべてのサービスとサーバーの役割のコレクションが戻されます。次に、このコレクションは Where-Object コマンドレットにパイプ処理され、SiteID プロパティが site:Redmond と等しい項目のみを選択します。

Get-CsService | Where-Object {$_.SiteID -eq "site:Redmond"}

例 5

例 5 のコマンドを実行すると、レジストラーを依存サービスとして表示するすべてのサービスに関する情報が戻されます。これを実行するため、Get-CsService コマンドレットを呼び出して、現在使用中のすべてのサービスとサーバーの役割のコレクションを戻します。次に、このコレクションは Where-Object コマンドレットにパイプ処理され、DependentServiceList プロパティに "Registrar" という文字列値が含まれている各項目を選択します。Where-Object コマンドレットの条件は、-like 演算子とワイルドカード値 "*Registrar*" を使用して指定します。

Get-CsService | Where-Object {$_.DependentServiceList -like "*Registrar*"}

解説

Lync Server で見つかった機能は、通常はサービスまたはサーバーの役割として表現されます。たとえば、組織内で実行されているすべてのインスタント メッセージング セッションのテキストを自動的に保存するように Lync Server を構成することができます。これを実行するには、アーカイブ サーバー というサーバーの役割をインストールする必要があります。サービスとサーバーの役割は、Lync Server 自体をインストールするときに同時に構成すること、またはソフトウェアを実行するようになった後に構成することができます。

Get-CsService コマンドレットを使用すると、組織内で実行されているサーバーの役割とサービスに関する情報を戻すことができます。追加パラメーターを指定せずに Get-CsService コマンドレットを呼び出すと、すべてのサービスとサーバーの役割に関する詳細な情報が返されます。代わりに、PoolFqdn パラメーターを使用して、指定したプールのみに返りデータを制限することもできます。さらに、任意の数のスイッチ パラメーターを使用して、特定のサービスの種類のみに返りデータを制限できます スイッチ パラメーターとは、パラメーター値を必要としないパラメーターのことです。たとえば、次のコマンドはすべてのアーカイブ サーバーに関する情報を戻します。

Get-CsService -ArchivingServer

1 つのコマンドにつき、このようなスイッチ パラメーターを 1 つだけ使用できることに注意してください。次のコマンドは、アーカイブ サーバーと監視サーバーの両方に関する情報を戻そうとしますが、失敗します。

Get-CsService -ArchivingServer -MonitoringServer

複数のサーバーの役割に関する情報を戻す必要がある場合は、Get-CsService コマンドレットを使用してサービス データの完全なコレクションを戻し、次にそのデータを Where-Object コマンドレットにパイプ処理します。

Get-CsService | Where-Object {$_.Role -eq "ArchivingServer" -or $_.Role -eq "MonitoringServer"}

このコマンドレットを実行できるユーザー: 既定では、次のグループのメンバーが、Get-CsService コマンドレットのローカル実行を承認されています。RTCUniversalUserAdmins、RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。

Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Get-CsService"}

パラメーター

パラメーター 必須かどうか 説明

ApplicationDatabase

省略可能

System.Management.Automation.SwitchParameter

組織で使用されるアプリケーション データベースに関する情報を戻します。アプリケーション サービス では、アプリケーション データベースを使用します。

ApplicationServer

省略可能

System.Management.Automation.SwitchParameter

アプリケーション サービス に関する情報を戻します。アプリケーション サービス は、Microsoft Unified Communications Managed API (UCMA) を使用して作成したアプリケーションを実行する方法を提供します。

ArchivingDatabase

省略可能

System.Management.Automation.SwitchParameter

組織で使用されるアーカイブ データベースに関する情報を戻します。アーカイブ データベースでは、インスタント メッセージング セッションのテキストを保存します。

ArchivingServer

省略可能

System.Management.Automation.SwitchParameter

組織で使用されるアーカイブ サーバーに関する情報を戻します。アーカイブ サーバーを使用すると、インスタント メッセージング セッションのテキストを保存できます。

BackupServer

省略可能

System.Management.Automation.SwitchParameter

組織で使用されるバックアップ サーバーに関する情報を戻します。

CentralManagement

省略可能

System.Management.Automation.SwitchParameter

組織で使用される 中央管理サービス に関する情報を戻します。中央管理サービス を使用して、Lync Server サービスを実行しているコンピューターに、構成データを送信します。

CentralManagementDatabase

省略可能

System.Management.Automation.SwitchParameter

組織で使用される 中央管理ストア に関する情報を戻します。中央管理ストア は、Lync Server に関する構成情報を維持します。

ConferencingServer

省略可能

System.Management.Automation.SwitchParameter

組織で使用される 音声ビデオ会議サービス に関する情報を戻します。音声ビデオ会議サービス を使用して、会議と電話会議を実施できます。

Director

省略可能

System.Management.Automation.SwitchParameter

組織で使用されるディレクターに関する情報を戻します。ディレクターは、ユーザーからの要求とユーザー認証を処理するように強化されていますが、ユーザー アカウントを保持していません。ディレクターは、通常、外部ユーザーからの要求を処理する目的で使用します。

EdgeServer

省略可能

System.Management.Automation.SwitchParameter

組織で使用されるエッジ サーバーに関する情報を戻します。エッジ サーバーでは、内部ネットワークとインターネットの間の接続を提供します。

FileStore

省略可能

System.Management.Automation.SwitchParameter

組織で使用されるファイル ストアに関する情報を戻します。ファイル ストアを使用して、アナウンス サービスが使用するオーディオ ファイルなどの Lync Server ファイルを維持します。

Filter

省略可能

System.String

戻される 1 つまたは複数のサービスを指定するときに、ワイルドカードを使用できるようにします。Identity パラメーターと Filter パラメーターの両方を同じコマンドで使用することはできません。

Identity

省略可能

Microsoft.Rtc.Management.Xds.XdsGlobalRelativeIdentity

戻される特定のサービスまたはサーバーの役割に関する一意の識別子。次に例を示します。-Identity "Registrar:atl-cs-001.litwareinc.com"。

ManagementServer

省略可能

System.Management.Automation.SwitchParameter

組織で使用される 中央管理サーバー に関する情報を戻します。中央管理サーバー は一般にフロントエンド サーバーと共に配置され、中央管理ストア 内の情報にアクセスする役割を果たします。

MediaProcessor

省略可能

System.Management.Automation.SwitchParameter

組織で使用されるメディア プロセッサ サービスに関する情報を戻します。

MediationServer

省略可能

System.Management.Automation.SwitchParameter

組織で使用される仲介サーバーに関する情報を戻します。仲介サーバーを使用すると、エンタープライズ VoIP ネットワークと公衆交換電話網 (PSTN) の間でブリッジを提供するのに役立ちます。

MonitoringDatabase

省略可能

System.Management.Automation.SwitchParameter

組織で使用される監視データベースに関する情報を戻します。監視データベースでは、エンタープライズ VoIP 電話の使用法と通話の品質に関する情報を格納します。

MonitoringServer

省略可能

System.Management.Automation.SwitchParameter

組織で使用される監視サーバーに関する情報を戻します。監視サーバーを使用して、エンタープライズ VoIP 電話の使用法と通話の品質を追跡します。

PersistentChatComplianceDatabase

省略可能

System.Management.Automation.SwitchParameter

常設チャットのコンプライアンス情報を保持するために使用されるデータベースについての情報を戻します。

PersistentChatDatabase

省略可能

System.Management.Automation.SwitchParameter

常設チャットの情報を保持するために使用されるデータベースについての情報を戻します。

PersistentChatServer

省略可能

System.Management.Automation.SwitchParameter

組織で使用される常設チャットのサーバーに関する情報を戻します。

PoolFqdn

省略可能

System.String

サービスまたはサーバーの役割をホストするプールの完全修飾ドメイン名 (FQDN)。PoolFqdn パラメーターを使用し、サービス固有のパラメーターを指定しない場合は、プールの中で見つかったすべてのサービスとサーバーの役割が戻されます。

PstnGateway

省略可能

System.Management.Automation.SwitchParameter

組織で使用される公衆交換電話網 (PSTN) ゲートウェイに関する情報を戻します。PSTN ゲートウェイでは、エンタープライズ VoIP デバイスからの信号を、PSTN デバイスが理解できる信号に、またはその逆に変換します。

Registrar

省略可能

System.Management.Automation.SwitchParameter

組織で使用されるレジストラーに関する情報を戻します。レジストラーを使用して、ユーザーを認証してユーザーの現在のステータスを追跡します。

TrustedApplicationPool

省略可能

System.Management.Automation.SwitchParameter

組織で使用される信頼されたアプリケーション プールに関する情報を戻します。信頼されたアプリケーション プールでは、信頼されたアプリケーションを実行するコンピューターをホストします。

UserDatabase

省略可能

System.Management.Automation.SwitchParameter

組織で使用される ユーザー データベース に関する情報を戻します。ユーザー データベースでは、ユーザー サーバー サービスで必要とされるデータを格納します。

UserServer

省略可能

System.Management.Automation.SwitchParameter

組織で使用される ユーザー サービス サービスに関する情報を戻します。ユーザー サービス サービスでは、ユーザー レプリケーション、インバンド プロビジョニング、プレゼンス公開と通知、および連絡先カードの交換などの機能を提供します。

VideoInteropServer

省略可能

System.Management.Automation.SwitchParameter

組織で使用されるビデオ相互運用性サーバーに関する情報を戻します。このサーバーはサードパーティ SIP ベースのビデオ会議による相互運用性を提供し、パートナー ゲートウェイは不要です。

WacServer

省略可能

System.Management.Automation.SwitchParameter

Microsoft Lync Server で使用される Office Web Apps に関する情報を戻します。Office Web Apps サーバーは以前は "WacServer" と呼ばれていました。

WebServer

省略可能

System.Management.Automation.SwitchParameter

組織で使用される Web サービス サービスに関する情報を戻します。Web サービス サービスでは、アドレス帳サービスなどの Web ベース アプリケーションをホストします。

入力の種類

なし。Get-CsService コマンドレットはパイプライン入力を受け入れません。

戻り値の種類

Get-CsService コマンドレットでは、このコマンドレットを呼び出すときに使用されたパラメーターに基づいて、さまざまなオブジェクトを戻します。たとえば、MonitoringDatabase パラメーターを指定すると、Get-CsService コマンドレットによって Microsoft.Rtc.Management.Xds.DisplayMonitoringDatabase オブジェクトのインスタンスが戻されます。他のパラメーターを使用して戻されるオブジェクトを決定するには、これらのパラメーターのいずれかを使用して Get-CsService コマンドレットを呼び出し、次に戻されたオブジェクトを Get-Member コマンドレットにパイプ処理します。次に例を示します。Get-CsService -Registrar | Get-Member。