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 variabel, $WarningPreference
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 |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Input
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 $WarningPreference
variabel 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.
Link Terkait
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk