ค้นหาเว็บไซต์

Write-Verbose (Microsoft.PowerShell.Utility)


Write-Verbose

โมดูล :
Microsoft.PowerShell.Utility

เขียนข้อความลงในสตรีมข้อความแบบละเอียด

ไวยากรณ์

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

คำอธิบาย

cmdlet Write-Verbose เขียนข้อความไปยังสตรีมข้อความ verbose ใน PowerShell โดยทั่วไปแล้ว สตรีมข้อความแบบละเอียดจะใช้เพื่อส่งมอบข้อมูลเชิงลึกเกี่ยวกับการประมวลผลคำสั่ง

ตามค่าเริ่มต้น สตรีมข้อความแบบละเอียดจะไม่แสดง แต่คุณสามารถแสดงได้โดยการเปลี่ยนค่าของตัวแปร $VerbosePreference หรือใช้พารามิเตอร์ทั่วไป Verbose ในคำสั่งใดๆ

ตัวอย่าง

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

Write-Verbose -Message "Searching the Application Event Log."
Write-Verbose -Message "Searching the Application Event Log." -Verbose

คำสั่งเหล่านี้ใช้ cmdlet Write-Verbose เพื่อแสดงข้อความสถานะ ตามค่าเริ่มต้น ข้อความจะไม่แสดง

คำสั่งที่สองใช้พารามิเตอร์ทั่วไป Verbose ซึ่งแสดงข้อความที่มีรายละเอียดใดๆ โดยไม่คำนึงถึงค่าของตัวแปร $VerbosePreference

ตัวอย่างที่ 2: ตั้งค่า $VerbosePreference และเขียนข้อความสถานะ

$VerbosePreference = "Continue"
Write-Verbose "Copying file $filename"

คำสั่งเหล่านี้ใช้ cmdlet Write-Verbose เพื่อแสดงข้อความสถานะ ตามค่าเริ่มต้น ข้อความจะไม่แสดง

คำสั่งแรกกำหนดค่า Continue ให้กับตัวแปรการตั้งค่า $VerbosePreference ค่าเริ่มต้น SilentlyContinue ระงับข้อความที่มีรายละเอียด คำสั่งที่สองเขียนข้อความอย่างละเอียด

พารามิเตอร์

-Message

ระบุข้อความที่จะแสดง จำเป็นต้องมีพารามิเตอร์นี้ คุณยังสามารถไพพ์สตริงข้อความไปที่ Write-Verbose

พิมพ์ :

String

นามแฝง :

Msg

ตำแหน่ง:

0

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

None

ที่จำเป็น:

True

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

True

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

False

อินพุต

สตริง

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

เอาท์พุต

ไม่มี

cmdlet นี้ส่งคืนไม่มีผลลัพธ์ จะเขียนเฉพาะสตรีมข้อความแบบละเอียดเท่านั้น

หมายเหตุ

  • ข้อความแบบละเอียดจะถูกส่งกลับเมื่อคำสั่งใช้พารามิเตอร์ทั่วไป Verbose เท่านั้น สำหรับข้อมูลเพิ่มเติม โปรดดู about_CommonParameters
  • ในงานพื้นหลังของ Windows PowerShell และคำสั่งระยะไกล ตัวแปร $VerbosePreference ในเซสชันงานและเซสชันระยะไกลจะกำหนดว่าข้อความรายละเอียดจะแสดงตามค่าเริ่มต้นหรือไม่ สำหรับข้อมูลเพิ่มเติมเกี่ยวกับตัวแปร $VerbosePreference โปรดดู about_Preference_Variables

บทความที่เกี่ยวข้อง