Write-Warning (Microsoft.PowerShell.Utility)

Write-Warning

โมดูล :

Microsoft.PowerShell.Utility

เขียนข้อความแจ้งเตือน

ไวยากรณ์

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

คำอธิบาย

cmdlet Write-Warning เขียนข้อความเตือนไปยังโฮสต์ PowerShell การตอบสนองต่อคำเตือนขึ้นอยู่กับค่าของตัวแปร $WarningPreference ของผู้ใช้และการใช้พารามิเตอร์ทั่วไป WarningAction

ตัวอย่าง

ตัวอย่างที่ 1: เขียนข้อความเตือน

คำสั่งนี้แสดงข้อความ "คำเตือน: นี่เป็นเพียงคำเตือนการทดสอบเท่านั้น"

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

ตัวอย่างที่ 2: ส่งสตริงไปที่ Write-Warning

คำสั่งนี้แสดงว่าคุณสามารถใช้ตัวดำเนินการไปป์ไลน์ (|) เพื่อส่งสตริงไปที่ Write-Warning คุณสามารถบันทึกสตริงในตัวแปรได้ ดังที่แสดงในคำสั่งนี้ หรือไปป์สตริงไปที่ Write-Warning โดยตรง

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

ตัวอย่างที่ 3: ตั้งค่าตัวแปร $WarningPreference และเขียนคำเตือน

ตัวอย่างนี้แสดงผลของค่าของตัวแปร $WarningPreference บนคำสั่ง 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.

คำสั่งแรกจะแสดงค่าเริ่มต้นของตัวแปร $WarningPreference ซึ่งก็คือ Continue ด้วยเหตุนี้ เมื่อคุณเขียนคำเตือน ข้อความเตือนจะปรากฏขึ้นและการดำเนินการดำเนินต่อไป

เมื่อคุณเปลี่ยนค่าของตัวแปร $WarningPreference ผลของคำสั่ง Write-Warning จะเปลี่ยนอีกครั้ง ค่า SilentlyContinue ระงับคำเตือน ค่า Stop จะแสดงคำเตือนแล้วหยุดการทำงานของคำสั่ง

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับตัวแปร $WarningPreference โปรดดู about_Preference_Variables

ตัวอย่างที่ 4: ตั้งค่าพารามิเตอร์ WarningAction และเขียนคำเตือน

ตัวอย่างนี้แสดงผลของพารามิเตอร์ทั่วไป WarningAction บนคำสั่ง Write-Warning คุณสามารถใช้พารามิเตอร์ทั่วไป WarningAction กับ cmdlet ใดก็ได้เพื่อกำหนดวิธีที่ PowerShell ตอบสนองต่อคำเตือนที่เกิดจากคำสั่งนั้น พารามิเตอร์ทั่วไป WarningAction จะแทนที่ค่าของ $WarningPreference สำหรับคำสั่งนั้นเท่านั้น

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

คำสั่งนี้ใช้ cmdlet Write-Warning เพื่อแสดงคำเตือน พารามิเตอร์ทั่วไป WarningAction ที่มีค่า Inquire จะทำให้ระบบแจ้งเตือนผู้ใช้เมื่อคำสั่งแสดงคำเตือน

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์ทั่วไป WarningAction โปรดดู about_CommonParameters

พารามิเตอร์

-Message

ระบุข้อความเตือน

พิมพ์ :

String

นามแฝง :

Msg

ตำแหน่ง:

0

ค่าเริ่มต้น:

None

ที่จำเป็น:

True

ยอมรับอินพุตไปป์ไลน์:

True

ยอมรับอักขระตัวแทน:

False

อินพุต

สตริง

คุณสามารถไปป์สตริงที่ประกอบด้วยคำเตือนไปยัง cmdlet นี้

เอาท์พุต

ไม่มี

cmdlet นี้ส่งคืนไม่มีผลลัพธ์ มันเขียนไปยังสตรีมคำเตือนเท่านั้น

หมายเหตุ

ค่าเริ่มต้นสำหรับตัวแปร $WarningPreference คือ ดำเนินการต่อ ซึ่งจะแสดงคำเตือนแล้วดำเนินการคำสั่งต่อไป หากต้องการกำหนดค่าที่ถูกต้องสำหรับตัวแปรการกำหนดลักษณะ เช่น $WarningPreference ให้ตั้งค่าเป็นสตริงอักขระแบบสุ่ม เช่น "abc" ข้อความแสดงข้อผิดพลาดผลลัพธ์จะแสดงรายการค่าที่ถูกต้อง