Sdílet prostřednictvím

Debug-Runspace

  • Reference
Modul:
Microsoft.PowerShell.Utility

Spustí interaktivní ladicí relaci s prostředím Runspace.

Syntax

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

Description

Rutina Debug-Runspace spustí interaktivní ladicí relaci s místním nebo vzdáleným aktivním prostředím runspace. Runspace, který chcete ladit, můžete najít tak, že nejprve spustíte Get-Process procesy přidružené k PowerShellu, pak Enter-PSHostProcess s ID procesu zadaným v parametru ID pro připojení k procesu a pak Get-Runspace vypíšete runspaces v rámci hostitelského procesu PowerShellu.

Po výběru runspace k ladění, pokud runspace právě spouští příkaz nebo skript nebo pokud je skript zastaven na zarážce, PowerShell otevře vzdálenou relaci ladicího programu pro runspace. Skript runspace můžete ladit stejným způsobem, jakým jsou laděné skripty vzdálené relace.

K hostitelskému procesu PowerShellu se můžete připojit pouze v případě, že jste správcem v počítači, na kterém je proces spuštěný, nebo spouštíte skript, který chcete ladit. Také nelze zadat hostitelský proces, na kterém běží aktuální relace PowerShellu. Můžete zadat pouze hostitelský proces, na kterém běží jiná relace PowerShellu.

Příklady

Příklad 1: Ladění vzdáleného prostředí runspace

V tomto příkladu ladíte runspace, který je otevřený ve vzdáleném počítači WS10TestServer. Na prvním řádku příkazu spustíte Get-Process na vzdáleném počítači a vyfiltrujete hostitelské procesy Windows PowerShellu. V tomto příkladu chcete ladit proces s ID 1152, proces hostitele integrovaného skriptového prostředí (ISE) windows PowerShellu.

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:\> >

V druhém příkazu otevřete Enter-PSSession vzdálenou relaci na WS10TestServer. Ve třetím příkazu připojíte proces hostitele prostředí Windows PowerShell ISE spuštěný na vzdáleném serveru spuštěním Enter-PSHostProcessa zadáním ID hostitelského procesu, který jste získali v prvním příkazu 1152.

Ve čtvrtém příkazu zobrazíte seznam dostupných prostředí runspace pro proces s ID 1152 spuštěním Get-Runspace. Poznamenejte si číslo ID prostředí Busy runspace; spouští skript, který chcete ladit.

V posledním příkazu spustíte ladění otevřeného prostředí runspace, na kterém běží skript, TestWFVar1.ps1spuštěním Debug-Runspacea identifikací runspace podle ID, 2, přidáním parametru ID . Vzhledem k tomu, že ve skriptu je zarážka, otevře se ladicí program.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-Id

Určuje číslo ID runspace. Spuštěním můžete Get-Runspace zobrazit ID prostředí Runspace.

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

-InstanceId

Určuje runspace podle ID jeho instance, identifikátor GUID, který můžete zobrazit spuštěním Get-Runspace.

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

-Name

Určuje runspace podle názvu. Spuštěním můžete Get-Runspace zobrazit názvy prostředí runspace.

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

-Runspace

Určuje objekt runspace. Nejjednodušší způsob, jak zadat hodnotu pro tento parametr, je zadat proměnnou, která obsahuje výsledky filtrovaného Get-Runspace příkazu.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Vstupy

Runspace

Výsledky Get-Runspace příkazu můžete do této rutiny převést.

Poznámky

Debug-Runspace funguje na runspaces, které jsou ve stavu Otevření. Pokud se stav runspace změní z otevřeného do jiného stavu, tento runspace se automaticky odebere ze spuštěného seznamu. Runspace se přidá do spuštěného seznamu pouze v případě, že splňuje následující kritéria.

  • Pokud pochází z příkazu Invoke-Command; to znamená, že má Invoke-Command IDENTIFIKÁTOR GUID.
  • Pokud pochází z Debug-Runspace; to znamená, že má Debug-Runspace IDENTIFIKÁTOR GUID.
  • Pokud pochází z pracovního postupu PowerShellu a JEHO ID úlohy pracovního postupu je stejné jako aktuální ID úlohy pracovního postupu aktivního ladicího programu.