Windows PowerShell 구성 요소의 추적을 구성하고, 시작하고, 중지합니다.

구문

Set-TraceSource [[-Option] {<None> | <Constructor> | <Dispose> | <Finalizer> | <Method> | <Property> | <Delegates> | <Events> | <Exception> | <Lock> | <Error> | <Errors> | <Warning> | <Verbose> | <WriteLine> | <Data> | <Scope> | <ExecutionFlow> | <Assert> | <All>}] [-Debugger] [-FilePath <string>] [-Force] [-ListenerOption {<None> | <LogicalOperationStack> | <DateTime> | <Timestamp> | <ProcessId> | <ThreadId> | <Callstack>}] [-PassThru] [-PSHost] [-Name] <string[]> [<CommonParameters>]

Set-TraceSource [-RemoveListener <string[]>] [-Name] <string[]> [<CommonParameters>]

Set-TraceSource [-RemoveFileListener <string[]>] [-Name] <string[]> [<CommonParameters>]

설명

Set-TraceSource cmdlet은 Windows PowerShell 구성 요소의 추적을 구성하고, 시작하고, 중지합니다. 이 cmdlet을 사용하면 추적할 구성 요소 및 추적한 출력을 보낼 위치를 지정할 수 있습니다.

매개 변수

-Debugger

추적 출력을 디버거로 보냅니다. 사용자 모드 또는 커널 모드 디버거나 Microsoft Visual Studio에서 출력을 볼 수 있습니다. 이 매개 변수는 기본 추적 수신기도 선택합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-FilePath <string>

추적 출력을 지정된 파일로 보냅니다. 이 매개 변수는 파일 추적 수신기도 선택합니다. 이 매개 변수를 사용하여 추적을 시작하고 RemoveFileListener 매개 변수를 사용하여 추적을 중지합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Force

cmdlet이 읽기 전용 파일을 덮어쓸 수 있도록 합니다. FilePath 매개 변수와 함께 사용합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-ListenerOption <TraceOptions>

출력의 각 추적 메시지 접두사에 데이터를 선택적으로 추가합니다. 유효한 값은 "None", "LogicalOperationStack", "DateTime", "Timestamp", "ProcessId", "ThreadId" 및 "Callstack"입니다. "None"은 기본값입니다.

여러 옵션을 지정하려면 "ProcessID,ThreadID"와 같이 쉼표로 구분하고, 공백을 포함하지 않으며, 따옴표로 묶으십시오.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Name <string[]>

추적할 구성 요소를 결정합니다. 각 구성 요소의 추적 원본 이름을 입력합니다. 와일드카드를 사용할 수 있습니다.

필수 여부

true

위치

1

기본값

파이프라인 입력 적용 여부

true (ByValue, ByPropertyName)

와일드카드 문자 적용 여부

false

-Option <PSTraceSourceOptions>

추적할 이벤트의 유형을 결정합니다.

유효한 값은 "None", "Constructor", "Dispose", "Finalizer", "Method", "Property", "Delegates", "Events", "Exception", "Lock", "Error", "Errors", "Warning", "Verbose", "WriteLine", "Data", "Scope", "ExecutionFlow", "Assert" 및 "All"입니다. "All"이 기본값입니다.

다음 값은 다른 값의 조합입니다.

-- ExecutionFlow: (Constructor, Dispose, Finalizer, Method, Delegates, Events 및 Scope)

-- Data: (Constructor, Dispose, Finalizer, Property, Verbose 및 WriteLine)

-- Errors: (Error 및 Exception)

여러 옵션을 지정하려면 "Constructor,Dispose"와 같이 쉼표로 구분하고, 공백을 포함하지 않으며, 따옴표로 묶으십시오.

필수 여부

false

위치

2

기본값

파이프라인 입력 적용 여부

true (ByPropertyName)

와일드카드 문자 적용 여부

false

-PassThru

추적 세션을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet에서는 출력을 생성하지 않습니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-PSHost

추적 출력을 Windows PowerShell 호스트로 보냅니다. 이 매개 변수는 PSHost 추적 수신기도 선택합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-RemoveFileListener <string[]>

지정된 파일과 연결된 파일 추적 수신기를 제거하여 추적을 중지합니다. 추적 출력 파일의 경로와 파일 이름을 입력하십시오.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-RemoveListener <string[]>

추적 수신기를 제거하여 추적을 중지합니다.

RemoveListener에 다음 값을 사용합니다.

--PSHost(콘솔)를 제거하려면 "Host"를 입력합니다.

--디버거를 제거하려면 "Debug"를 입력합니다.

--모든 추적 수신기를 제거하려면 "*"를 입력합니다.

파일 추적 수신기를 제거하려면 RemoveFileListener 매개 변수를 사용합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.

입력 및 출력

입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

System.String

이름이 포함된 문자열을 Set-TraceSource로 파이프할 수 있습니다.

출력

없음 또는 System.Management.Automation.PSTraceSource

PassThru 매개 변수를 사용하는 경우 Set-TraceSource는 추적 세션을 나타내는 System.Management.Automation.PSTraceSource 개체를 생성합니다. 그렇지 않으면 아무 출력도 생성하지 않습니다.

참고

추적은 개발자가 디버깅하고 프로그램을 다듬는 데 사용하는 방법입니다. 추적하면 프로그램에서 내부 프로세스의 각 단계에 대한 세부 메시지를 생성합니다.

Windows PowerShell 추적 cmdlet은 Windows PowerShell 개발자용으로 만들어졌지만 모든 사용자가 사용할 수 있습니다. 이 cmdlet을 사용하면 Windows PowerShell 기능의 거의 모든 면을 모니터링할 수 있습니다.

"추적 원본"은 구성 요소에 대해 추적을 관리하고 추적 메시지를 생성하는 각 Windows PowerShell 구성 요소의 일부입니다. 구성 요소를 추적하려면 추적 원본을 확인합니다.

"추적 수신기"는 추적의 출력을 받아 사용자에게 표시합니다. System.Diagnostics.TraceListener 클래스에서 파생된 콘솔, 파일 또는 사용자 지정 수신기에 사용자 모드 또는 커널 모드 디버거를 보내도록 선택할 수 있습니다.

추적을 시작하려면 Name 매개 변수를 사용하여 추적 원본(추적할 구성 요소)을 지정하고 FilePath, Debugger 또는 PSHost 매개 변수를 사용하여 수신기(출력의 대상)를 지정합니다. Options 매개 변수를 사용하여 추적된 이벤트의 유형과 ListenerOptions 매개 변수를 확인하여 추적 출력을 구성합니다.

추적의 구성을 변경하려면 추적을 시작할 때 Set-TraceSource 명령을 입력합니다. Windows PowerShell에서 추적 원본이 이미 추적되었음을 인식합니다. 그 다음 추적을 중지하고 새 구성을 추가한 다음 추적을 시작하거나 다시 시작합니다.

추적을 중지하려면 RemoveListener 매개 변수를 사용합니다. 파일 수신기를 사용하는 추적(-FilePath 매개 변수를 사용하여 시작된 추적)을 중지하고 RemoveFileListener 매개 변수를 사용합니다. 수신기를 제거하면 추적이 중지됩니다.

추적할 수 있는 구성 요소를 확인하려면 Get-TraceSource를 사용합니다. 구성 요소를 사용할 때 각 모듈의 추적 원본이 자동으로 로드되며 Get-TraceSource의 출력으로 나타납니다.

예 1

C:\PS>Set-TraceSource -Name Parameterbinding -Option ExecutionFlow -PSHost '
-ListenerOption "ProcessID,TimeStamp"

설명
-----------
이 명령은 Windows PowerShell의 ParameterBinding 구성 요소에 대한 추적을 시작합니다. Name 매개 변수를 사용하여 추적 원본을 지정하고 Option 매개 변수를 사용하여 ExecutionFlow 추적 이벤트를 선택하며, PSHost 매개 변수를 사용하여 Windows PowerShell 호스트 수신기를 지정합니다. 그러면 출력이 콘솔로 전송됩니다. ListenerOption 매개 변수는 "ProcessID" 및 "TimeStamp" 값을 추적 메시지 접두사에 추가합니다.






예 2

C:\PS>set-tracesource -name ParameterBinding -RemoveListener Host

설명
-----------
이 명령은 Windows PowerShell의 ParameterBinding 구성 요소에 대한 추적을 중지합니다. Name 매개 변수를 사용하여 추적된 구성 요소를 확인하고 RemoveListener 매개 변수를 사용하여 추적 수신기를 확인합니다.






참고 항목




목차