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 |