Aracılığıyla paylaş

Write-Debug

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

Konsola 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 $DebugPreferenceSilentlyContinue 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üler ve hata ayıklama iletisi yazmaya çalışırız. Ardından değerini $DebugPreferenceDevam 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 kullanırı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 değerinin $DebugPreference 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 adresine aktarabilirsiniz Write-Debug.

Çıkışlar

None

Write-Debug yalnızca hata ayıklama akışına yazar. İşlem hattına herhangi bir nesne yazmaz.