Write-Warning

Menulis pesan peringatan.

Sintaks

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

Deskripsi

Write-Warning Cmdlet menulis pesan peringatan ke host PowerShell. Respons terhadap peringatan tergantung pada nilai variabel pengguna $WarningPreference dan penggunaan parameter umum WarningAction .

Contoh

Contoh 1: Menulis pesan peringatan

Perintah ini menampilkan pesan "PERINGATAN: Ini hanya peringatan pengujian."

Write-Warning "This is only a test warning."

Contoh 2: Meneruskan string ke Write-Warning

Perintah ini menunjukkan bahwa Anda dapat menggunakan operator alur (|) untuk mengirim string ke Write-Warning. Anda dapat menyimpan string dalam variabel, seperti yang ditunjukkan dalam perintah ini, atau menyalurkan string langsung ke Write-Warning.

$w = "This is only a test warning."
$w | Write-Warning

Contoh 3: Atur variabel $WarningPreference dan tulis peringatan

Contoh ini menunjukkan efek nilai $WarningPreference variabel pada Write-Warning perintah.

PS> $WarningPreference
Continue
PS> Write-Warning "This is only a test warning."
This is only a test warning.
PS> $WarningPreference = "SilentlyContinue"
PS> Write-Warning "This is only a test warning."
PS> $WarningPreference = "Stop"
PS> Write-Warning "This is only a test warning."
WARNING: This is only a test warning.
Write-Warning: The running command stopped because the preference variable "WarningPreference" or common parameter is set to Stop: This is only a test warning.

Perintah pertama menampilkan nilai $WarningPreference default variabel, yaitu Continue. Akibatnya, ketika Anda menulis peringatan, pesan peringatan ditampilkan dan eksekusi berlanjut.

Saat Anda mengubah nilai $WarningPreference variabel, efek Write-Warning perintah berubah lagi. Nilai SilentlyContinue menekan peringatan. Nilai Stop menampilkan peringatan lalu menghentikan eksekusi perintah.

Untuk informasi selengkapnya tentang $WarningPreference variabel , lihat about_Preference_Variables.

Contoh 4: Atur parameter WarningAction dan tulis peringatan

Contoh ini menunjukkan efek parameter umum WarningAction pada Write-Warning perintah. Anda dapat menggunakan parameter umum WarningAction dengan cmdlet apa pun untuk menentukan bagaimana PowerShell merespons peringatan yang dihasilkan dari perintah tersebut. Parameter umum WarningAction mengambil alih nilai satu-satunya $WarningPreference untuk perintah tertentu tersebut.

PS> 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"):

Perintah ini menggunakan Write-Warning cmdlet untuk menampilkan peringatan. Parameter umum WarningAction dengan nilai Inquire mengarahkan sistem untuk meminta pengguna saat perintah menampilkan peringatan.

Untuk informasi selengkapnya tentang parameter umum WarningAction , lihat about_CommonParameters.

Parameter

-Message

Menentukan pesan peringatan.

Type:String
Aliases:Msg
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

Input

String

Anda dapat menyalurkan string yang berisi peringatan ke Write-Warning.

Output

None

Write-Warning hanya menulis ke aliran peringatan. Ini tidak menghasilkan output lain.

Catatan

Nilai default untuk $WarningPreference variabel adalah Continue, yang menampilkan peringatan dan kemudian melanjutkan menjalankan perintah. Untuk menentukan nilai yang valid untuk variabel preferensi seperti $WarningPreference, atur ke string karakter acak, seperti "abc". Pesan kesalahan yang dihasilkan mencantumkan nilai yang valid.