Bagikan melalui

Write-Warning

  • Referensi
Modul:
Microsoft.PowerShell.Utility

Menulis pesan peringatan.

Sintaks

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

Deskripsi

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

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 variabel $WarningPreference pada perintah Write-Warning.

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 default variabel $WarningPreference, yaitu Continue. Akibatnya, ketika Anda menulis peringatan, pesan peringatan ditampilkan dan eksekusi berlanjut.

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

Untuk informasi selengkapnya tentang variabel $WarningPreference, lihat about_Preference_Variables.

Contoh 4: Atur parameter WarningAction dan tulis peringatan

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

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 cmdlet Write-Warning untuk menampilkan peringatan. Parameter WarningAction umum 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.

Jenis:String
Alias:Msg
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

Input

String

Anda dapat menyalurkan string yang berisi peringatan ke cmdlet ini.

Output

None

Cmdlet ini tidak mengembalikan output. Ini hanya menulis ke aliran peringatan.

Catatan

Nilai default untuk variabel $WarningPreference adalah Continue, yang menampilkan peringatan lalu 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.