Uso de la consola de Windows PowerShell basada en web

Actualizado: 24 de junio de 2013

Se aplica a: Windows Server 2012 R2, Windows Server 2012

Windows PowerShell Web Access permite a los usuarios iniciar sesión en un sitio web protegido para poder usar sesiones, scripts y cmdlets de Windows PowerShell para administrar un equipo remoto.

Dado que la consola de Windows PowerShell se ejecuta en un explorador web, se puede abrir en numerosos dispositivos cliente (son válidos casi todos los dispositivos que dispongan de un explorador web).

La consola de Windows PowerShell basada en web está destinada a un equipo remoto que especifican los usuarios como parte del proceso de inicio de sesión.

En este tema, se describe cómo iniciar sesión en la consola de Windows PowerShell Web Access basada en web y cómo comenzar a usarla.

No se describe cómo usar Windows PowerShell ni cómo ejecutar cmdlets o scripts. Para más información sobre recursos de scripting y cómo usar Windows PowerShell, vea la sección Consulte también al final de este tema.

Dispositivos cliente y exploradores admitidos

Windows PowerShell Web Access admite los siguientes exploradores de Internet. Aunque los exploradores móviles no se admiten oficialmente, muchos de ellos pueden ejecutar la consola de Windows PowerShell basada en web. También se espera que funcionen otros exploradores que aceptan cookies y ejecutan JavaScript y sitios web HTTPS, pero no se han probado de manera oficial.

Exploradores de equipos de escritorio admitidos

• Windows Internet Explorer para Microsoft Windows 8.0, 9.0, 10.0 y 11.0
• Mozilla Firefox 10.0.2
• Google Chrome 17.0.963.56m para Windows
• Apple Safari 5.1.2 para Windows
• Apple Safari 5.1.2 para Mac OS

Exploradores o dispositivos móviles mínimamente probados

• Windows Phone 7 y 7.5
• Google Android WebKit 3.1 Browser Android 2.2.1 (Kernel 2.6)
• Apple Safari para sistema operativo iPhone 5.0.1
• Apple Safari para sistema operativo iPad 2 5.0.1

Requisitos del explorador

Para usar la consola de Windows PowerShell Web Access basada en web, los exploradores deben poder hacer lo siguiente.

• Permitir cookies del sitio web de la puerta de enlace de Windows PowerShell Web Access.
• Abrir y leer páginas HTTPS.
• Abrir y ejecutar sitios web que usen JavaScript.

Inicio de sesión en Windows PowerShell Web Access

El administrador de Windows PowerShell Web Access debe proporcionar una dirección URL que es la dirección del sitio web de la puerta de enlace de Windows PowerShell Web Access de la organización. De forma predeterminada, esta dirección del sitio web es https://<server_name>/pswa.

Antes de iniciar sesión en Windows PowerShell Web Access, asegúrese de contar con el nombre o la dirección IP del equipo remoto que desea administrar. Debe ser un usuario autorizado en el equipo remoto, y el equipo debe estar configurado para admitir la administración remota. Para más información sobre de la configuración del equipo para que admita la administración remota, consulte el tema sobre cómo Enable and Use Remote Commands in Windows PowerShell (Habilitación y uso de comandos remotos en Windows PowerShell).

El método más sencillo de configurar el equipo para permitir la administración remota es ejecutar el Enable-PSRemoting -force cmdlet en el equipo, en una sesión de Windows PowerShell que se ha abierto con derechos de usuario elevados (ejecutar como administrador).

Para iniciar sesión en Windows PowerShell Web Access

1. Abra el sitio web de Windows PowerShell Web Access en una pestaña o ventana del explorador de Internet.

2. En la página de inicio de sesión de Windows PowerShell Web Access, proporcione su nombre de usuario de red, su contraseña y el nombre del equipo que desea administrar (y en el que es un usuario autorizado). Si el administrador de Windows PowerShell Web Access le ha indicado que use un URI a un servidor proxy o sitio personalizado en lugar de un nombre de equipo, seleccione URI de conexión en el campo Tipo de conexión y luego proporcione el URI.

   Nota

   • Si el equipo de destino se encuentra en un grupo de trabajo, use la siguiente sintaxis para proporcionar su nombre de usuario e iniciar sesión en el equipo: <workgroup_name>\<user_name>
   • Si el equipo de destino es el servidor de puerta de enlace, puede especificar localhost en el campo Nombre de equipo.
   • Si el equipo de destino es el servidor de puerta de enlace y este se encuentra en un grupo de trabajo, debe usar <workgroup name>\<user_name> en el campo Nombre de usuario. Puede usar localhost en el campo Nombre de equipo.

3. La sección Configuración de conexión opcional está relacionada con los requisitos de autorización del equipo remoto que desea administrar. Para obtener más información sobre los parámetros equivalentes a la configuración de conexión opcional, consulte la ayuda del cmdlet Enter-PSSession .

   Por lo general, las credenciales que use para pasar a través de la puerta de enlace de Windows PowerShell Web Access serán las mismas que reconoce el equipo remoto que desea administrar. No obstante, si desea usar credenciales diferentes de las especificadas en el paso 2 para administrar el equipo remoto, expanda la sección Configuración de conexión opcional y proporcione las credenciales alternativas. De lo contrario, vaya al paso 6.

4. Si el administrador de Windows PowerShell Web Access ha creado una configuración de sesión personalizada para los usuarios de Windows PowerShell Web Access, escriba el nombre de la configuración de sesión en el campo Nombre de la configuración. Para obtener más información sobre las configuraciones de sesión, consulte about_Session_Configurations.

5. Deje el Tipo de autenticación establecido en Predeterminado, a menos que el administrador de Windows PowerShell Web Access le haya dado otras indicaciones.

6. Haga clic en Iniciar sesión.

Cierre de sesión y tiempo de espera agotado

Una sesión de Windows PowerShell basada en web se cerrará si el usuario:

• Hace clic en Cerrar sesión en la esquina inferior derecha de la consola. (Solo Windows Server 2012)

• Hace clic en Guardar o Salir en la esquina inferior derecha de la consola (solo Windows Server 2012 R2). Si hace clic en Guardar se guarda y se cierra la sesión de Windows PowerShell Web Access y puede volver a conectarse a la sesión más tarde. Al iniciar sesión en Windows PowerShell Web Access de nuevo, Windows PowerShell Web Access muestra una lista de las sesiones guardadas y puede optar por seleccionar una sesión guardada y conectarse a ella, o iniciar una sesión nueva. El administrador de puerta de enlace configura el número máximo de sesiones abiertas que se permite tener a los usuarios, tanto guardadas como activas.

  Si hace clic en Salir se cierra la sesión de Windows PowerShell Web Access sin guardarla.

• Intenta iniciar sesión para administrar otro equipo remoto en la misma sesión del explorador o en una nueva pestaña de la misma sesión del explorador. (Esto no se aplica si el servidor de puerta de enlace está ejecutando Windows Server 2012 R2; Windows PowerShell Web Access que se ejecuta en Windows Server 2012 R2 permite varias sesiones de usuario en nuevas pestañas en la misma sesión del explorador). Para obtener más información sobre cómo usar más de una sesión activa en el mismo equipo, consulte Conexión a varios equipos de destino simultáneamente en la sección Limitaciones de la consola basada en web de este tema.

• No se hay ninguna actividad en la sesión durante 20 minutos. El administrador de la puerta de enlace puede personalizar el período de tiempo de espera de inactividad; para obtener más información, consulte Administración de sesiones.

  • Si está desconectado de una sesión en la consola basada en web debido a un error de red u otros apagados o errores no planificados y no porque haya cerrado las sesiones usted mismo, las sesiones de Windows PowerShell Web Access continúan ejecutándose, conectadas al equipo de destino, hasta que venza el período de tiempo de espera del cliente. De forma predeterminada, este período de tiempo de espera es de 20 minutos y lo configura el Administrador de puerta de enlace. La sesión se desconecta después de los 20 minutos predeterminados o después del período de tiempo de espera especificado por el administrador de la puerta de enlace, el que sea más corto.

    Si el servidor de puerta de enlace está ejecutando Windows Server 2012 R2, Windows PowerShell Web Access permite a los usuarios volver a conectarse a las sesiones guardadas anteriormente, pero no puede ver o volver a conectarte a las sesiones guardadas hasta que haya vencido el período de tiempo de espera especificado por el administradorde la puerta de enlace.

• Cierra la pestaña o ventana del explorador.

• Apaga el dispositivo cliente en el que se ejecuta el explorador o lo desconecta de la red.

• Ejecuta el comando Exit en la consola web. Este comando no funciona si la configuración de sesión a la cual está conectado se ha establecido para admitir el modo NoLanguage o se encuentra en un espacio de ejecución restringido.

Si quiere volver a iniciar sesión, abra de nuevo la página web de Windows PowerShell Web Access e inicie sesión siguiendo los pasos descritos en Inicio de sesión en Windows PowerShell Web Access de este tema.

Diferencias de la consola de Windows PowerShell basada en web

Después de iniciar sesión en Windows PowerShell Web Access, se abre una consola de Windows PowerShell basada en web en la ventana o pestaña del explorador. Dado que la consola está conectada al equipo remoto que especificó durante el proceso de inicio de sesión, solo los cmdlets o scripts Windows PowerShell que están disponibles en el equipo remoto se pueden usar en la consola. Esta sección describe otras limitaciones de las consolas de Windows PowerShell Web Access y las diferencias entre las consolas de Windows PowerShell Web Access y la consola PowerShell.exe instalada.

Diferencias funcionales con PowerShell.exe

La mayoría de las funcionalidades del host de Windows PowerShell están disponibles en la consola de Windows PowerShell Web Access basada en web, pero hay algunas características que no se encuentran disponibles.

• Visualización del progreso anidado.

  Windows PowerShell Web Access muestra una GUI de progreso para los cmdlets que notifican el progreso, pero solo se muestra información de progreso de nivel superior.

• Modificación del color de entrada.

  No se puede cambiar el color de entrada (ni el del primer plano ni el del fondo). El estilo de los mensajes detallados, de resultados, de advertencia y de error se puede cambiar mediante la ejecución de un script.

• PSHostRawUserInterface.

  Windows PowerShell Web Access se implementa a través de la administración remota de Windows PowerShell y utiliza un espacio de ejecución remoto. Windows PowerShell Web Access no implementa algunos métodos en esta interfaz; por ejemplo, no implementa ningún comando que escriba en la consola Windows. Los comandos como PowerTab no funcionan en Windows PowerShell Web Access.

• Teclas de función.

  Windows PowerShell Web Access no admite algunas teclas de función; en muchos casos, esto se debe a que los comandos están reservados por el explorador.

Teclas de acceso directo no compatibles

Tecla de función	Acción
Ctrl+C	En Windows PowerShell Web Access, la combinación de teclas Ctrl+C la utiliza el explorador para copiar contenido. La consola ofrece un botón Cancelar y los usuarios también pueden usar Ctrl+Q para cancelar comandos.
Alt+Espacio, e, l	Desplazarse por el búfer de pantalla
Alt+Espacio, e, f	Buscar texto en el búfer de pantalla
Alt+Espacio, e, k	Seleccionar texto para copiarlo desde el búfer de pantalla
Alt+Espacio, e, p	Pegar contenido del Portapapeles en la consola de Windows PowerShell
Alt+Espacio, c	Cerrar la consola de Windows PowerShell
Ctrl+Inter	Forzar el cierre de la ventana de Windows PowerShell
Ctrl+Inicio	Eliminar desde el comienzo de la línea de comandos actual
Ctrl+Fin	Eliminar hasta el final de la línea de comandos
F1	Mover el cursor un carácter a la derecha en la línea de comandos
F2	Crear un nuevo comando copiando el último comando hasta el carácter que escriba
F3	Completar la línea de comandos con contenido de la última línea de comandos
F4	Eliminar caracteres desde la posición del cursor
F5	Examinar el historial de comandos hacia atrás. Para acceder a los comandos del historial de comandos en Windows PowerShell Web Access, haga clic en los botones de desplazamiento del Historial en la consola basada en web.
F7	Seleccionar de manera interactiva un comando del historial de comandos
F8	Examinar el historial mostrando los comandos que coinciden con el texto actual
F9	Ejecutar un comando numerado específico desde el historial
Re Pág	Ejecutar el primer comando del historial
Av Pág	Ejecutar el último comando del historial
Alt+F7	Borrar la lista del historial de comandos

Limitaciones de la consola basada en web

• Salto doble

  Puede encontrarse con la limitación del salto doble (o la conexión a un segundo equipo desde la primera conexión) si intenta crear una nueva sesión o trabajar en ella usando Windows PowerShell Web Access. Windows PowerShell Web Access usa un espacio de ejecución remoto y, actualmente, PowerShell.exe no admite el establecimiento de una conexión remota a un segundo equipo desde un espacio de ejecución remoto. Si intenta conectarse a un segundo equipo remoto desde una conexión existente usando el cmdlet Enter-PSSession, por ejemplo, puede obtener varios errores, como “No se pueden obtener recursos de red”.

  Para evitar los errores de salto doble, el administrador debe configurar la autenticación CredSSP en el entorno de red de la organización. Para más información sobre cómo configurar la autenticación CredSSP, consulte CredSSP para la comunicación remota de segundo salto en el blog de PowerShell. También puede proporcionar credenciales explícitas si desea administrar un segundo equipo remoto (es poco probable que las credenciales implícitas permitan el segundo salto).

• Comunicación remota

  Windows PowerShell Web Access usa y tiene las mismas limitaciones que una sesión remota de Windows PowerShell. Los comandos que llaman directamente a las API de la consola Windows, por ejemplo, los comandos de editores basados en consola o de programas de menú basados en texto, no funcionan porque no leen o escriben en canalizaciones estándar de entrada, de salida o de error. Por lo tanto, los comandos que inician un archivo ejecutable, como notepad.exe, o muestran una GUI, como OpenGridView u ogv, no funcionan. Su experiencia se verá afectada por este comportamiento, ya que parecerá que Windows PowerShell Web Access no está respondiendo al comando.

• Finalización con tabulación

  La finalización con tabulación no funciona en una configuración de sesión con un espacio de ejecución restringido o en una que se encuentre en modo NoLanguage. Si bien los administradores pueden configurar una sesión para que admita la finalización con tabulación, esto se desaconseja por motivos de seguridad, dado que puede exponer la siguiente información a usuarios que no están autorizados.

  • Rutas de acceso internas del sistema de archivos
  • Carpetas compartidas en equipos internos
  • Variables del espacio de ejecución
  • Espacios de nombres de .NET Framework o tipos cargados
  • Variables de entorno

• Sesión NoLanguage o espacio de ejecución restringido

  Los usuarios que han iniciado sesión en una configuración de sesión NoLanguage o en un espacio de ejecución restringido en Windows PowerShell Web Access no pueden ejecutar el comando Exit para finalizar la sesión. Para cerrar sesión, los usuarios deben hacer clic en Cerrar sesión en la página de la consola.

• Conexión simultánea a varios equipos de destino.

  Si se está ejecutando el servidor de puerta de enlace de Windows Server 2012, Windows PowerShell Web Access solo permite una conexión de equipo remoto por sesión del explorador. No permite a los usuarios iniciar sesión una vez y conectarse a varios equipos remotos mediante pestañas del explorador independientes. Al abrir una nueva pestaña o ventana del explorador, Windows PowerShell Web Access le pedirá que desconecte su sesión actual e inicie una nueva sesión, para permitirle conectarse a un nuevo equipo remoto (o al mismo). No obstante, si desea iniciar sesión en dos o varias sesiones individuales en equipos remotos distintos, existe una característica de Internet Explorer que le permite crear una nueva sesión. Para iniciar una nueva sesión del explorador en Internet Explorer, presione ALT, abra el menú Archivo y luego seleccione Nueva sesión. Después, abra el sitio web de Windows PowerShell Web Access en una nueva sesión e inicie sesión para obtener acceso a otro equipo remoto.

  Cuando la puerta de enlace de Windows PowerShell Web Access se está ejecutando en Windows Server 2012 R2, los usuarios pueden abrir varias conexiones a equipos remotos en pestañas diferentes del explorador. Si quiere abrir más de una conexión a un equipo remoto usando la consola de Windows PowerShell basada en web, póngase en contacto con su administrador de puerta de enlace de Windows PowerShell Web Access para ver si esta característica es compatible con el servidor de puerta de enlace.

• Sesiones persistentes de Windows PowerShell (reconexión).

  Una vez agotado el tiempo de espera de la puerta de enlace de Windows PowerShell Web Access, se cierra la conexión remota entre esa puerta de enlace y el equipo de destino. Esto detiene cualquier cmdlet o script que se encuentre en curso actualmente. Se recomienda usar la infraestructura -Job de Windows PowerShell al llevar a cabo tareas de ejecución prolongadas, para que pueda iniciar trabajos, desconectarse del equipo, volver a conectarte más tarde y hacer que los trabajos sean persistentes. Otra ventaja de usar cmdlets -Job es que puede iniciarlos mediante Windows PowerShell Web Access, cerrar la sesión y volver a conectarse más adelante, ya sea ejecutando Windows PowerShell Web Access u otro host (como Windows PowerShell Entorno de scripting integrado (ISE)).

• Cambiar el tamaño de la consola.

  Se puede cambiar el tamaño de la ventana de la consola de PowerShell.exe de las tres maneras siguientes.

  • Arrastrar y ajustar el tamaño de la ventana de la consola con el mouse

  • Cambiar las propiedades de alto y ancho mediante una GUI para propiedades de consola

  • Cambiar el alto y el ancho de la ventana de la consola mediante un cmdlet

    La ventana de la consola de Windows PowerShell Web Access se puede configurar mediante cmdlets, de la siguiente manera. En el ejemplo siguiente, un usuario cambia el ancho de Windows PowerShell consola de Web Access a 20.

    $newSize = $Host.UI.RawUI.WindowSize
    $newSize.Width = $newSize.Width - 20
    $oldSize = $Host.UI.RawUI.WindowSize
    $Host.UI.RawUI.WindowSize = $newSize
    

    Puede cambiar el alto de la consola de modo similar.

    En el blog del equipo de Windows PowerShell encontrará ejemplos adicionales para personalizar la vista de consola.

Consulte también

• Hey, Scripting Guy!