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 Inquire

Confirm
Continue with this operation?
[Y] Yes  [A] Yes to All  [H] Halt Command  [?] Help (default is "Y"):
$DebugPreference is Inquire
PS> $DebugPreference
SilentlyContinue

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

Nota

Ketika nilai $DebugPreferenceInquire, PowerShell menghentikan eksekusi untuk menanyakan apakah eksekusi harus dilanjutkan.

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

Kumpulan 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.