다음을 통해 공유

Write-Warning

  • 참조
모듈:
Microsoft.PowerShell.Utility

경고 메시지를 씁니다.

구문

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

Description

쓰기-경고 cmdlet은 Windows PowerShell 호스트에 경고 메시지를 씁니다. 경고에 대한 응답은 사용자의 $WarningPreference 변수 값과 WarningAction 공통 매개 변수의 사용에 따라 달라집니다.

예제

예제 1: 경고 메시지 작성

PS C:\> Write-Warning "This is only a test warning."

이 명령은 "경고: 테스트 경고일 뿐입니다."라는 메시지를 표시합니다.

예제 2: 문자열을 Write-Warning 전달

PS C:\> $w = "This is only a test warning."
PS C:\> $w | Write-Warning

이 명령은 파이프라인 연산자(|)를 사용하여 쓰기 경고문자열을 보낼 수 있음을 보여 줍니다. 이 명령에 표시된 대로 변수에 문자열을 저장하거나 문자열을 직접 파이프하여 쓰기 경고수 있습니다.

예제 3: $WarningPreference 변수 설정 및 경고 작성

PS C:\> $warningpreference
Continue PS C:\> Write-Warning "This is only a test warning."
This is only a test warning. PS C:\> $warningpreference = "SilentlyContinue"
PS C:\> Write-Warning "This is only a test warning."
PS C:\>
PS C:\> $warningpreference = "Stop"
PS C:\> Write-Warning "This is only a test warning."
WARNING: This is only a test message.
Write-Warning : Command execution stopped because the shell variable "WarningPreference" is set to Stop.
At line:1 char:14
     + Write-Warning <<<<  "This is only a test message."

이 예제에서는 Write-Warning 명령에 대한 $WarningPreference 변수 값의 효과를 보여줍니다.

첫 번째 명령은 $WarningPreference 변수의 기본값인 Continue를 표시합니다. 따라서 경고를 작성하면 경고 메시지가 표시되고 실행이 계속됩니다.

$WarningPreference 변수의 값을 변경하면 Write-Warning 명령의 효과가 다시 변경됩니다. SilentlyContinue 값은 경고를 표시하지 않습니다. 중지 값은 경고를 표시한 다음 명령 실행을 중지합니다.

$WarningPreference 변수에 대한 자세한 내용은 about_Preference_Variables 참조하세요.

예제 4: WarningAction 매개 변수 설정 및 경고 작성

PS C:\> Write-Warning "This is only a test warning." -WarningAction Inquire
WARNING: This is only a test warning.
Confirm
Continue with this operation?
 [Y] Yes  [A] Yes to All  [H] Halt Command  [S] Suspend  [?] Help (default is "Y"):

이 예제에서는 Write-Warning 명령에 WarningAction 공통 매개 변수의 효과를 보여줍니다. WarningAction 공통 매개 변수를 cmdlet과 함께 사용하여 Windows PowerShell이 해당 명령으로 인한 경고에 응답하는 방법을 확인할 수 있습니다. WarningAction 공통 매개 변수는 해당 특정 명령에 대해서만 $WarningPreference 값을 재정의합니다.

이 명령은 Write-Warning cmdlet을 사용하여 경고를 표시합니다. WarningAction 값이 Inquire인 공통 매개 변수는 명령이 경고를 표시할 때 사용자에게 메시지를 표시하도록 시스템에 지시합니다.

WarningAction 일반적인 매개 변수에 대한 자세한 내용은 about_CommonParameters 참조하세요.

매개 변수

-Message

경고 메시지를 지정합니다.

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

입력

String

경고가 포함된 문자열을 쓰기 경고파이프할 수 있습니다.

출력

None

쓰기-경고 경고 스트림에만 씁니다. 다른 출력은 생성하지 않습니다.

참고

  • $WarningPreference 변수의 기본값은 Continue로, 경고를 표시한 다음 명령을 계속 실행합니다. $WarningPreference 같은 기본 설정 변수에 유효한 값을 확인하려면 "abc"와 같은 임의의 문자 문자열로 설정합니다. 결과 오류 메시지에 유효한 값이 나열됩니다.