Wait-Debugger
Detiene un script en el depurador antes de ejecutar la siguiente instrucción en el script.
Sintaxis
Wait-Debugger []
Description
Detiene el motor de ejecución de scripts de PowerShell en el punto inmediatamente después del Wait-Debugger
cmdlet y espera a que se adjunte un depurador.
Precaución
Asegúrese de quitar las Wait-Debugger
líneas después de que haya terminado. Parece que un script en ejecución se bloquea cuando se detiene en .Wait-Debugger
Para obtener más información sobre la depuración en PowerShell, consulte about_Debuggers.
Ejemplos
Ejemplo 1: Insertar punto de interrupción para la depuración
El archivo dbgtest.ps1
contiene una función Test-Condition
. El Wait-Debugger
comando se insertó en la función para detener la ejecución del script en ese momento. Al ejecutar la función, el script se detiene en la Wait-Debugger
línea y escribe el depurador de línea de comandos. El l
comando enumera las líneas de script y puede usar otros comandos del depurador para inspeccionar el estado del script.
function Test-Condition {
[CmdletBinding()]
param (
[Parameter(Mandatory)]
[string]$Name,
[string]$Message = "Hello, $Name!"
)
if ($Name -eq $env:USERNAME) {
Write-Output "$Message"
} else {
# Remove after debugging
Wait-Debugger
Write-Output "$Name is not the current user."
}
}
PS D:\> Test-Condition Fred
Entering debug mode. Use h or ? for help.
At D:\temp\test\dbgtest.ps1:13 char:9
+ Wait-Debugger
+ ~~~~~~~~~~~~~
[DBG]: PS D:\>> l
8:
9: if ($Name -eq $env:USERNAME) {
10: Write-Output "$Message"
11: } else {
12: # Remove after debugging
13:* Wait-Debugger
14:
15: Write-Output "$Name is not the current user."
16: }
17: }
[DBG]: PS D:\>> $env:USERNAME
User01
[DBG]: PS D:\>> exit
PS D:\>
Observe que la salida de muestra l
que la ejecución del script se detiene en la Wait-Debugger
línea 13.
Ejemplo 2: Insertar punto de interrupción para depurar un recurso de DSC
En este ejemplo, el Wait-Debugger
comando se insertó en el CopyFile
método de un recurso DSC. Esto es similar al uso Enable-RunspaceDebug -BreakAll
en un recurso de DSC, pero se interrumpe en un punto específico del script.
[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
}
}
Entradas
None
No se pueden canalizar objetos a este cmdlet.
Salidas
None
Este cmdlet no devuelve ningún resultado.