Wait-Debugger

Modül:
Microsoft.PowerShell.Utility Module

Betikte sonraki deyimi çalıştırmadan önce hata ayıklayıcıda bir betiği durdurur.

Syntax

Default (Varsayılan) 

Wait-Debugger

Description

Wait-Debugger cmdlet'inden hemen sonra PowerShell betik yürütme altyapısını durdurur ve bir hata ayıklayıcının eklenmesini bekler. Bu, DSC kaynağında Enable-RunspaceDebug -BreakAll kullanmaya benzer ancak betiğin belirli bir noktasında kesilir.

Dikkat

İşiniz bittiğinde Wait-Debugger satırlarını kaldırdığınızdan emin olun. Çalışan bir komut dosyası, bir Wait-Debugger'de durdurulduğunda askıda kalmış gibi görünüyor.

Örnekler

Örnek 1: Hata ayıklama için kesme noktası ekleme

[DscResource()]
class FileResource
{
    [DscProperty(Key)]
    [string] $Path

    [DscProperty(Mandatory)]
    [Ensure] $Ensure

    [DscProperty(Mandatory)]
    [string] $SourcePath

    [DscProperty(NotConfigurable)]
    [Nullable[datetime]] $CreationTime


    [void] Set()
    {
        $fileExists = $this.TestFilePath($this.Path)
        if ($this.ensure -eq [Ensure]::Present)
        {
            if (! $fileExists)
            {
               $this.CopyFile()
            }
        }
        else
        {
            if ($fileExists)
            {
                Write-Verbose -Message "Deleting the file $($this.Path)"
                Remove-Item -LiteralPath $this.Path -Force
            }
        }
    }

    [bool] Test()
    {
        $present = Test-Path -LiteralPath $this.Path

        if ($this.Ensure -eq [Ensure]::Present)
        {
            return $present
        }
        else
        {
            return (! $present)
        }
    }

    [FileResource] Get()
    {
        $present = Test-Path -Path $this.Path

        if ($present)
        {
            $file = Get-ChildItem -LiteralPath $this.Path
            $this.CreationTime = $file.CreationTime
            $this.Ensure = [Ensure]::Present
        }
        else
        {
            $this.CreationTime = $null
            $this.Ensure = [Ensure]::Absent
        }

        return $this
    }

    [void] CopyFile()
    {
        # Testing only - Remove before deployment!
        Wait-Debugger

        if (! (Test-Path -LiteralPath $this.SourcePath))
        {
            throw "SourcePath $($this.SourcePath) is not found."
        }

        if (Test-Path -LiteralPath $this.Path -PathType Container)
        {
            throw "Path $($this.Path) is a directory path"
        }

        Write-Verbose "Copying $($this.SourcePath) to $($this.Path)"

        Copy-Item -LiteralPath $this.SourcePath -Destination $this.Path -Force
    }
}

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

None

Bu cmdlet çıkış döndürmez.