Write-Warning
Menulis pesan peringatan.
Sintaks
Default (Default)
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.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | Msg |
Set parameter
(All)
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.
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.
