Compartir a través de

Enter-PSHostProcess

  • Referencia
Módulo:
Microsoft.PowerShell.Core

Se conecta a y entra en una sesión interactiva con un proceso local.

Sintaxis

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>]

Description

El cmdlet Enter-PSHostProcess se conecta y entra en una sesión interactiva con un proceso local. A partir de PowerShell 6.2, este cmdlet se admite en plataformas que no son de Windows.

En lugar de crear un nuevo proceso para hospedar PowerShell y ejecutar una sesión remota, la sesión interactiva remota se ejecuta en un proceso existente que ya ejecuta PowerShell. Al interactuar con una sesión remota en un proceso especificado, puede enumerar los espacios de ejecución en ejecución y, a continuación, seleccionar un espacio de ejecución para depurar mediante la ejecución de Debug-Runspace o Enable-RunspaceDebug.

El proceso que desea especificar debe hospedar PowerShell (System.Management.Automation.dll). Debe ser miembro del grupo Administradores en el equipo en el que se encuentra el proceso o debe ser el usuario que ejecuta el script que inició el proceso.

Después de seleccionar un espacio de ejecución para depurar, se abre una sesión de depuración remota para el espacio de ejecución si está ejecutando actualmente un comando o se detiene en el depurador. Después, puede depurar el script de espacio de ejecución de la misma manera que depuraría otros scripts de sesión remota.

Desasocie de una sesión de depuración y, a continuación, la sesión interactiva con el proceso, ejecutando salir dos veces o detener la ejecución del script ejecutando el comando quit del depurador existente.

Si especifica un proceso mediante el parámetro Name y solo se encuentra un proceso con el nombre especificado, se escribe el proceso. Si se encuentra más de un proceso con el nombre especificado, PowerShell devuelve un error y enumera todos los procesos encontrados con el nombre especificado.

Para admitir la asociación a procesos en equipos remotos, el cmdlet Enter-PSHostProcess está habilitado en un equipo remoto especificado, de modo que pueda asociarse a un proceso local dentro de una sesión remota de PowerShell.

Ejemplos

Parte 1 del ejemplo: Iniciar la depuración de un espacio de ejecución en el proceso de PowerShell ISE

En este ejemplo, ejecutará Enter-PSHostProcess desde la consola de PowerShell para escribir el proceso de PowerShell ISE. En la sesión interactiva resultante, puede encontrar un espacio de ejecución que quiera depurar ejecutando Get-Runspacey, a continuación, depurar el espacio de ejecución.

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

Parte 2 de ejemplo: Depuración de un espacio de ejecución específico

A continuación, depure el identificador 4 del espacio de ejecución, que ejecuta el script de ejecución prolongada de otro usuario. En la lista devuelta de Get-Runspace, tenga en cuenta que el espacio de ejecución State está abierto y Availability está ocupado, lo que significa que el espacio de ejecución sigue ejecutando el script de larga duración. Los objetos de espacio de ejecución devueltos por Get-Runspace también tienen un NoteProperty denominado ScriptStackTrace de la pila de comandos en ejecución, si está disponible.

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

Inicie una sesión de depuración interactiva con este espacio de ejecución mediante la ejecución del cmdlet Debug-Runspace.

Parte 3 del ejemplo: Finalizar la sesión de depuración y salir

Una vez finalizada la depuración, permita que el script continúe ejecutándose sin el depurador adjunto mediante la ejecución del comando exit debugger. Como alternativa, puede salir del depurador con los comandos q o Stop.

Cuando haya terminado de trabajar en el proceso, salga del proceso ejecutando el cmdlet Exit-PSHostProcess. Esto le devuelve al símbolo del sistema de PS C:\>.

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

Parámetros

-AppDomainName

Especifica un nombre de dominio de aplicación al que conectarse si se omite, usa DefaultAppDomain. Use Get-PSHostProcessInfo para mostrar los nombres de dominio de la aplicación.

Tipo:String
Posición:1
Valor predeterminado:DefaultAppDomain
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CustomPipeName

Obtiene o establece el nombre de canalización con nombre personalizado al que se va a conectar. Normalmente se usa junto con pwsh -CustomPipeName.

Este parámetro se introdujo en PowerShell 6.2.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-HostProcessInfo

Especifica un objeto PSHostProcessInfo que se puede conectar a con PowerShell. Use Get-PSHostProcessInfo para obtener el objeto .

Tipo:PSHostProcessInfo
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Id

Especifica un proceso por el identificador de proceso. Para obtener un identificador de proceso, ejecute el cmdlet Get-Process.

Tipo:Int32
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifica un proceso por el nombre del proceso. Para obtener un nombre de proceso, ejecute el cmdlet Get-Process. También puede obtener nombres de proceso en el cuadro de diálogo Propiedades de un proceso en el Administrador de tareas.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Process

Especifica un proceso por el objeto process. La manera más sencilla de usar este parámetro es guardar los resultados de un comando Get-Process que devuelve el proceso que desea escribir en una variable y, a continuación, especificar la variable como valor de este parámetro.

Tipo:Process
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Entradas

Process

Notas

Enter-PSHostProcess no puede escribir el proceso de la sesión de PowerShell en la que ejecuta el comando . Sin embargo, puede escribir el proceso de otra sesión de PowerShell o una sesión de PowerShell ISE que se ejecuta al mismo tiempo que la sesión en la que se ejecuta Enter-PSHostProcess.

Enter-PSHostProcess solo puede especificar los procesos que hospedan PowerShell. Es decir, han cargado el motor de PowerShell.

Para salir de un proceso desde dentro del proceso, escriba saliry presione Entrar.

Antes de PowerShell 7.1, la comunicación remota a través de SSH no admitía sesiones remotas de segundo salto. Esta funcionalidad se limitaba a las sesiones que usan WinRM. PowerShell 7.1 permite que Enter-PSSession y Enter-PSHostProcess funcionen desde cualquier sesión remota interactiva.