Write-Debug

  • Referensi
Modul:
Microsoft.PowerShell.Utility

Menulis pesan debug ke konsol.

Sintaks

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

Deskripsi

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

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

Contoh

Contoh 1: Memahami $DebugPreference

Contoh ini menulis pesan debug.

Write-Debug "Cannot open file."

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

Contoh 2: Mengubah nilai $DebugPreference

Contoh ini menunjukkan efek mengubah nilai $DebugPreference variabel. 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 ini Test-Debug menulis nilai $DebugPreference variabel ke host PowerShell dan ke aliran Debug. Dalam contoh ini, kita menggunakan parameter Debug untuk mengambil $DebugPreference 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 $DebugPreference perubahan 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.

Type:String
Aliases:Msg
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

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.