다음을 통해 공유

Write-Verbose

모듈:
Microsoft.PowerShell.Utility Module

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

구문

Default (기본값) 

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

Description

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

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

예제

예제 1: 상태 메시지 작성

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

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

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

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

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

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

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

매개 변수

-Message

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False
별칭:메시지

매개 변수 집합

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

CommonParameters

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

입력

String

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

출력

None

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

참고

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