Bagikan melalui

Write-Debug

Modul:
Microsoft.PowerShell.Utility Module

Menulis pesan debug ke konsol.

Sintaks

Default (Default) 

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

Deskripsi

Cmdlet Write-Debug menuliskan pesan debug dari skrip atau perintah ke host.

Secara default, pesan debug tidak ditampilkan di konsol, tetapi Anda dapat menampilkannya dengan menggunakan parameter debug atau variabel .

Contoh

Contoh 1: Memahami $DebugPreference

Contoh ini menghasilkan pesan debug.

Write-Debug "Cannot open file."

Nilai default $DebugPreference adalah SilentlyContinue. Oleh karena itu, pesan tidak ditampilkan di konsol.

Contoh 2: Mengubah nilai $DebugPreference

Contoh ini menunjukkan efek mengubah nilai variabel $DebugPreference. Pertama, kami menampilkan nilai $DebugPreference saat ini dan mencoba menulis pesan debug. Kemudian kita mengubah nilai $DebugPreference menjadi Lanjutkan, yang memungkinkan pesan debug ditampilkan.

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

Untuk informasi selengkapnya tentang $DebugPreference, lihat about_Preference_Variables.

Contoh 3: Gunakan parameter Debug untuk mengambil alih $DebugPreference

Fungsi Test-Debug menulis nilai variabel $DebugPreference ke host PowerShell dan ke aliran Debug. Dalam contoh ini, kita menggunakan parameter Debug untuk mengambil alih nilai .

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

Perhatikan bahwa nilai berubah saat Anda menggunakan parameter Debug. Perubahan ini hanya memengaruhi cakupan fungsi. Nilai tidak terpengaruh di luar fungsi.

Untuk informasi selengkapnya tentang parameter umum Debug, lihat about_CommonParameters.

Parameter

-Message

Menentukan pesan debug untuk dikirim ke konsol.

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 pesan debug ke cmdlet ini.

Output

None

Cmdlet ini tidak mengembalikan output. Ini hanya menulis ke aliran debug.