Lync Server 2013 でのコンピューター、サイト、グローバル一元ログ サービスの構成の管理

 

トピックの最終更新日: 2014-02-04

集中ログ サービスは、単一のコンピューター、コンピューターのプール、サイト スコープ (つまり、展開内のコンピューターとプールのコレクションを含むサイト Redmond などの定義されたサイト) を含むスコープで実行することも、グローバル スコープ (つまり、展開内のすべてのコンピューターとプール) で実行することもできます。

Lync Server 管理シェルを使用して一元的なログ サービススコープを構成するには、CsAdministrator または CsServerAdministrator ロールベースのアクセス制御 (RBAC) セキュリティ グループ、またはこれら 2 つのグループのいずれかを含むカスタム RBAC ロールのメンバーである必要があります。 このコマンドレットが割り当てられているすべての RBAC ロールの一覧 (自分で作成したカスタム RBAC ロールを含む) を返すには、Lync Server Management Shell または Windows PowerShell プロンプトから次のコマンドを実行します。

Get-CsAdminRole | Where-Object {$_.Cmdlets -match "<Lync Server 2013 cmdlet>"}

次に例を示します。

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

注意

Windows PowerShellには、CLSController.exeを使用して使用できない追加のオプションと追加の構成オプションが用意されています。 CLSController は、コマンドを実行するための簡単で簡潔なメソッドを提供しますが、CLSController で使用できる一連のコマンドに限定されています。 Windows PowerShellは、CLSController のコマンド プロセッサで使用できるコマンドだけでなく、より広範なコマンド セットと豊富なオプション セットを提供します。 たとえば、CLSController.exeには、–computers と –pools のスコープ オプションが用意されています。 Windows PowerShellを使用すると、ほとんどのコマンドでコンピューターまたはプールを指定できます。また、新しいシナリオを定義する場合 (CLSController には、ユーザーが変更できないシナリオの数が限られています)、サイトまたはグローバル スコープを定義できます。 Windows PowerShellのこの強力な機能を使用すると、サイトまたはグローバル スコープのシナリオを定義できますが、実際のログ記録はコンピューターまたはプールに制限できます。
Windows PowerShellまたは CLSController で実行できるコマンド ライン コマンドには基本的な違いがあります。 Windows PowerShellでは、シナリオを構成して定義し、トラブルシューティング シナリオに意味のある方法でそれらのシナリオを再利用するための豊富な方法が用意されています。 CLSController はコマンドを発行して結果を取得する高速かつ効率的な方法を提供しますが、CLSController のコマンド セットは、コマンド ラインから使用できる有限のコマンドによって制限されます。 Windows PowerShellコマンドレットとは異なり、CLSController は新しいシナリオを定義したり、サイトまたはグローバル レベルでスコープを管理したり、動的に構成できない有限のコマンド セットのその他の多くの制限を定義したりすることはできません。 CLSController は高速実行のための手段を提供しますが、Windows PowerShellは CLSController で可能な範囲を超えて集中ログ サービス機能を拡張する手段を提供します。

-Computers パラメーターを使用して Search-CsClsLoggingShow-CsClsLoggingStart-CsClsLoggingStop-CsClsLoggingSync-CsClsLoggingUpdate-CsClsLogging の各コマンドを実行する場合に、単一のコンピューターのスコープを定義できます。 -Computers パラメーターには、対象のコンピューターの完全修飾ドメイン名 (FQDN) のコンマ区切り一覧を指定できます。

ヒント

-Pools およびログ記録コマンドを実行するプールのコンマ区切り一覧を定義することもできます。

サイトスコープとグローバル スコープは、 New-Set-Remove- の一元化されたログ サービスコマンドレットで定義されます。 以下の例は、サイト スコープとグローバル スコープを設定する方法を示しています。

大事な

表示されるコマンドには、他のセクションで説明されているパラメーターと概念が含まれている場合があります。 コマンドの例は、スコープを定義するための –Identity パラメーターの使用を示すことを目的としており、その他のパラメーターは完全性とスコープを指定するために含まれています。 Set-CsClsConfiguration コマンドレットの詳細については、操作のドキュメントの Set-CsClsConfiguration を参照してください。

現在の集中ログ サービス構成を取得するには

  1. Lync Server 管理シェルを起動する: [スタート] をクリックし、[ すべてのプログラム] をクリックし、[ Microsoft Lync Server 2013] をクリックして、[ Lync Server 管理シェル] をクリックします。

  2. コマンド ライン プロンプトで次のように入力します。

    Get-CsClsConfiguration
    

New-CsClsConfiguration コマンドレットと Set-CsClsConfiguration コマンドレットを使用して、新しい構成を作成するか、既存の構成を更新します。

Get-CsClsConfiguration を実行すると、次のスクリーンショットに示すような情報が表示されます。現在、この展開には既定のグローバル構成がありますが、サイト構成は定義されていません。

Get-CsClsConfiguration からのサンプル出力。

コンピューターのローカル ストアから現在の一元的なログ サービス構成を取得するには

  1. Lync Server 管理シェルを起動する: [スタート] をクリックし、[ すべてのプログラム] をクリックし、[ Microsoft Lync Server 2013] をクリックして、[ Lync Server 管理シェル] をクリックします。

  2. コマンド ライン プロンプトで次のように入力します。

    Get-CsClsConfiguration -LocalStore
    

Get-CsClsConfiguration でパラメーターが指定されていない最初の例を使用すると、コマンドはデータの中央管理ストアを参照します。 パラメーター –LocalStore を指定した場合、このコマンドは中央管理ストアの代わりにコンピューター LocalStore を参照します。

現在定義されているシナリオの一覧を取得するには

  1. Lync Server 管理シェルを起動する: [スタート] をクリックし、[ すべてのプログラム] をクリックし、[ Microsoft Lync Server 2013] をクリックして、[ Lync Server 管理シェル] をクリックします。

  2. コマンド ライン プロンプトで次のように入力します。

    Get-CsClsConfiguration -Identity <scope and name> | Select-Object -ExpandProperty Scenarios
    

    たとえば、グローバル スコープで定義されているシナリオを取得するには、次のように入力します。

    Get-CsClsConfiguration -Identity "global" | Select-Object -ExpandProperty Scenarios
    

Get-CsClsConfiguration コマンドレットを使用すると、特定のスコープの構成に含まれるシナリオが常に表示されます。 ほとんどの場合、シナリオがすべて表示されるのではなく、一部が切り捨てられます。 ここで使用するコマンドは、すべてのシナリオおよび使用されているプロバイダー、設定、およびフラグに関する一部の情報を一覧表示します。

Windows PowerShellを使用して一元化ログ サービスのグローバル スコープを更新するには

  1. Lync Server 管理シェルを起動する: [スタート] をクリックし、[ すべてのプログラム] をクリックし、[ Microsoft Lync Server 2013] をクリックして、[ Lync Server 管理シェル] をクリックします。

  2. コマンド ライン プロンプトで次のように入力します。

    Set-CsClsConfiguration -Identity <scope> -EtlFileRolloverSizeMB <size for logging file in megabytes>
    

    次に例を示します。

    Set-CsClsConfiguration -Identity "global" -EtlFileRolloverSizeMB 40
    

このコマンドは、トレース ファイルのロールオーバーのサイズを 40 MB に設定するよう、展開内の各コンピューターおよびプールの CLSAgent に指示します。 すべてのサイトのコンピューターとプールがこのコマンドの対象となり、コンピューターとプールの構成済みのトレース ログのロールオーバーの値が 40 MB に設定されます。

Windows PowerShellを使用して一元化ログ サービスのサイト スコープを更新するには

  1. Lync Server 管理シェルを起動する: [スタート] をクリックし、[ すべてのプログラム] をクリックし、[ Microsoft Lync Server 2013] をクリックして、[ Lync Server 管理シェル] をクリックします。

  2. コマンド ライン プロンプトで次のように入力します。

    Set-CsClsConfiguration -Identity <scope/site name> -EtlFileRolloverSizeMB <size for logging file in megabytes> -EtlFileFolder <default location %TEMP%\Tracing>
    

    次に例を示します。

    Set-CsClsConfiguration -Identity "site/Redmond" -EtlFileRolloverSizeMB 40 -EtlFileFolder "C:\LogFiles\Tracing" 
    

    注意

    この例に示すように、ログ ファイルの既定の場所は %TEMP%\Tracing です。 ただし、これは実際にはファイルを書き込む CLSAgent であり、CSLAgent はネットワーク サービスとして実行されるため、%TEMP% 変数は %WINDIR%\ServiceProfiles\NetworkService\AppData\Local に展開されます。

このコマンドは、トレース ファイルのロールオーバーのサイズを 40 MB に設定するよう、Redmond サイト内の各コンピューターおよびプールの CLSAgent に指示します。 他のサイトのコンピューターとプールはこのコマンドの対象ではなく、現在構成されているトレース ログのロールオーバーの値 (既定値の 20 MB またはログ記録セッションの開始時に定義された値) が引き続き使用されます。

新しい一元的なログ サービス構成を作成するには

  1. Lync Server 管理シェルを起動する: [スタート] をクリックし、[ すべてのプログラム] をクリックし、[ Microsoft Lync Server 2013] をクリックして、[ Lync Server 管理シェル] をクリックします。

  2. コマンド ライン プロンプトで次のように入力します。

    New-CsClsConfiguration -Identity <scope and name> [CsClsConfiguration options for this site]
    

    注意

    New-CsClsConfiguration を使用すると、オプションの多数の構成設定にアクセスできます。 構成オプションの詳細については、「Lync Server 2013 の Get-CsClsConfigurationUnderstanding Centralized Logging Service 構成設定」を参照してください。

    たとえば、キャッシュ ファイル用のネットワーク フォルダー、ログ ファイルのロールオーバー時間、およびログ ファイルのロールオーバー サイズを定義する新しい構成を作成するには、次のように入力します。

    New-CsClsConfiguration -Identity "site:Redmond" -CacheFileNetworkFolder "\\fs01.contoso.net\filestore\logfiles" -EtlFileRolloverMinutes 120 -EtlFileRolloverSizeMB 40
    

新しい構成の作成と、集中ログ サービスの新しいプロパティの定義方法を慎重に計画する必要があります。 変更は慎重に行い、問題のシナリオのログを適切に記録する機能に及ぼす影響について理解しておいてください。 ログの管理機能を強化する、つまり発生した問題を解決するためのサイズおよびロールオーバー時間を定義できるように構成を変更する必要があります。

既存の集中ログ サービス構成を削除するには

  1. Lync Server 管理シェルを起動する: [スタート] をクリックし、[ すべてのプログラム] をクリックし、[ Microsoft Lync Server 2013] をクリックして、[ Lync Server 管理シェル] をクリックします。

  2. コマンド ライン プロンプトで次のように入力します。

    Remove-CsClsConfiguration -Identity <scope and name>
    

    たとえば、ログ ファイルのロールオーバー時間を長くするために作成した一元的なログ サービス構成を削除するには、ロールオーバー ログ ファイル サイズを増やし、ログ ファイル キャッシュの場所を次のようにネットワーク共有に設定します。

    Remove-CsClsConfiguration -Identity "site:Redmond"
    

    注意

    これは、「新しい一元的なログ サービス構成を作成するには」の手順で作成された新しい構成です。

サイト レベルの構成の削除を選択すると、そのサイトではグローバル設定が使用されます。