Enter-PSHostProcess
Stellt eine Verbindung mit einer interaktiven Sitzung mit einem lokalen Prozess her und führt sie ein.
Syntax
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>]
Enter-PSHostProcess
-CustomPipeName <String>
[<CommonParameters>]
Beschreibung
Das Enter-PSHostProcess
Cmdlet stellt eine Verbindung mit einer interaktiven Sitzung mit einem lokalen Prozess her und geht in eine interaktive Sitzung ein. Ab PowerShell 6.2 wird dieses Cmdlet auf Nicht-Windows-Plattformen unterstützt.
Anstatt einen neuen Prozess zum Hosten von PowerShell und ausführen einer Remotesitzung zu erstellen, wird die interaktive Remotesitzung in einem vorhandenen Prozess ausgeführt, der bereits PowerShell ausführt. Wenn Sie mit einer Remotesitzung in einem angegebenen Prozess interagieren, können Sie ausgeführte Runspaces auflisten und dann einen Runspace zum Debuggen auswählen, indem Sie entweder Debug-Runspace
oder Enable-RunspaceDebug
ausführen.
Der Prozess, den Sie eingeben möchten, muss PowerShell (System.Management.Automation.dll) hosten. Sie müssen entweder Mitglied der Gruppe Administratoren auf dem Computer sein, auf dem der Prozess gefunden wird, oder Sie müssen der Benutzer sein, der das Skript ausführt, das den Prozess gestartet hat.
Nachdem Sie einen Runspace zum Debuggen ausgewählt haben, wird eine Remotedebugsitzung für den Runspace geöffnet, wenn er derzeit einen Befehl ausführt oder im Debugger beendet wird. Anschließend können Sie das Runspace-Skript auf die gleiche Weise debuggen wie andere Remotesitzungsskripts.
Trennen Sie sich von einer Debugsitzung und dann von der interaktiven Sitzung mit dem Prozess, indem Sie den Exit zweimal ausführen, oder beenden Sie die Skriptausführung, indem Sie den vorhandenen Debuggerbefehl zum Beenden ausführen.
Wenn Sie einen Prozess mit dem Parameter Name angeben und nur ein Prozess mit dem angegebenen Namen gefunden wird, wird der Prozess eingegeben. Wenn mehrere Prozesse mit dem angegebenen Namen gefunden werden, gibt PowerShell einen Fehler zurück und listet alle Prozesse auf, die mit dem angegebenen Namen gefunden wurden.
Um das Anfügen an Prozesse auf Remotecomputern zu unterstützen, ist das Enter-PSHostProcess
Cmdlet auf einem angegebenen Remotecomputer aktiviert, sodass Sie innerhalb einer PowerShell-Remotesitzung an einen lokalen Prozess anfügen können.
Beispiele
Beispielteil 1: Starten des Debuggens eines Runspaces innerhalb des PowerShell-ISE-Prozesses
In diesem Beispiel führen Enter-PSHostProcess
Sie in der PowerShell-Konsole aus, um in den PowerShell ISE-Prozess einzutreten. In der resultierenden interaktiven Sitzung können Sie einen Runspace finden, den Sie debuggen möchten, indem Sie ausführen Get-Runspace
und dann den Runspace debuggen.
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
Beispielteil 2: Debuggen eines bestimmten Runspaces
Debuggen Sie als Nächstes die Runspace-ID 4, bei der das lang ausgeführte Skript eines anderen Benutzers ausgeführt wird. Beachten Sie in der von Get-Runspace
zurückgegebenen Liste, dass der Ausführungsstatus geöffnet und die Verfügbarkeit ausgelastet ist, was bedeutet, dass der Runspace weiterhin das Skript mit langer Ausführungsdauer ausführt. Die von zurückgegebenen Get-Runspace
Runspace-Objekte verfügen auch über eine NoteProperty namens ScriptStackTrace des ausgeführten Befehlsstapels, sofern verfügbar.
[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:\>
Starten Sie eine interaktive Debugsitzung mit diesem Runspace, indem Sie das Debug-Runspace
Cmdlet ausführen.
Beispielteil 3: Beenden der Debugsitzung und Beenden
Nachdem Sie das Debuggen abgeschlossen haben, können Sie zulassen, dass das Skript ohne den angefügten Debugger weiter ausgeführt wird, indem Sie den Befehl exit debugger ausführen. Alternativ können Sie den Debugger mit den Befehlen q oder Beenden beenden.
Wenn Sie mit der Arbeit am Prozess fertig sind, beenden Sie den Prozess, indem Sie das Exit-PSHostProcess
Cmdlet ausführen. Dadurch kehren Sie zur PS C:\>
Eingabeaufforderung zurück.
[Process:346]: [RSDBG: 3]: PS C:\> exit
[Process:1520]: PS C:\>
[Process:1520]: PS C:\> Exit-PSHostProcess
PS C:\>
Parameter
-AppDomainName
Gibt einen Anwendungsdomänennamen an, mit dem eine Verbindung hergestellt werden soll, wenn er nicht angegeben wird, verwendet DefaultAppDomain. Verwenden Sie Get-PSHostProcessInfo
zum Anzeigen der Anwendungsdomänennamen.
Type: | String |
Position: | 1 |
Default value: | DefaultAppDomain |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CustomPipeName
Ruft den benutzerdefinierten benannten Pipenamen ab, mit dem eine Verbindung hergestellt werden soll, oder legt diesen fest. Dies wird normalerweise in Verbindung mit pwsh -CustomPipeName
verwendet.
Dieser Parameter wurde in PowerShell 6.2 eingeführt.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HostProcessInfo
Gibt ein PSHostProcessInfo-Objekt an, mit dem eine Verbindung mit PowerShell hergestellt werden kann. Verwenden Sie Get-PSHostProcessInfo
, um das -Objekt abzurufen.
Type: | PSHostProcessInfo |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Id
Gibt einen Prozess anhand der Prozess-ID an. Um eine Prozess-ID abzurufen, führen Sie das Get-Process
Cmdlet aus.
Type: | Int32 |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Gibt einen Prozess anhand des Prozessnamens an. Um einen Prozessnamen abzurufen, führen Sie das Get-Process
Cmdlet aus. Sie können auch Prozessnamen aus dem Dialogfeld Eigenschaften eines Prozesses im Task-Manager abrufen.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Process
Gibt einen Prozess durch das Prozessobjekt an. Die einfachste Möglichkeit, diesen Parameter zu verwenden, besteht darin, die Ergebnisse eines Get-Process
Befehls zu speichern, der den Prozess zurückgibt, den Sie in eine Variable eingeben möchten, und dann die Variable als Wert dieses Parameters anzugeben.
Type: | Process |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Eingaben
Hinweise
Enter-PSHostProcess
Der Prozess der PowerShell-Sitzung, in der Sie den Befehl ausführen, kann nicht eingegeben werden. Sie können jedoch den Prozess einer anderen PowerShell-Sitzung oder einer PowerShell-ISE-Sitzung eingeben, die gleichzeitig mit der Sitzung ausgeführt wird, in der Sie ausführen Enter-PSHostProcess
.
Enter-PSHostProcess
kann nur die Prozesse eingeben, die PowerShell hosten. Das heißt, sie haben die PowerShell-Engine geladen.
Um einen Prozess innerhalb des Prozesses zu beenden, geben Sie exit ein, und drücken Sie dann die EINGABETASTE.
Vor PowerShell 7.1 unterstützte das Remoting über SSH keine Remotesitzungen über einen zweiten Hop. Diese Funktion war auf Sitzungen beschränkt, die WinRM verwendeten. PowerShell 7.1 ermöglicht, dass Enter-PSSession
und Enter-PSHostProcess
in jeder interaktiven Remotesitzung funktionieren.