Start-Trace

モジュール:
PSDiagnostics Module

イベント トレース ログ セッションを開始します。

構文

Default (既定) 

Start-Trace
    [-SessionName] <String>
    [[-OutputFilePath] <String>]
    [[-ProviderFilePath] <String>]
    [-ETS]
    [-Format <String>]
    [-MinBuffers <Int32>]
    [-MaxBuffers <Int32>]
    [-BufferSizeInKB <Int32>]
    [-MaxLogFileSizeInMB <Int32>]
    [<CommonParameters>]

説明

このコマンドレットは、Windows プラットフォームでのみ使用できます。

このコマンドレットは、Windows イベント トレース ログ セッションを開始します。

このコマンドレットは、次のコマンドレットで使用されます。

  • Enable-PSWSManCombinedTrace
  • Enable-WSManTrace

このコマンドレットは、管理者特権の PowerShell セッションから実行する必要があります。

例

例 1: WSMan トレース ログ セッションを開始する

$parameters = @{
    SessionName         = 'wsmlog'
    ETS                 = $true
    OutputFilePath      = "$Env:windir\system32\wsmtraces.log"
    Format              = 'bincirc'
    MinBuffers          = 16
    MaxBuffers          = 256
    BufferSizeInKb      = 64
    MaxLogFileSizeInMB  = 256
    ProviderFilePath    = "$Env:windir\system32\wsmtraceproviders.txt"
}
Start-Trace @parameters

パラメーター

-BufferSizeInKB

イベント トレース セッションのバッファー サイズ (KB 単位)。

パラメーターのプロパティ

型:Int32
規定値:0
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ETS

保存やスケジュールを設定せずに、コマンドをイベント トレース セッションに直接送信します。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Format

データ コレクターのログ形式を指定します。 SQL データベース形式の場合は、コマンド ラインの OutputFilePath オプションを dsn!log 値と共に使用する必要があります。 既定値はバイナリ (bin) です。 指定できる値は次のとおりです。

  • bin - バイナリ
  • bincirc - 循環ログを含むバイナリ
  • csv - コンマ区切りの値
  • tsv - タブ区切りの値
  • sql - SQL データベース

パラメーターのプロパティ

型:Object
規定値:bin
指定可能な値:bin, bincirc, csv, tsv, sql
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-MaxBuffers

イベント トレース セッション バッファーの最大数を設定します。

パラメーターのプロパティ

型:Int32
規定値:256
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-MaxLogFileSizeInMB

SQL ログの最大ログ ファイル サイズ (MB) またはレコード数を設定します。

パラメーターのプロパティ

型:Int32
規定値:0 (no limit)
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-MinBuffers

イベント トレース セッション バッファーの最小数を設定します。

パラメーターのプロパティ

型:Int32
規定値:0
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-OutputFilePath

SQL データベース内の出力ログ ファイルまたは DSN とログ セット名のパス。 既定のパスは、$Env:SystemDrive\PerfLogs\Admin です。

パラメーターのプロパティ

型:String
規定値:$Env:SystemDrive\PerfLogs\Admin
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:1
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ProviderFilePath

有効にする複数のイベント トレース プロバイダーを一覧表示するファイル。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:2
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-SessionName

イベント トレース セッションの名前。 トレース セッションを停止するには、セッション名を知っている必要があります。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:0
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

None

このコマンドレットにオブジェクトをパイプすることはできません。

出力

None

このコマンドレットは出力を返しません。