Write-Debug

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

Konsola bir hata ayıklama iletisi yazar.

Syntax

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

Description

Cmdlet, Write-Debug bir betikten veya komuttan konağa hata ayıklama iletileri yazar.

Varsayılan olarak, hata ayıklama iletileri konsolunda görüntülenmez, ancak Debug parametresini veya değişkenini $DebugPreference 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 değeri $DebugPreference SilentlyContinue değeridir. Bu nedenle, ileti konsolunda görüntülenmez.

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

Bu örnekte değişkenin değerini değiştirmenin etkisi gösterilmektedir $DebugPreference . İlk olarak geçerli değerini $DebugPreference görüntüleyip hata ayıklama iletisi yazmaya çalışacağız. Ardından değerini $DebugPreference Devam olarak değiştirerek hata ayıklama iletilerinin görüntülenmesini sağlarız.

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

hakkında $DebugPreferencedaha fazla bilgi için bkz. about_Preference_Variables.

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

işlevi değişkeninin Test-Debug$DebugPreference değerini PowerShell konağına ve Debug akışına yazar. Bu örnekte, değeri geçersiz kılmak için Debug parametresini $DebugPreference 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 $DebugPreference kullandığınızda 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.

Ortak hata ayıklama parametresi hakkında daha fazla bilgi için bkz. about_CommonParameters.

Parametreler

-Message

Konsola gönderilecek hata ayıklama iletisini belirtir.

Type:String
Aliases:Msg
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.