Aracılığıyla paylaş

Write-Debug

Modül:
Microsoft.PowerShell.Utility Module

Konsola bir hata ayıklama iletisi yazar.

Sözdizimi

Default EnterprisePublishing 

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, değerini geçersiz kılmak için $DebugPreference 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

$DebugPreference parametresini 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.

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.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Msg

Parametre kümeleri

(All)
Position:0
Zorunlu:True
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

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.