Get-SPLogEvent

リファレンス

モジュール:: sharepoint-server

適用対象:: SharePoint Server Subscription Edition

統合ログサービス (ULS) トレースログの結果を取得します。

構文

Get-SPLogEvent
   [-AssignmentCollection <SPAssignmentCollection>]
   [-AsString]
   [-ContextKey <String[]>]
   [-Directory <String>]
   [-MinimumLevel <String>]
   [-EndTime <DateTime>]
   [-StartTime <DateTime>]
   [<CommonParameters>]

Get-SPLogEvent
   [-AssignmentCollection <SPAssignmentCollection>]
   [-AsString]
   [-ContextKey <String[]>]
   [-MinimumLevel <String>]
   [-EndTime <DateTime>]
   [-File <String>]
   [-StartTime <DateTime>]
   [<CommonParameters>]

説明

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

Get-SPLogEvent コマンドレットでは、条件に一致する ULS トレースログファイルのレコードを取得します。パラメーターを指定しない場合は、すべてのログファイルのすべてのレコードが取得されます。 StartTime パラメーターと EndTime パラメーターは、時間範囲でフィルター処理する場合に使用します。このコマンドレットのパフォーマンスを最適化するために、これらのパラメーターを使用することをお勧めします。

Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「SharePoint Server コマンドレット」のオンラインドキュメントをご覧ください。

例

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

Get-SPLogEvent -MinimumLevel "Warning"

この例では、既定のログディレクトリに含まれる重要度が警告以上のログエントリをすべて取得します。

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

Get-SPLogEvent -Directory "C:\Logs" | Where-Object {$_.Level -eq "Warning"}

この例では、C:\Logs ディレクトリのログファイルに含まれるすべての警告エントリを取得します。

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

Get-SPLogEvent -StartTime "12/04/2007 17:00" -EndTime "12/04/2007 18:00"

この例では、米国固有の形式で指定した特定の時間範囲内で発生したエラーエントリを取得します。

-------------- 例 4 -----------------

Get-SPLogEvent -ContextKey @("UserName" ,"SiteName")

この例では、最新のログファイルのコンテンツを取得し、指定したコンテキストキーデータを追加します。

-------------- 例 5 -----------------

Get-SPLogEvent | Where-Object {$_.Level -eq "Error" -and {$_.Area -eq "SharePoint Foundation "}

この例では、SharePoint Foundation に関連するエラーエントリをすべて取得します。

-------------- 例 6 -----------------

Get-SPLogEvent -ContextKey @("Name") | %{$_.ToString() + "'t" + $_.Context["Name"]}

この例では、ログファイルのコンテンツを取得し、コンテキストデータを追加します。

パラメーター

-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 Subscription Edition

-AsString

各レコードを個別の文字列として取得します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-ContextKey

指定したコンテキストキーの結果にコンテキストデータを追加するように指定します (例: -ContextKey @("UserName", "SiteName"))。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Directory

代替ディレクトリ (設定した LogLocation ディレクトリ以外のディレクトリ) のログファイルを一覧表示します。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-EndTime

この型は、管理言語に固有の有効な DateTime 形式であることが必要です。たとえば、英語 (米国) の場合は 2/16/2007 12:15:12 です。

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-File

レコードのクエリを実行する特定のファイルを指定します。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-MinimumLevel

Returns records at or above the specified level. 有効な値は Error または Warning です。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-StartTime