Старт-Трассировка (PSDiagnostics)

Start-Trace

Модуль:: PSDдиагностика

Запустите сеанс регистрации трассировки событий.

Синтаксис

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 Trace.

$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

Размер буфера сеанса трассировки событий в килобайтах (КБ).

Тип :: Int32
Позиция:: Именованный
Значение по умолчанию:: 0
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-ETS

Отправляйте команды в сеансы трассировки событий напрямую, без сохранения или планирования.

Тип :: SwitchParameter
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-Format

Указывает формат журнала для сборщика данных. Для формата базы данных SQL необходимо использовать параметр OutputFilePath в командной строке со значением dsn!log. По умолчанию используется двоичный формат (bin). Возможные значения:

бин - двоичный
bincirc — двоичный файл с циклическим журналированием
csv — значения, разделенные запятыми
tsv — значения, разделенные табуляцией
sql — база данных SQL

Тип :: Объект
Принятые значения:: bin, bincirc, csv, tsv, sql
Позиция:: Именованный
Значение по умолчанию:: мусорное ведро
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-MaxBuffers

Устанавливает максимальное количество буферов сеанса трассировки событий.

Тип :: Int32
Позиция:: Именованный
Значение по умолчанию:: 256
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-MaxLogFileSizeInMB

Устанавливает максимальный размер файла журнала в мегабайтах (МБ) или количество записей для журналов SQL.

Тип :: Int32
Позиция:: Именованный
Значение по умолчанию:: 0 (без ограничений)
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-MinBuffers

Устанавливает минимальное количество буферов сеанса трассировки событий.

Тип :: Int32
Позиция:: Именованный
Значение по умолчанию:: 0
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-OutputFilePath

Путь к выходному файлу журнала или имя DSN и набора журналов в базе данных SQL. Путь по умолчанию — $env:systemdrive\PerfLogs\Admin.

Тип :: String
Позиция:: 1
Значение по умолчанию:: $env:systemdrive\PerfLogs\Admin
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-ProviderFilePath

Файл со списком нескольких поставщиков трассировки событий, которые необходимо включить.

Тип :: String
Позиция:: 2
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-SessionName

Имя сеанса трассировки событий. Чтобы остановить сеанс трассировки, вам необходимо знать имя сеанса.

Тип :: String
Позиция:: 0
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

Входы

Нет

Вы не можете передавать объекты в этот командлет.

Выходы

Нет

Этот командлет не возвращает никаких результатов.