Condividi tramite

Debug-Runspace

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Avvia una sessione di debug interattiva con uno spazio di esecuzione.

Sintassi

Debug-Runspace
     [-Runspace] <Runspace>
     [-BreakAll]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Debug-Runspace
     [-Name] <String>
     [-BreakAll]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Debug-Runspace
     [-Id] <Int32>
     [-BreakAll]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Debug-Runspace
     [-InstanceId] <Guid>
     [-BreakAll]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Descrizione

Il Debug-Runspace cmdlet avvia una sessione di debug interattiva con uno spazio di esecuzione attivo locale o remoto. È possibile trovare uno spazio di esecuzione di cui eseguire il debug eseguendo prima di tutto Get-Process per trovare i processi associati a PowerShell, quindi Enter-PSHostProcess con l'ID processo specificato nel parametro Id da collegare al processo e quindi Get-Runspace per elencare gli spazi di esecuzione all'interno del processo host di PowerShell.

Dopo aver selezionato uno spazio di esecuzione di cui eseguire il debug, se lo spazio di esecuzione esegue un comando o uno script o se lo script è stato arrestato in un punto di interruzione, PowerShell apre una sessione del debugger remota per lo spazio di esecuzione. È possibile eseguire il debug dello script dello spazio di esecuzione nello stesso modo in cui vengono eseguiti il debug degli script di sessione remota.

È possibile connettersi a un processo host di PowerShell solo se si è un amministratore nel computer che esegue il processo o si esegue lo script di cui si vuole eseguire il debug. Inoltre, non è possibile immettere il processo host che esegue la sessione di PowerShell corrente. È possibile immettere solo un processo host che esegue una sessione di PowerShell diversa.

Esempio

Esempio 1: Eseguire il debug di uno spazio di esecuzione remoto

In questo esempio si esegue il debug di uno spazio di esecuzione aperto in un computer remoto, WS10TestServer. Nella prima riga del comando eseguire Get-Process nel computer remoto e filtrare i processi host di Windows PowerShell. In questo esempio si vuole eseguire il debug dell'ID processo 1152, il processo host di Windows PowerShell I edizione Standard.

PS C:\> Get-Process -ComputerName "WS10TestServer" -Name "*powershell*"

Handles      WS(K)   VM(M)      CPU(s)    Id  ProcessName
-------      -----   -----      ------    --  -----------
    377      69912     63     2.09      2420  powershell
    399     123396    829     4.48      1152  powershell_ise

PS C:\> Enter-PSSession -ComputerName "WS10TestServer"
[WS10TestServer]:PS C:\> Enter-PSHostProcess -Id 1152
[WS10TestServer:][Process:1152]: PS C:\Users\Test\Documents> Get-Runspace

Id Name            ComputerName    Type          State         Availability
-- ----            ------------    ----          -----         ------------
 1 Runspace1       WS10TestServer  Remote        Opened        Available
 2 RemoteHost      WS10TestServer  Remote        Opened        Busy

[WS10TestServer][Process:1152]: PS C:\Users\Test\Documents> Debug-Runspace -Id 2

Hit Line breakpoint on 'C:\TestWFVar1.ps1:83'
At C:\TestWFVar1.ps1:83 char:1
+ $scriptVar = "Script Variable"
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
[Process:1152]: [RSDBG: 2]: PS C:\> >

Nel secondo comando si esegue Enter-PSSession per aprire una sessione remota in WS10TestServer. Nel terzo comando si collega al processo host di Windows PowerShell I edizione Standard in esecuzione nel server remoto eseguendo Enter-PSHostProcesse specificando l'ID del processo host ottenuto nel primo comando 1152.

Nel quarto comando è possibile elencare gli spazi di esecuzione disponibili per l'ID processo 1152 eseguendo Get-Runspace. Si noti il numero ID dello spazio di esecuzione Occupato; esegue uno script di cui si vuole eseguire il debug.

Nell'ultimo comando si avvia il debug di uno spazio di esecuzione aperto che esegue uno script, TestWFVar1.ps1, eseguendo Debug-Runspacee identificando lo spazio di esecuzione in base al relativo ID, 2, aggiungendo il parametro Id . Poiché nello script è presente un punto di interruzione, viene aperto il debugger.

Parametri

-BreakAll

Consente di interrompere immediatamente la posizione corrente quando il debugger è collegato.

Questo parametro è stato aggiunto in PowerShell 7.2.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:True
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Specifica il numero ID di uno spazio di esecuzione. È possibile eseguire Get-Runspace per visualizzare gli ID dello spazio di esecuzione.

Type:Int32
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InstanceId

Specifica uno spazio di esecuzione in base al relativo ID istanza, un GUID che è possibile visualizzare eseguendo Get-Runspace.

Type:Guid
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifica uno spazio di esecuzione in base al nome. È possibile eseguire Get-Runspace per visualizzare i nomi degli spazi di esecuzione.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Runspace

Specifica un oggetto runspace. Il modo più semplice per fornire un valore per questo parametro consiste nel specificare una variabile contenente i risultati di un comando filtrato Get-Runspace .

Type:Runspace
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:True
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

Runspace

È possibile inviare tramite pipe i risultati di un Get-Runspace comando a questo cmdlet.

Note

Debug-Runspace funziona su spazi di esecuzione nello stato Aperto. Se uno stato dello spazio di esecuzione passa da Opened a un altro stato, tale spazio di esecuzione viene rimosso automaticamente dall'elenco in esecuzione. Un runspace viene aggiunto all'elenco in esecuzione solo se soddisfa i criteri seguenti.

  • Se proviene da Invoke-Command; ovvero ha un Invoke-Command ID GUID.
  • Se proviene da Debug-Runspace, ovvero ha un Debug-Runspace ID GUID.
  • Se proviene da un flusso di lavoro di PowerShell e il relativo ID processo del flusso di lavoro corrisponde all'ID processo del debugger attivo corrente.