다음을 통해 공유


Write-Debug

콘솔에 디버그 메시지를 씁니다.

구문

Write-Debug
     [-Message] <String>
     [<CommonParameters>]

Description

cmdlet은 Write-Debug 스크립트 또는 명령에서 호스트에 디버그 메시지를 씁니다.

기본적으로 디버그 메시지는 콘솔에 표시되지 않지만 디버그 매개 변수 또는 $DebugPreference 변수를 사용하여 표시할 수 있습니다.

예제

예제 1: $DebugPreference 이해

이 예제에서는 디버그 메시지를 씁니다.

Write-Debug "Cannot open file."

기본값 $DebugPreference 은 SilentlyContinue입니다. 따라서 메시지가 콘솔에 표시되지 않습니다.

예제 2: $DebugPreference 값 변경

이 예제에서는 변수 값을 $DebugPreference 변경하는 효과를 보여줍니다. 먼저 현재 값을 $DebugPreference 표시하고 디버그 메시지를 작성하려고 시도합니다. 그런 다음 디버그 메시지를 표시할 수 있도록 값을 Continue로 변경 $DebugPreference 합니다.

PS> $DebugPreference
SilentlyContinue
PS> Write-Debug "Cannot open file."
PS>
PS> $DebugPreference = "Continue"
PS> Write-Debug "Cannot open file."
DEBUG: Cannot open file.

자세한 $DebugPreference내용은 about_Preference_Variables 참조하세요.

예제 3: 디버그 매개 변수를 사용하여 $DebugPreference 재정의

이 함수는 Test-Debug 변수 값을 $DebugPreference PowerShell 호스트 및 디버그 스트림에 씁니다. 이 예제에서는 Debug 매개 변수를 사용하여 값을 재정의합니다$DebugPreference.

function Test-Debug {
    [CmdletBinding()]
    param()
    Write-Debug ('$DebugPreference is ' + $DebugPreference)
    Write-Host ('$DebugPreference is ' + $DebugPreference)
}

PS> Test-Debug
$DebugPreference is SilentlyContinue

PS> Test-Debug -Debug
DEBUG: $DebugPreference is Inquire

Confirm
Continue with this operation?
[Y] Yes  [A] Yes to All  [H] Halt Command  [?] Help (default is "Y"):
$DebugPreference is Inquire
PS> $DebugPreference
SilentlyContinue

디버그 매개 변수를 사용할 때 변경되는 값을 $DebugPreference 확인합니다. 이 변경 내용은 함수의 범위에만 영향을 줍니다. 값은 함수 외부의 영향을 받지 않습니다.

참고 항목

$DebugPreference 이 Inquire면 PowerShell은 실행을 중지하여 실행을 계속해야 하는지 묻습니다.

디버그 공통 매개 변수에 대한 자세한 내용은 about_CommonParameters 참조하세요.

매개 변수

-Message

콘솔에 보낼 디버그 메시지를 지정합니다.

형식:String
별칭:Msg
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

입력

String

디버그 메시지가 포함된 문자열을 이 cmdlet으로 파이프할 수 있습니다.

출력

None

이 cmdlet은 출력을 반환하지 않습니다. 디버그 스트림에만 씁니다.