Bagikan melalui

Start-Trace

Modul:
PSDiagnostics Module

Mulai sesi pengelogan Jejak Peristiwa.

Sintaks

Default (Default) 

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

Deskripsi

Cmdlet ini hanya tersedia di platform Windows.

Cmdlet ini memulai sesi pengelogan Windows Event Trace.

Cmdlet ini digunakan oleh cmdlet berikut:

  • Enable-PSWSManCombinedTrace
  • Enable-WSManTrace

Anda harus menjalankan cmdlet ini dari sesi PowerShell yang ditingkatkan.

Contoh

Contoh 1: Memulai sesi pengelogan Jejak 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

Parameter

-BufferSizeInKB

Ukuran buffer Sesi Pelacakan Peristiwa dalam kilobyte (KB).

Properti parameter

Jenis:Int32
Nilai default:0
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-ETS

Kirim perintah ke Sesi Pelacakan Peristiwa secara langsung tanpa menyimpan atau menjadwalkan.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Format

Menentukan format log untuk pengumpul data. Untuk format database SQL, Anda harus menggunakan opsi OutputFilePath di baris perintah dengan nilai . Defaultnya adalah biner (bin). Nilai yang mungkin adalah:

  • bin - biner
  • bincirc - biner dengan pengelogan melingkar
  • csv - Nilai yang dipisahkan koma
  • tsv - Nilai yang dipisahkan tab
  • sql - Database SQL

Properti parameter

Jenis:Object
Nilai default:bin
Nilai yang diterima:bin, bincirc, csv, tsv, sql
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-MaxBuffers

Mengatur jumlah maksimum buffer Sesi Jejak Peristiwa.

Properti parameter

Jenis:Int32
Nilai default:256
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-MaxLogFileSizeInMB

Mengatur ukuran file log maksimum dalam megabyte (MB) atau jumlah rekaman untuk log SQL.

Properti parameter

Jenis:Int32
Nilai default:0 (no limit)
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-MinBuffers

Mengatur jumlah minimum buffer Sesi Jejak Peristiwa.

Properti parameter

Jenis:Int32
Nilai default:0
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-OutputFilePath

Jalur file log output atau DSN dan nama kumpulan log dalam database SQL. Jalur default adalah $Env:SystemDrive\PerfLogs\Admin.

Properti parameter

Jenis:String
Nilai default:$Env:SystemDrive\PerfLogs\Admin
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:1
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-ProviderFilePath

File yang mencantumkan beberapa penyedia Pelacakan Peristiwa untuk diaktifkan.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:2
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-SessionName

Nama sesi Pelacakan Peristiwa. Untuk menghentikan sesi pelacakan, Anda harus mengetahui nama sesi.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:0
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

None

Cmdlet ini tidak mengembalikan output.