Debug-Runspace
Inicia uma sessão de depuração interativa com um runspace.
Syntax
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>]
Description
O Debug-Runspace
cmdlet inicia uma sessão de depuração interativa com um runspace ativo local ou remoto. Você pode encontrar um runspace que deseja depurar primeiro executando Get-Process
para localizar processos associados ao PowerShell e, em seguida Enter-PSHostProcess
, com a ID do processo especificada no parâmetro Id a ser anexado ao processo e, em seguida Get-Runspace
, listar runspaces dentro do processo de host do PowerShell.
Depois de selecionar um runspace para depurar, se o runspace estiver executando um comando ou script no momento ou se o script tiver parado em um ponto de interrupção, o PowerShell abrirá uma sessão remota do depurador para o runspace. Você pode depurar o script de runspace da mesma forma que os scripts de sessão remota são depurados.
Você só poderá anexar a um processo de host do PowerShell se você for um administrador no computador que está executando o processo ou estiver executando o script que deseja depurar. Além disso, você não pode inserir o processo de host que está executando a sessão atual do PowerShell. Você só pode inserir um processo de host que esteja executando uma sessão diferente do PowerShell.
Exemplos
Exemplo 1: Depurar um runspace remoto
Neste exemplo, você depura um runspace aberto em um computador remoto, WS10TestServer. Na primeira linha do comando, você executa Get-Process
no computador remoto e filtra para Windows PowerShell processos de host. Neste exemplo, você deseja depurar a ID do processo 1152, o Windows PowerShell processo de host do ISE.
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:\> >
No segundo comando, você executa Enter-PSSession
para abrir uma sessão remota no WS10TestServer. No terceiro comando, você anexa ao Windows PowerShell processo de host ISE em execução no servidor remoto executando Enter-PSHostProcess
e especificando a ID do processo de host obtido no primeiro comando, 1152.
No quarto comando, você lista os runspaces disponíveis para a ID de processo 1152 executando Get-Runspace
.
Anote o número de ID do runspace Ocupado; ele está executando um script que você deseja depurar.
No último comando, você começa a depurar um runspace aberto que está executando um script, TestWFVar1.ps1
, executando Debug-Runspace
e identificando o runspace por sua ID, 2, adicionando o parâmetro Id . Como há um ponto de interrupção no script, o depurador é aberto.
Parâmetros
-BreakAll
Permite que você interrompa imediatamente no local atual quando o depurador é anexado.
O parâmetro só está disponível como um recurso experimental. Para obter mais informações, consulte Usando recursos experimentais.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | True |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Especifica o número de ID de um runspace. Você pode executar Get-Runspace
para mostrar IDs de runspace.
Type: | Int32 |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstanceId
Especifica um runspace por sua ID de instância, um GUID que você pode mostrar executando Get-Runspace
.
Type: | Guid |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifica um runspace por seu nome. Você pode executar Get-Runspace
para mostrar os nomes dos runspaces.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Runspace
Especifica um objeto de runspace. A maneira mais simples de fornecer um valor para esse parâmetro é especificar uma variável que contenha os resultados de um comando filtrado Get-Runspace
.
Type: | Runspace |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | True |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Você pode redirecionar os resultados de um Get-Runspace
comando para Debug-Runspace.
Observações
Debug-Runspace
funciona em runspaces que estão no estado Aberto. Se um estado de runspace for alterado de Aberto para outro estado, esse runspace será removido automaticamente da lista em execução. Um runspace será adicionado à lista em execução somente se atender aos critérios a seguir.
- Se ele for proveniente de Invoke-Command; ou seja, ele tem uma
Invoke-Command
ID de GUID. - Se ele for proveniente de
Debug-Runspace
; ou seja, ele terá umaDebug-Runspace
ID de GUID. - Se ele for proveniente de um fluxo de trabalho do PowerShell e sua ID de trabalho de fluxo de trabalho for igual à ID de trabalho do fluxo de trabalho do depurador ativo atual.