다음을 통해 공유


Write-Verbose

자세한 메시지 스트림에 텍스트를 씁니다.

구문

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

Description

cmdlet은 Write-Verbose PowerShell의 자세한 메시지 스트림에 텍스트를 씁니다. 일반적으로 자세한 메시지 스트림은 명령 처리에 대한 자세한 정보를 제공하는 데 사용됩니다.

기본적으로 자세한 메시지 스트림은 표시되지 않지만 변수 값을 변경하거나 명령에서 $VerbosePreference 자세한 정보 표시 공통 매개 변수를 사용하여 표시할 수 있습니다.

예제

예제 1: 상태 메시지 작성

Write-Verbose -Message "Searching the Application Event Log."
Write-Verbose -Message "Searching the Application Event Log." -Verbose

이러한 명령은 cmdlet을 Write-Verbose 사용하여 상태 메시지를 표시합니다. 기본적으로 메시지는 표시되지 않습니다.

두 번째 명령은 변수 값에 관계없이 자세한 메시지를 표시하는 자세한 정보 표시 공통 매개 변수를 $VerbosePreference 사용합니다.

예제 2: $VerbosePreference 설정하고 상태 메시지 작성

$VerbosePreference = "Continue"
Write-Verbose "Copying file $filename"

이러한 명령은 cmdlet을 Write-Verbose 사용하여 상태 메시지를 표시합니다. 기본적으로 메시지는 표시되지 않습니다.

첫 번째 명령은 기본 설정 변수에 $VerbosePreference Continue 값을 할당합니다. 기본값인 SilentlyContinue/&S는 자세한 메시지를 표시하지 않습니다. 두 번째 명령은 자세한 메시지를 씁니다.

매개 변수

-Message

표시할 메시지를 지정합니다. 이 매개 변수는 필수입니다. 메시지 문자열을 .에 파이프할 Write-Verbose수도 있습니다.

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

입력

String

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

출력

None

이 cmdlet은 출력을 반환하지 않습니다. 자세한 메시지 스트림에만 씁니다.

참고

  • 자세한 정보 표시 메시지는 명령에서 자세한 정보 표시 공통 매개 변수를 사용하는 경우에만 반환됩니다. 자세한 내용은 about_CommonParameters를 참조하세요.
  • Windows PowerShell 백그라운드 작업 및 원격 명령 $VerbosePreference 에서 작업 세션 및 원격 세션의 변수는 자세한 정보 표시 메시지가 기본적으로 표시되는지 여부를 결정합니다. 변수에 대한 $VerbosePreference 자세한 내용은 about_Preference_Variables 참조하세요.