Add-SPDiagnosticsPerformanceCounter

パフォーマンス カウンターの新しいインスタンスを Web フロントエンド コンピューターまたはデータベース サーバーに追加します。

構文

Add-SPDiagnosticsPerformanceCounter
   [-Category] <String>
   -Counter <String>
   [-AllInstances]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-DatabaseServer]
   [-WebFrontEnd]
   [-WhatIf]
   [<CommonParameters>]
Add-SPDiagnosticsPerformanceCounter
   [-Category] <String>
   [-Counter <String>]
   -Instance <String>
   [-AllInstances]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-DatabaseServer]
   [-WebFrontEnd]
   [-WhatIf]
   [<CommonParameters>]
Add-SPDiagnosticsPerformanceCounter
   [-Category] <String>
   [-Instance <String>]
   [-AllInstances]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-DatabaseServer]
   [-WebFrontEnd]
   [-WhatIf]
   -CounterList <String[]>
   [<CommonParameters>]

説明

このコマンドレットには、複数のパラメーター セットが含まれています。 使用できるのは、1 つのパラメーター セットのパラメーターだけであり、異なるパラメーター セットのパラメーターを組み合わせることはできません。 パラメーター セットの使用法に関する詳しい情報については、「コマンドレットのパラメーター セット」を参照してください。

Add-SPDiagnosticsPerformanceCounter コマンドレットでは、フロントエンド Web サーバーまたはデータベース サーバーにパフォーマンス カウンターを追加します。 パフォーマンス カウンターは、利用状況データベースで読み取られ、記録されます。 既定では、新しいパフォーマンス カウンターはファーム内のデータベース サーバーに追加されます。

------------------ 例 1 ------------------

C:\PS>Add-SPDiagnosticsPerformanceCounter -category ASP.NET -Counter "Requests Queued"

この例では、ASP.NET\Requests Queued という名前のカウンターをフロントエンド Web サーバーに追加します。

------------------ 例 2 ------------------

C:\PS>Add-SPDiagnosticsPerformanceCounter -category PhysicalDisk -counter "Avg. Disk Queue Length" -allinstances

この例では、Avg. Disk Queue Length カテゴリ内の PhysicalDisk カウンターのすべてのインスタンスをフロントエンド Web サーバーに追加します。

------------------ 例 3 ------------------

C:\PS>Add-SPDiagnosticsPerformanceCounter -category Processor -counter "% Processor Time" -instance "_Total" -databaseserver

この例では、Processor カテゴリの % Processor Time カウンターの _Total インスタンスをデータベース サーバーに追加します。

パラメーター

-AllInstances

対象の Web フロントエンド コンピューターまたはデータベース サーバーのカウンターのカテゴリおよび種類のすべてのインスタンスを収集します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-AssignmentCollection

適切な破棄を行うためにオブジェクトを管理します。 SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。 メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。 割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。

Global パラメーターが使用されている場合は、オブジェクトはすべてグローバル ストアに格納されます。 Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Category

対象の Web フロントエンド コンピューターまたはデータベースサーバーに追加するパフォーマンス カウンターのカテゴリを指定します。

この型は、パフォーマンス カウンターのカテゴリの有効な名前であることが必要です (ASP.NET、PhysicalDisk、Processor など)。

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

コマンドを実行する前に確認メッセージを表示します。 詳細については、次のコマンドを入力します。get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Counter

対象の Web フロントエンド コンピューターまたはデータベース サーバーに追加するカウンターの種類を指定します。

この型は、カウンターの種類の有効な名前であることが必要です (Requests Queued、Avg. Disk Queue Length、% Processor Time など)。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-CounterList

{{Fill CounterList Description}}

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-DatabaseServer

指定されたパフォーマンス カウンターをファーム内のすべてのデータベース サーバーに追加します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Instance

新しいパフォーマンス カウンターの表示名を指定します。

この型は、パフォーマンス カウンター インスタンスの有効な名前であることが必要です (Total_PerfCounter など)。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WebFrontEnd

指定されたパフォーマンス カウンターをファーム内のすべての Web フロントエンド コンピューターに追加します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WhatIf

コマンドを実行する代わりに、コマンドの実行結果を説明するメッセージを表示します。 詳細については、次のコマンドを入力します。get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019