Enter-PSHostProcess
Egy helyi folyamattal csatlakozik egy interaktív munkamenethez, és egy interaktív munkamenetbe lép be.
Syntax
ProcessIdParameterSet (Alapértelmezett)
Enter-PSHostProcess
[-Id] <Int32>
[[-AppDomainName] <String>]
[<CommonParameters>]
ProcessParameterSet
Enter-PSHostProcess
[-Process] <Process>
[[-AppDomainName] <String>]
[<CommonParameters>]
ProcessNameParameterSet
Enter-PSHostProcess
[-Name] <String>
[[-AppDomainName] <String>]
[<CommonParameters>]
PSHostProcessInfoParameterSet
Enter-PSHostProcess
[-HostProcessInfo] <PSHostProcessInfo>
[[-AppDomainName] <String>]
[<CommonParameters>]
Description
Az Enter-PSHostProcess parancsmag egy helyi folyamattal csatlakozik, és interaktív munkamenetbe lép be.
AHelyett, hogy új folyamatot hozna létre a Windows PowerShell üzemeltetéséhez és távoli munkamenet futtatásához, a távoli, interaktív munkamenet egy meglévő folyamatban fut, amely már futtatja a Windows PowerShellt. Ha egy adott folyamat távoli munkamenetével dolgozik, számba vehet futó runspace-eket, majd kiválaszthat egy olyan futtatóteret, amely hibakeresésre szolgál a Debug-Runspace vagy az Enable-RunspaceDebug futtatásával.
A beírandó folyamatnak a Windows PowerShellt (System.Management.Automation.dll) kell üzemeltetnie. Vagy a Rendszergazdák csoport tagjának kell lennie azon a számítógépen, amelyen a folyamat található, vagy Önnek kell lennie az a felhasználó, aki a folyamatot elindító szkriptet futtatja.
Miután kiválasztott egy futtatóteret a hibakereséshez, a rendszer megnyit egy távoli hibakeresési munkamenetet a runspace számára, ha jelenleg egy parancsot futtat, vagy le van állítva a hibakeresőben. Ezután ugyanúgy hibakeresést végezhet a futtatókörnyezeti szkriptben, mint a többi távoli munkamenet-szkriptben.
Válassza le a hibakeresési munkamenetet, majd az interaktív munkamenetet a folyamattal úgy, hogy kétszer futtatja a kilépést, vagy állítsa le a szkript végrehajtását a meglévő hibakereső kilépési parancsának futtatásával.
Ha a Név paraméterrel ad meg egy folyamatot, és a megadott névvel csak egy folyamat található, a folyamat be lesz írva. Ha egynél több folyamat található a megadott névvel, a Windows PowerShell hibát ad vissza, és felsorolja a megadott névvel talált összes folyamatot.
A távoli számítógépeken futó folyamatokhoz való csatolás támogatásához az Enter-PSHostProcess parancsmag engedélyezve van egy megadott távoli számítógépen, hogy egy távoli Windows PowerShell-munkameneten belül helyi folyamathoz csatolhassa.
Példák
1. példa: Runspace hibakeresésének megkezdése a Windows PowerShell ISE-folyamaton belül
Ebben a példában az Enter-PSHostProcess parancsot futtatja a Windows PowerShell integrált parancsprogram-kezelési környezet folyamatába. Az eredményül kapott interaktív munkamenetben megkeresheti a Get-Runspace futtatásával hibakeresést végezni kívánt futási területet, majd hibakeresést végezhet a Get-Runspace futtatótérben.
PS C:\> Enter-PSHostProcess -Name powershell_ise
[Process:1520]: PS C:\Test\Documents>
Next, get available runspaces within the process you have entered.
PS C:\> [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
# The runspace objects returned by **Get-Runspace** also have a NoteProperty
# called **ScriptStackTrace** of the running command stack, if available.Next,
# debug runspace ID 4, that is running another user's long-running script. From
# the list returned from **Get-Runspace**, note that the runspace state is
# **Opened**, and **Availability** is **Busy**, meaning that the runspace is
# still running the long-running script.
PS C:\> [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>
# Start an interactive debugging session with this runspace by running the
# Debug-Runspace cmdlet.
PS C:\> [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:\> >
# After you are finished debugging, allow the script to continue running without
# the debugger attached by running the **exit** debugger command. Alternatively,
# you can quit the debugger with the **q** or **Stop** commands.
PS C:\> [Process:346]: [RSDBG: 3]: PS C:\> > exit
[Process:1520]: PS C:\>
# When you are finished working in the process, exit the process by running the
# Exit-PSHostProcess cmdlet. This returns you to the PS C:\> prompt.
PS C:\> [Process:1520]: PS C:\> Exit-PSHostProcess
PS C:\>
Paraméterek
-AppDomainName
Az Enter-PSHostProcess parancsmag egy helyi folyamattal csatlakozik, és interaktív munkamenetbe lép be.
AHelyett, hogy új folyamatot hozna létre a Windows PowerShell üzemeltetéséhez és távoli munkamenet futtatásához, a távoli, interaktív munkamenet egy meglévő folyamatban fut, amely már futtatja a Windows PowerShellt. Ha egy adott folyamat távoli munkamenetével dolgozik, számba vehet futó runspace-eket, majd kiválaszthat egy olyan futtatóteret, amely hibakeresésre szolgál a Debug-Runspace vagy az Enable-RunspaceDebug futtatásával.
A beírandó folyamatnak a Windows PowerShellt (System.Management.Automation.dll) kell üzemeltetnie. Vagy a Rendszergazdák csoport tagjának kell lennie azon a számítógépen, amelyen a folyamat található, vagy Önnek kell lennie az a felhasználó, aki a folyamatot elindító szkriptet futtatja.
Miután kiválasztott egy futtatóteret a hibakereséshez, a rendszer megnyit egy távoli hibakeresési munkamenetet a runspace számára, ha jelenleg egy parancsot futtat, vagy le van állítva a hibakeresőben. Ezután ugyanúgy hibakeresést végezhet a futtatókörnyezeti szkriptben, mint a többi távoli munkamenet-szkriptben.
Válassza le a hibakeresési munkamenetet, majd az interaktív munkamenetet a folyamattal úgy, hogy kétszer futtatja a kilépést, vagy állítsa le a szkript végrehajtását a meglévő hibakereső kilépési parancsának futtatásával.
Ha a Név paraméterrel ad meg egy folyamatot, és a megadott névvel csak egy folyamat található, a folyamat be lesz írva. Ha egynél több folyamat található a megadott névvel, a Windows PowerShell hibát ad vissza, és felsorolja a megadott névvel talált összes folyamatot.
A távoli számítógépeken futó folyamatokhoz való csatolás támogatásához az Enter-PSHostProcess parancsmag engedélyezve van egy megadott távoli számítógépen, hogy egy távoli Windows PowerShell-munkameneten belül helyi folyamathoz csatolhassa.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-HostProcessInfo
Az Enter-PSHostProcess parancsmag egy helyi folyamattal csatlakozik, és interaktív munkamenetbe lép be.
AHelyett, hogy új folyamatot hozna létre a Windows PowerShell üzemeltetéséhez és távoli munkamenet futtatásához, a távoli, interaktív munkamenet egy meglévő folyamatban fut, amely már futtatja a Windows PowerShellt. Ha egy adott folyamat távoli munkamenetével dolgozik, számba vehet futó runspace-eket, majd kiválaszthat egy olyan futtatóteret, amely hibakeresésre szolgál a Debug-Runspace vagy az Enable-RunspaceDebug futtatásával.
A beírandó folyamatnak a Windows PowerShellt (System.Management.Automation.dll) kell üzemeltetnie. Vagy a Rendszergazdák csoport tagjának kell lennie azon a számítógépen, amelyen a folyamat található, vagy Önnek kell lennie az a felhasználó, aki a folyamatot elindító szkriptet futtatja.
Miután kiválasztott egy futtatóteret a hibakereséshez, a rendszer megnyit egy távoli hibakeresési munkamenetet a runspace számára, ha jelenleg egy parancsot futtat, vagy le van állítva a hibakeresőben. Ezután ugyanúgy hibakeresést végezhet a futtatókörnyezeti szkriptben, mint a többi távoli munkamenet-szkriptben.
Válassza le a hibakeresési munkamenetet, majd az interaktív munkamenetet a folyamattal úgy, hogy kétszer futtatja a kilépést, vagy állítsa le a szkript végrehajtását a meglévő hibakereső kilépési parancsának futtatásával.
Ha a Név paraméterrel ad meg egy folyamatot, és a megadott névvel csak egy folyamat található, a folyamat be lesz írva. Ha egynél több folyamat található a megadott névvel, a Windows PowerShell hibát ad vissza, és felsorolja a megadott névvel talált összes folyamatot.
A távoli számítógépeken futó folyamatokhoz való csatolás támogatásához az Enter-PSHostProcess parancsmag engedélyezve van egy megadott távoli számítógépen, hogy egy távoli Windows PowerShell-munkameneten belül helyi folyamathoz csatolhassa.
Paramétertulajdonságok
| Típus: | PSHostProcessInfo |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
PSHostProcessInfoParameterSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Id
Egy folyamatot a folyamatazonosító alapján határoz meg. Folyamatazonosító lekéréséhez futtassa a Get-Process parancsmagot.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ProcessIdParameterSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Name
Egy folyamatot a folyamat neve alapján határoz meg. A folyamatnév lekéréséhez futtassa a Get-Process parancsmagot. Folyamatneveket a Feladatkezelőben lévő folyamat Tulajdonságok párbeszédpanelén is lekérhet.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ProcessNameParameterSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Process
A folyamatobjektum által megadott folyamat. Ennek a paraméternek a legegyszerűbb módja egy Get-Process parancs eredményeinek mentése, amely visszaadja a változóba bevinni kívánt folyamatot, majd ennek a paraméternek az értékeként adja meg a változót.
Paramétertulajdonságok
| Típus: | Process |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ProcessParameterSet
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
Process
Jegyzetek
Enter-PSHostProcess nem adhatja meg annak a Windows PowerShell-munkamenetnek a folyamatát, amelyben a parancsot futtatja. Megadhat azonban egy másik Windows PowerShell-munkamenetet, vagy egy Olyan Windows PowerShell ISE-munkamenetet, amely az Enter-PSHostProcess
futtatási munkamenetével egy időben fut. Enter-PSHostProcess csak a Windows PowerShellt futtató folyamatokat adhatja meg. Vagyis betöltötték a Windows PowerShell-motort.
Ha ki szeretne lépni egy folyamatból a folyamatból, írja be a kilépést, majd nyomja le az Enter billentyűt.