Aracılığıyla paylaş

Write-Debug

  • Başvuru
Modül:
Microsoft.PowerShell.Utility

Konsola bir hata ayıklama iletisi yazar.

Sözdizimi

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

Description

Write-Debug cmdlet'i bir betikten veya komuttan konağa hata ayıklama iletileri yazar.

Varsayılan olarak, hata ayıklama iletileri konsolda görüntülenmez, ancak Debug parametresini veya $DebugPreference değişkenini kullanarak bunları görüntüleyebilirsiniz.

Örnekler

Örnek 1: $DebugPreference anlama

Bu örnek bir hata ayıklama iletisi yazar.

Write-Debug "Cannot open file."

varsayılan $DebugPreference değeri SilentlyContinuedeğeridir. Bu nedenle, ileti konsolunda görüntülenmez.

Örnek 2: $DebugPreference değerini değiştirme

Bu örnekte, $DebugPreference değişkeninin değerini değiştirmenin etkisi gösterilmektedir. İlk olarak, $DebugPreference geçerli değerini görüntüler ve hata ayıklama iletisi yazmaya çalışırız. Ardından, hata ayıklama iletilerinin görüntülenmesini sağlayan $DebugPreference değerini Devamolarak değiştiririz.

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

$DebugPreferencehakkında daha fazla bilgi için bkz. about_Preference_Variables.

Örnek 3: hata ayıklama parametresini kullanarak $DebugPreference

Test-Debug işlevi, $DebugPreference değişkeninin değerini PowerShell konağına ve Hata Ayıklama akışına yazar. Bu örnekte, $DebugPreference değerini geçersiz kılmak için Debug parametresini kullanacağız.

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

Debug parametresini kullandığınızda $DebugPreference değerinin değiştiğine dikkat edin. Bu değişiklik yalnızca işlevin kapsamını etkiler. Değer işlevin dışından etkilenmez.

Hata Ayıklama ortak parametresi hakkında daha fazla bilgi için bkz. about_CommonParameters.

Parametreler

-Message

Konsola gönderilecek hata ayıklama iletisini belirtir.

Tür:String
Diğer adlar:Msg
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

Girişler

String

Hata ayıklama iletisi içeren bir dizeyi bu cmdlet'e iletebilirsiniz.

Çıkışlar

None

Bu cmdlet çıkış döndürmez. Yalnızca hata ayıklama akışına yazar.