Start-Trace

이벤트 추적 로깅 세션을 시작합니다.

구문

Default (기본값)

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

Description

이 cmdlet은 Windows 플랫폼에서만 사용할 수 있습니다.

이 cmdlet은 Windows 이벤트 추적 로깅 세션을 시작합니다.

이 cmdlet은 다음 cmdlet에서 사용됩니다.

  • Enable-PSWSManCombinedTrace
  • Enable-WSManTrace

높은 권한 PowerShell 세션에서 이 cmdlet을 실행해야 합니다.

예제

예제 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
Default value:0
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ETS

저장하거나 예약하지 않고 이벤트 추적 세션에 직접 명령을 보냅니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Format

데이터 수집기에 대 한 로그 형식을 지정합니다. SQL 데이터베이스 형식의 경우 명령줄에서 OutputFilePath 옵션을 dsn!log 값과 함께 사용해야 합니다. 기본값은 이진(bin)입니다. 가능한 값은 다음과 같습니다.

  • bin - 바이너리
  • bincirc - 순환 로깅이 있는 이진 파일
  • csv - 쉼표로 구분된 값
  • tsv - 탭으로 구분된 값
  • sql - SQL 데이터베이스

매개 변수 속성

형식:Object
Default value:bin
허용되는 값:bin, bincirc, csv, tsv, sql
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-MaxBuffers

이벤트 추적 세션 버퍼의 최대 수를 설정합니다.

매개 변수 속성

형식:Int32
Default value:256
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-MaxLogFileSizeInMB

최대 로그 파일 크기(MB) 또는 SQL 로그에 대한 레코드 수를 설정합니다.

매개 변수 속성

형식:Int32
Default value:0 (no limit)
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-MinBuffers

이벤트 추적 세션 버퍼의 최소 수를 설정합니다.

매개 변수 속성

형식:Int32
Default value:0
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-OutputFilePath

SQL 데이터베이스의 출력 로그 파일 또는 DSN 및 로그 집합 이름의 경로입니다. 기본 경로는 $Env:SystemDrive\PerfLogs\Admin입니다.

매개 변수 속성

형식:String
Default value:$Env:SystemDrive\PerfLogs\Admin
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:1
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ProviderFilePath

사용하도록 설정할 여러 이벤트 추적 공급자를 나열하는 파일입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:2
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-SessionName

이벤트 추적 세션의 이름입니다. 추적 세션을 중지하려면 세션 이름을 알고 있어야 합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:0
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

None

개체를 이 cmdlet에 파이프로 연결할 수 없습니다.

출력

None

이 cmdlet은 출력을 반환하지 않습니다.