Enter-PSHostProcess

  • Odwołanie
Moduł:
Microsoft.PowerShell.Core

Połączenie do i wchodzi do interaktywnej sesji z procesem lokalnym.

Składnia

Enter-PSHostProcess
     [-Id] <Int32>
     [[-AppDomainName] <String>]
     [<CommonParameters>]
Enter-PSHostProcess
     [-Process] <Process>
     [[-AppDomainName] <String>]
     [<CommonParameters>]
Enter-PSHostProcess
     [-Name] <String>
     [[-AppDomainName] <String>]
     [<CommonParameters>]
Enter-PSHostProcess
     [-HostProcessInfo] <PSHostProcessInfo>
     [[-AppDomainName] <String>]
     [<CommonParameters>]

Opis

Polecenie Enter-PSHostProcess cmdlet łączy się z i wprowadza w interakcyjnej sesji z procesem lokalnym.

Zamiast tworzyć nowy proces hostowania programu PowerShell i uruchamiania sesji zdalnej, sesja interaktywna jest uruchamiana w istniejącym procesie, który jest już uruchomiony w programie PowerShell. Podczas interakcji z sesją zdalną w określonym procesie można wyliczyć uruchomione przestrzenie uruchomieniowe, a następnie wybrać przestrzeń uruchamiania do debugowania, uruchamiając Debug-Runspace polecenie lub Enable-RunspaceDebug.

Proces, który chcesz wprowadzić, musi hostować program PowerShell (System.Management.Automation.dll). Musisz być członkiem grupy Administracja istratorów na komputerze, na którym znajduje się proces, lub musisz być użytkownikiem, który uruchamia skrypt, który uruchomił proces.

Po wybraniu obszaru uruchamiania do debugowania zostanie otwarta sesja zdalnego debugowania dla obszaru uruchomieniowego, jeśli jest aktualnie uruchomiona polecenie lub jest zatrzymana w debugerze. Następnie można debugować skrypt runspace w taki sam sposób, jak w przypadku debugowania innych skryptów sesji zdalnej.

Odłącz się od sesji debugowania, a następnie interakcyjnej sesji z procesem, uruchamiając dwukrotnie wyjście lub zatrzymaj wykonywanie skryptu, uruchamiając istniejące polecenie zakończenia debugera.

Jeśli określisz proces przy użyciu parametru Name i zostanie znaleziony tylko jeden proces o określonej nazwie, proces zostanie wprowadzony. Jeśli zostanie znaleziony więcej niż jeden proces o określonej nazwie, program PowerShell zwróci błąd i wyświetli listę wszystkich procesów znalezionych z określoną nazwą.

Aby obsługiwać dołączanie do procesów na komputerach zdalnych, Enter-PSHostProcess polecenie cmdlet jest włączone na określonym komputerze zdalnym, dzięki czemu można dołączyć do procesu lokalnego w ramach zdalnej sesji programu PowerShell.

Przykłady

Przykładowa część 1. Rozpoczęcie debugowania przestrzeni uruchomieniowej w procesie środowiska POWERShell ISE

W tym przykładzie uruchomisz polecenie Enter-PSHostProcess z poziomu konsoli programu PowerShell, aby wprowadzić proces ŚRODOWISKA ISE programu PowerShell. W wynikowej sesji interakcyjnej możesz znaleźć przestrzeń uruchomieniową, którą chcesz debugować, uruchamiając polecenie Get-Runspace, a następnie debugując przestrzeń uruchomieniową.

PS C:\> Enter-PSHostProcess -Name powershell_ise
[Process:1520]: PS C:\>  Get-Runspace
Id    Name          InstanceId                               State           Availability
--    -------       -----------                              ------          -------------
1     Runspace1     2d91211d-9cce-42f0-ab0e-71ac258b32b5     Opened          Available
2     Runspace2     a3855043-cb16-424a-a616-685360c3763b     Opened          RemoteDebug
3     MyLocalRS     2236dbd8-2105-4dec-a15a-a27d0bfaacb5     Opened          LocalDebug
4     MyRunspace    771356e9-8c44-4b70-9de5-dd17cb41e48e     Opened          Busy
5     Runspace8     3e517382-a97a-49ba-9c3c-fd21f6664288     Broken          None

Przykładowa część 2. Debugowanie określonej przestrzeni uruchomieniowej

Następnie debuguj identyfikator runspace ID 4, który uruchamia długotrwały skrypt innego użytkownika. Z listy zwróconej z Get-Runspaceprogramu zwróć uwagę, że stan obszaru uruchamiania jest otwarty, a dostępność jest zajęta, co oznacza, że przestrzeń uruchamiania nadal działa długotrwały skrypt. Obiekty runspace zwracane przez Get-Runspace program mają również właściwość NoteProperty o nazwie ScriptStackTrace uruchomionego stosu poleceń, jeśli jest dostępna.

[Process:1520]: PS C:\>  (Get-Runspace -Id 4).ScriptStackTrace
Command                    Arguments                           Location
-------                    ---------                           --------
MyModuleWorkflowF1         {}                                  TestNoFile3.psm1: line 6
WFTest1                    {}                                  TestNoFile2.ps1: line 14
TestNoFile2.ps1            {}                                  TestNoFile2.ps1: line 22
<ScriptBlock>              {}                                  <No file>

[Process: 1520]: PS C:\>  Debug-Runspace -Id 4
Hit Line breakpoint on 'C:\TestWFVar1.ps1:83'

At C:\TestWFVar1.ps1:83 char:1
+ $scriptVar = "Script Variable"
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[Process: 1520]: [RSDBG: 4]: PS C:\>

Uruchom interaktywną sesję debugowania z tą przestrzenią uruchamiania Debug-Runspace , uruchamiając polecenie cmdlet .

Przykładowa część 3. Zakończenie sesji debugowania i zakończenie

Po zakończeniu debugowania zezwól skryptowi na kontynuowanie działania bez dołączonego debugera, uruchamiając polecenie exit debugger. Alternatywnie możesz zamknąć debuger za pomocą poleceń q lub Stop.

Po zakończeniu pracy w procesie zakończ proces, uruchamiając Exit-PSHostProcess polecenie cmdlet . Spowoduje to zwrócenie monitu PS C:\> .

[Process:346]: [RSDBG: 3]: PS C:\> exit
[Process:1520]: PS C:\>
[Process:1520]: PS C:\>  Exit-PSHostProcess
PS C:\>

Parametry

-AppDomainName

Określa nazwę domeny aplikacji, z która ma nawiązać połączenie w przypadku pominięcia, używa parametru DefaultAppDomain. Służy Get-PSHostProcessInfo do wyświetlania nazw domen aplikacji.

Type:String
Position:1
Default value:DefaultAppDomain
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HostProcessInfo

Określa obiekt PSHostProcessInfo , z który można nawiązać połączenie z programem PowerShell. Użyj polecenia Get-PSHostProcessInfo , aby pobrać obiekt.

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

-Id

Określa proces według identyfikatora procesu. Aby uzyskać identyfikator procesu, uruchom Get-Process polecenie cmdlet .

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

-Name

Określa proces według nazwy procesu. Aby uzyskać nazwę procesu, uruchom Get-Process polecenie cmdlet . Nazwy procesów można również pobrać z okna dialogowego Właściwości procesu w Menedżerze zadań.

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

-Process

Określa proces przez obiekt procesu. Najprostszym sposobem użycia tego parametru jest zapisanie wyników Get-Process polecenia, które zwraca proces, który ma zostać wprowadzony w zmiennej, a następnie określ zmienną jako wartość tego parametru.

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

Dane wejściowe

Process

Uwagi

Enter-PSHostProcess Program nie może wprowadzić procesu sesji programu PowerShell, w której uruchamiasz polecenie. Można jednak wprowadzić proces innej sesji programu PowerShell lub sesji programu PowerShell ISE uruchomionej w tym samym czasie co sesja, w której uruchomiono Enter-PSHostProcessprogram .

Enter-PSHostProcess Program może wprowadzać tylko te procesy, które hostują program PowerShell. Oznacza to, że załadowali aparat programu PowerShell.

Aby zakończyć proces z poziomu procesu, wpisz exit, a następnie naciśnij klawisz Enter.