Write-Debug (Microsoft.PowerShell.Utility)

Write-Debug

โมดูล :

Microsoft.PowerShell.Utility

เขียนข้อความดีบักไปยังคอนโซล

ไวยากรณ์

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

คำอธิบาย

Write-Debug cmdlet เขียนข้อความดีบักไปยังโฮสต์จากสคริปต์หรือคำสั่ง

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

ตัวอย่าง

ตัวอย่างที่ 1: ทำความเข้าใจ $DebugPreference

ตัวอย่างนี้เขียนข้อความดีบัก

Write-Debug "Cannot open file."

ค่าเริ่มต้นของ $DebugPreference คือ SilentlyContinue ดังนั้นข้อความจึงไม่แสดงในคอนโซล

ตัวอย่างที่ 2: เปลี่ยนค่าของ $DebugPreference

ตัวอย่างนี้แสดงผลของการเปลี่ยนแปลงค่าของตัวแปร $DebugPreference ขั้นแรก เราแสดงค่าปัจจุบันของ $DebugPreference และพยายามเขียนข้อความดีบัก จากนั้นเราเปลี่ยนค่าของ $DebugPreference เป็น ดำเนินการต่อ ซึ่งช่วยให้สามารถแสดงข้อความแก้ไขข้อบกพร่องได้

PS> $DebugPreference
SilentlyContinue
PS> Write-Debug "Cannot open file."
PS>
PS> $DebugPreference = "Continue"
PS> Write-Debug "Cannot open file."
DEBUG: Cannot open file.

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

ตัวอย่างที่ 3: ใช้พารามิเตอร์ Debug เพื่อแทนที่ $DebugPreference

ฟังก์ชัน Test-Debug เขียนค่าของตัวแปร $DebugPreference ไปยังโฮสต์ PowerShell และสตรีม Debug ในตัวอย่างนี้ เราใช้พารามิเตอร์ Debug เพื่อแทนที่ค่า $DebugPreference

function Test-Debug {
    [CmdletBinding()]
    param()
    Write-Debug ('$DebugPreference is ' + $DebugPreference)
    Write-Host ('$DebugPreference is ' + $DebugPreference)
}

PS> Test-Debug
$DebugPreference is SilentlyContinue

PS> Test-Debug -Debug
DEBUG: $DebugPreference is Continue
$DebugPreference is Continue
PS> $DebugPreference
SilentlyContinue

โปรดสังเกตว่าค่าของ $DebugPreference เปลี่ยนแปลงเมื่อคุณใช้พารามิเตอร์ Debug การเปลี่ยนแปลงนี้ส่งผลต่อขอบเขตของฟังก์ชันเท่านั้น ค่าจะไม่ได้รับผลกระทบภายนอกฟังก์ชัน

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

พารามิเตอร์

-Message

ระบุข้อความดีบักที่จะส่งไปยังคอนโซล

พิมพ์ :

String

นามแฝง :

Msg

ตำแหน่ง:

0

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

None

ที่จำเป็น:

True

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

True

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

False

อินพุต

สตริง

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

เอาท์พุต

ไม่มี

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