콘솔에 디버그 메시지를 씁니다.
구문
Write-Debug [-Message] <string> [<CommonParameters>]
설명
Write-Debug cmdlet은 스크립트 또는 명령에서 콘솔로 디버그 메시지를 씁니다.
디버그 메시지는 기본적으로 콘솔에 표시되지 않지만 Debug 매개 변수 또는 $DebugPreference 변수를 사용하여 표시할 수 있습니다.
매개 변수
-Message <string>
콘솔에 보낼 디버그 메시지를 지정합니다.
|
필수 여부 |
true |
|
위치 |
1 |
|
기본값 |
|
|
파이프라인 입력 적용 여부 |
true (ByValue) |
|
와일드카드 문자 적용 여부 |
false |
<CommonParameters>
이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.
입력 및 출력
입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.
|
입력 |
System.String 디버그 메시지가 포함된 문자열을 Write-Debug로 파이프할 수 있습니다. |
|
출력 |
없음 Write-Debug는 디버그 스트림에만 기록하며 어떠한 출력도 반환하지 않습니다. |
예 1
C:\PS>Write-Debug "Cannot open file." 설명 ----------- 이 명령은 디버그 메시지를 씁니다. $DebugPreference의 값이 "SilentlyContinue"이므로 메시지는 콘솔에 표시되지 않습니다.
예 2
C:\PS>$DebugPreference SilentlyContinue C:\PS> Write-Debug "Cannot open file." C:\PS> C:\PS> Write-Debug "Cannot open file." -debug DEBUG: Cannot open file. 설명 ----------- 이 예는 Debug의 일반 매개 변수를 사용하여 특정 명령에 대해 $DebugPreference 변수 값을 재정의하는 방법을 보여 줍니다. 첫 번째 명령은 $DebugPreference 변수의 값(기본값인 "SilentlyContinue")을 표시합니다. 두 번째 명령은 디버그 메시지를 쓰지만 $DebugPreference의 값 때문에 메시지는 표시되지 않습니다. 세 번째 명령은 디버그 메시지를 씁니다. 이 명령은 Debug 일반 매개 변수를 사용하여 $DebugPreference의 값을 재정의하고 이 명령으로 인해 발생하는 디버그 메시지를 표시합니다. 따라서 $DebugPreference의 값이 "SilentlyContinue"임에도 불구하고 디버그 메시지가 표시됩니다. Debug 일반 매개 변수에 대한 자세한 내용은 about_CommonParameters를 참조하십시오.
예 3
C:\PS>$DebugPreference SilentlyContinue C:\PS> Write-Debug "Cannot open file." C:\PS> C:\PS> $DebugPreference = "Continue" C:\PS> Write-Debug "Cannot open file." DEBUG: Cannot open file. 설명 ----------- 이 명령은 $DebugPreference 변수 값을 변경하면 디버그 메시지 표시가 어떻게 달라지는지 보여 줍니다. 첫 번째 명령은 $DebugPreference 변수의 값(기본값인 "SilentlyContinue")을 표시합니다. 두 번째 명령은 디버그 메시지를 쓰지만 $DebugPreference의 값 때문에 메시지는 표시되지 않습니다. 세 번째 명령은 $DebugPreference 변수에 "Continue" 값을 할당합니다. 네 번째 명령은 디버그 메시지를 쓰며, 이 메시지는 콘솔에 나타납니다. $DebugPreference에 대한 자세한 내용은 about_Preference_Variables를 참조하십시오.
참고 항목