Enter-PSSession

Sintaxis

ComputerName (valor predeterminado)

Enter-PSSession
    [-ComputerName] <String>
    [-EnableNetworkAccess]
    [-Credential <PSCredential>]
    [-Port <Int32>]
    [-UseSSL]
    [-ConfigurationName <String>]
    [-ApplicationName <String>]
    [-SessionOption <PSSessionOption>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <String>]
    [<CommonParameters>]

Session

Enter-PSSession
    [[-Session] <PSSession>]
    [<CommonParameters>]

Uri

Enter-PSSession
    [[-ConnectionUri] <Uri>]
    [-EnableNetworkAccess]
    [-Credential <PSCredential>]
    [-ConfigurationName <String>]
    [-AllowRedirection]
    [-SessionOption <PSSessionOption>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <String>]
    [<CommonParameters>]

InstanceId

Enter-PSSession
    [-InstanceId <Guid>]
    [<CommonParameters>]

Id

Enter-PSSession
    [[-Id] <Int32>]
    [<CommonParameters>]

Name

Enter-PSSession
    [-Name <String>]
    [<CommonParameters>]

VMId

Enter-PSSession
    [-VMGuid] <Guid>
    -Credential <PSCredential>
    [<CommonParameters>]

VMName

Enter-PSSession
    [-VMName] <String>
    -Credential <PSCredential>
    [<CommonParameters>]

Description

Ejemplos

Ejemplo 1: Iniciar una sesión interactiva

PS C:\> Enter-PSSession
[localhost]: PS C:\>

Ejemplo 2: Trabajar con una sesión interactiva

The first command uses the **Enter-PSSession** cmdlet to start an interactive session with Server01, a remote computer. When the session starts, the command prompt changes to include the computer name.
PS C:\> Enter-PSSession -ComputerName Server01
[Server01]: PS C:\>

The second command gets the Windows PowerShell process and redirects the output to the Process.txt file. The command is submitted to the remote computer, and the file is saved on the remote computer.
[Server01]: PS C:\> Get-Process PowerShell > C:\ps-test\Process.txt

The third command uses the **Exit** keyword to end the interactive session and close the connection.
[Server01]: PS C:\> exit
PS C:\>

The fourth command confirms that the Process.txt file is on the remote computer. A **Get-ChildItem** ("dir") command on the local computer cannot find the file.
PS C:\> dir C:\ps-test\process.txt
Get-ChildItem : Cannot find path 'C:\ps-test\process.txt' because it does not exist.
At line:1 char:4
+ dir <<<<  c:\ps-test\process.txt

Ejemplo 3: Uso del parámetro Session

PS C:\> $s = New-PSSession -ComputerName Server01
PS C:\> Enter-PSSession -Session $s
[Server01]: PS C:\>

Ejemplo 4: Iniciar una sesión interactiva y especificar los parámetros Port y Credential

PS C:\> Enter-PSSession -ComputerName Server01 -Port 90 -Credential Domain01\User01
[Server01]: PS C:\>

Ejemplo 5: Detener una sesión interactiva

PS C:\> Enter-PSSession -ComputerName Server01
[Server01]: PS C:\> Exit-PSSession
PS C:\>

Parámetros

-AllowRedirection

Permite el redireccionamiento de esta conexión a un identificador uniforme de recursos alternativo (URI). De forma predeterminada, no se permite el redireccionamiento.

Cuando utilizas el parámetro ConnectionURI, el destino remoto puede devolver una instrucción para redirigirse a un URI diferente. De forma predeterminada, Windows PowerShell no redirige las conexiones, pero puede usar este parámetro para permitir que redirija la conexión.

También puede limitar el número de veces que se redirige la conexión cambiando el valor de la opción de sesión MaximumConnectionRedirectionCount. Use el parámetro MaximumRedirection del cmdlet New-PSSessionOption o establezca la propiedad MaximumConnectionRedirectionCount de la variable de preferencia $PSSessionOption. El valor predeterminado es 5.

Propiedades de parámetro

Conjuntos de parámetros

-ApplicationName

Especifica el segmento del nombre de aplicación del URI de conexión. Use este parámetro para especificar el nombre de la aplicación cuando no use el parámetro ConnectionURI en el comando .

El valor predeterminado es el valor de la variable de preferencia $PSSessionApplicationName en el equipo local. Si no se define esta variable de preferencia, el valor predeterminado es WSMAN. Este valor es adecuado para la mayoría de los usos. Para obtener más información, consulte about_Preference_Variables.

El servicio WinRM usa el nombre de la aplicación para seleccionar un agente de escucha para atender la solicitud de conexión. El valor de este parámetro debe coincidir con el valor del URLPrefix propiedad de un agente de escucha en el equipo remoto.

Propiedades de parámetro

Conjuntos de parámetros

-Authentication

Especifica el mecanismo que se usa para autenticar las credenciales del usuario. Los valores aceptables para este parámetro son:

• Predeterminado
• Básico
• Credssp
• Resumen
• Kerberos
• Negociar
• NegotiateWithImplicitCredential

El valor predeterminado es Default.

La autenticación CredSSP solo está disponible en Windows Vista, Windows Server 2008 y versiones posteriores del sistema operativo Windows.

Para obtener más información sobre los valores de este parámetro, vea AuthenticationMechanism Enumeration en MSDN Library.

Precaución: La autenticación del proveedor de soporte técnico de seguridad de credenciales (CredSSP), en la que las credenciales del usuario se pasan a un equipo remoto que se va a autenticar, está diseñada para comandos que requieren autenticación en más de un recurso, como el acceso a un recurso compartido de red remoto. Este mecanismo aumenta el riesgo de seguridad de la operación remota. Si el equipo remoto está en peligro, se pueden usar las credenciales que se pasan a ella para controlar la sesión de red.

Propiedades de parámetro

Conjuntos de parámetros

-CertificateThumbprint

Especifica el certificado de clave pública digital (X509) de una cuenta de usuario que tiene permiso para realizar esta acción. Ingrese la huella digital del certificado.

Los certificados se usan en la autenticación basada en certificados de cliente. Solo se pueden asignar a cuentas de usuario locales; no funcionan con cuentas de dominio.

Para obtener un certificado, use el comando Get-Item o Get-ChildItem en la unidad Certificado de Windows PowerShell: .

Propiedades de parámetro

Conjuntos de parámetros

-ComputerName

Especifica un nombre de equipo. Este cmdlet inicia una sesión interactiva con el equipo remoto especificado. Escriba solo un nombre de equipo. El valor predeterminado es el equipo local.

Escriba el nombre NetBIOS, la dirección IP o el nombre de dominio completo del equipo. También puede canalizar un nombre de equipo para Enter-PSSession .

Para usar una dirección IP en el valor del parámetro ComputerName, el comando debe incluir el parámetro Credential . Además, el equipo debe configurarse para el transporte HTTPS o la dirección IP del equipo remoto debe incluirse en la lista WinRM TrustedHosts del equipo local. Para obtener instrucciones para agregar un nombre de equipo a la lista TrustedHosts, vea "Cómo agregar un equipo a la lista de hosts de confianza" en about_Remote_Troubleshooting.

Nota: En Windows Vista y versiones posteriores del sistema operativo Windows, para incluir el equipo local en el valor del parámetro ComputerName, debe iniciar Windows PowerShell con la opción Ejecutar como administrador.

Propiedades de parámetro

Conjuntos de parámetros

-ConfigurationName

Especifica la configuración de sesión que se usa para la sesión interactiva.

Escriba un nombre de configuración o el URI de un recurso completo para configurar una sesión. Si especifica solo el nombre de configuración, se antepone el siguiente URI de esquema: https://schemas.microsoft.com/powershell.

La configuración de sesión de una sesión se encuentra en el equipo remoto. Si la configuración de sesión especificada no existe en el equipo remoto, se produce un error en el comando.

El valor predeterminado es el valor de la variable de preferencia $PSSessionConfigurationName en el equipo local. Si no se establece esta variable de preferencia, el valor predeterminado es Microsoft.PowerShell. Para obtener más información, consulte about_Preference_Variables.

Propiedades de parámetro

Conjuntos de parámetros

-ConnectionUri

Especifica un URI que define el punto de conexión de la sesión. El identificador URI debe ser completo. El formato de esta cadena es el siguiente:

<transport>://<ComputerName>:<Port>/<ApplicationName>

El valor predeterminado es el siguiente:

https://localhost:5985/WSMAN

Si no especifica unConnectionURI de , puede usar los parámetros UseSSL, ComputerName, Porty ApplicationName para especificar los valores de ConnectionURI de .

Los valores válidos para el segmento Transporte del URI son HTTP y HTTPS. Si especifica un URI de conexión con un segmento de transporte, pero no especifica un puerto, la sesión se crea mediante puertos estándar: 80 para HTTP y 443 para HTTPS. Para usar los puertos predeterminados para la comunicación remota de Windows PowerShell, especifique el puerto 5985 para HTTP o 5986 para HTTPS.

Si el equipo de destino redirige la conexión a un URI diferente, Windows PowerShell impide el redireccionamiento a menos que use el parámetro AllowRedirection en el comando.

Propiedades de parámetro

Conjuntos de parámetros

-Credential

Especifica una cuenta de usuario que tiene permiso para realizar esta acción. El valor predeterminado es el usuario actual.

Escriba un nombre de usuario, como User01, Domain01\User01o User@Domain.com, o escriba un objeto de PSCredential, como uno devuelto por el cmdlet Get-Credential.

Al escribir un nombre de usuario, este cmdlet le pedirá una contraseña.

Propiedades de parámetro

Conjuntos de parámetros

-EnableNetworkAccess

Indica que este cmdlet agrega un token de seguridad interactivo a las sesiones de bucle invertido. El token interactivo permite ejecutar comandos en la sesión de bucle invertido que obtienen datos de otros equipos. Por ejemplo, puede ejecutar un comando en la sesión que copia archivos XML desde un equipo remoto al equipo local.

Una sesión de bucle invertido es un psSession de que se origina y termina en el mismo equipo. Para crear una sesión de bucle invertido, omita el parámetro computerName o establezca su valor en . (punto), localhost o el nombre del equipo local.

De forma predeterminada, las sesiones de bucle invertido se crean mediante un token de red, lo que podría no proporcionar permiso suficiente para autenticarse en equipos remotos.

El parámetro EnableNetworkAccess solo es efectivo en sesiones de bucle invertido. Si usa EnableNetworkAccess al crear una sesión en un equipo remoto, el comando se realiza correctamente, pero se omite el parámetro .

También puede permitir el acceso remoto en una sesión de bucle invertido mediante el de CredSSP del parámetro Authentication de , que delega las credenciales de sesión en otros equipos.

Este parámetro se introdujo en Windows PowerShell 3.0.

Propiedades de parámetro

Conjuntos de parámetros

-Id

Especifica el identificador de una sesión existente. enter-PSSession usa la sesión especificada para la sesión interactiva.

Para buscar el identificador de una sesión, use el cmdlet Get-PSSession.

Propiedades de parámetro

Conjuntos de parámetros

-InstanceId

Especifica el identificador de instancia de una sesión existente. enter-PSSession usa la sesión especificada para la sesión interactiva.

El identificador de instancia es un GUID. Para buscar el identificador de instancia de una sesión, use el cmdlet Get-PSSession. También puede usar los parámetros Session, Nameo ID para especificar una sesión existente. O bien, puede usar el parámetro ComputerName para iniciar una sesión temporal.

Propiedades de parámetro

Conjuntos de parámetros

-Name

Especifica el nombre descriptivo de una sesión existente. enter-PSSession usa la sesión especificada para la sesión interactiva.

Si el nombre especificado coincide con más de una sesión, se produce un error en el comando. También puede usar los parámetros de Session, InstanceIDo ID para especificar una sesión existente. O bien, puede usar el parámetro ComputerName para iniciar una sesión temporal.

Para establecer un nombre descriptivo para una sesión, use el parámetro Name del cmdlet New-PSSession .

Propiedades de parámetro

Conjuntos de parámetros

-Port

Especifica el puerto de red en el equipo remoto que se usa para este comando. Para conectarse a un equipo remoto, este debe estar escuchando en el puerto que usa la conexión. Los puertos predeterminados son 5985, que es el puerto WinRM para HTTP y 5986, que es el puerto winRM para HTTPS.

Antes de usar un puerto alternativo, debe configurar el agente de escucha winRM en el equipo remoto para que escuche en ese puerto. Use los siguientes comandos para configurar el agente de escucha:

1. winrm delete winrm/config/listener?Address=*+Transport=HTTP

2. winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number\>"}

No use el parámetro Port a menos que sea necesario. La configuración de puerto del comando se aplica a todos los equipos o sesiones en los que se ejecuta el comando. Una configuración de puerto alternativa podría impedir que el comando se ejecute en todos los equipos.

Propiedades de parámetro

Conjuntos de parámetros

-Session

Especifica una sesión de Windows PowerShell (PSSession) que se usará para la sesión interactiva. Este parámetro toma un objeto de sesión. También puede usar los parámetrosNameInstanceIDo ID para especificar unpsSession de .

Escriba una variable que contenga un objeto de sesión o un comando que cree o obtenga un objeto de sesión, como un comando New-PSSession o comando Get-PSSession. También puede canalizar un objeto de sesión para enter-PSSession. Solo puede enviar una psSession mediante este parámetro. Si escribe una variable que contiene más de una PSSession, se produce un error en el comando.

Cuando se usa Exit-PSSession o la palabra clave EXIT de , finaliza la sesión interactiva, pero el de PSSession que creó permanece abierto y disponible para su uso.

Propiedades de parámetro

Conjuntos de parámetros

-SessionOption

Establece opciones avanzadas para la sesión. Escriba un objeto SessionOption, como uno que cree mediante el cmdlet New-PSSessionOption, o una tabla hash en la que las claves son nombres de opción de sesión y los valores son valores de opción de sesión.

Los valores predeterminados de las opciones se determinan mediante el valor de la variable de preferencia $PSSessionOption, si se establece. De lo contrario, las opciones establecidas en la configuración de sesión establecen los valores predeterminados.

Los valores de opción de sesión tienen prioridad sobre los valores predeterminados de las sesiones establecidas en la variable de preferencia $PSSessionOption y en la configuración de la sesión. Sin embargo, no tienen prioridad sobre los valores máximos, cuotas o límites establecidos en la configuración de sesión.

Para obtener una descripción de las opciones de sesión, incluidos los valores predeterminados, consulte New-PSSessionOption. Para obtener información sobre la variable de preferencia de $PSSessionOption, vea about_Preference_Variables. Para obtener más información sobre las configuraciones de sesión, consulte about_Session_Configurations.

Propiedades de parámetro

Conjuntos de parámetros

-UseSSL

Indica que este cmdlet usa el protocolo Capa de sockets seguros (SSL) para establecer una conexión con el equipo remoto. De forma predeterminada, no se usa SSL.

WS-Management cifra todo el contenido de Windows PowerShell transmitido a través de la red. El parámetro UseSSL es una protección adicional que envía los datos a través de una conexión HTTPS en lugar de una conexión HTTP.

Si usa este parámetro, pero SSL no está disponible en el puerto que se usa para el comando, se produce un error en el comando.

Propiedades de parámetro

Conjuntos de parámetros

-VMGuid

Especifica el identificador de una máquina virtual.

Propiedades de parámetro

Conjuntos de parámetros

-VMName

Especifica el nombre de una máquina virtual.

Propiedades de parámetro

Conjuntos de parámetros

CommonParameters

Entradas

System.String, System.Management.Automation.Runspaces.PSSession

Salidas

None

Notas

Vínculos relacionados

• Exit-PSSession
• Get-PSSession
• Invoke-Command
• New-PSSession
• Remove-PSSession
• Connect-PSSession
• Disconnect-PSSession
• Receive-PSSession
• acerca_de_PSSessions
• acerca de Remote