about_WS-Management_Cmdlets

Se aplica a: Windows PowerShell 2.0, Windows PowerShell 3.0, Windows PowerShell 4.0

TEMA

about_WS-Management_Cmdlets

DESCRIPCIÓN BREVE

Proporciona una introducción a los servicios web para administración (WS-Management) como fondo para usar los cmdlets de WS-Management de Windows PowerShell®.

DESCRIPCIÓN LARGA

Este tema proporciona una introducción a los servicios web para administración (WS-Management) como fondo para usar los cmdlets de WS-Management de Windows PowerShell. Este tema también proporciona vínculos a más información acerca de WS-Management. La implementación de Microsoft de WS-Management también recibe el nombre de Administración remota de Windows (WinRM).

ACERCA DE WS-MANAGEMENT

Administración remota de Windows es la implementación de Microsoft del protocolo WS-Management, un protocolo estándar basado en SOAP y compatible con firewall que permite que el hardware y sistemas operativos de proveedores diferentes puedan interoperar. La especificación del protocolo WS-Management proporciona una forma común para que los sistemas accedan e intercambien información de administración a través de una infraestructura de tecnología de la información. WS-Management y la Interfaz de administración de plataforma inteligente (IPMI), junto con el Recopilador de eventos son componentes de las características de Administración de hardware de Windows.

El protocolo WS-Management se basa en las siguientes especificaciones del servicio web estándar: HTTPS y SOAP sobre HTTP (perfil WS-I), SOAP 1.2, WS-Addressing, WS-Transfer, WS-Enumeration y WS-Eventing.

WS-MANAGEMENT Y WMI

WS-Management puede usarse para recuperar los datos expuestos por Instrumental de administración de Windows (WMI). Puede obtener datos de WMI con los scripts o aplicaciones que usan la API de scripting de WS-Management o mediante la herramienta de línea de comandos WinRM. WS-Management admite la mayoría de las clases y operaciones WMI más familiares, como los objetos incrustados. WS-Management puede aprovechar WMI para recopilar datos sobre recursos o para administrar los recursos en equipos basados en Windows. Esto significa que puede obtener datos sobre objetos como discos, adaptadores de red, servicios o procesos de su empresa a través del conjunto existente de clases WMI. También puede acceder a los datos de hardware que están disponibles en el proveedor de IPMI WMI.

PROVEEDOR DE WS-MANAGEMENT DE WINDOWS POWERSHELL (WSMan)

El proveedor de WSMan proporciona una vista jerárquica de las opciones de configuración disponibles de WS-Management. El proveedor le permite explorar y configurar las diversas opciones de configuración de WS-Management.

CONFIGURACIÓN DE WS-MANAGEMENT

Si WS-Management no está instalado y configurado, la comunicación remota con Windows PowerShell no está disponible, no se ejecutan los cmdlets ni los scripts de WS-Management, y el proveedor de WSMan no puede realizar operaciones de datos. WinRM, la herramienta de línea de comandos de WS-Management y el reenvío de eventos también dependen de la configuración de WS-Management.

CMDLETS DE WS-MANAGEMENT

La funcionalidad de WS-Management se implementa en Windows PowerShell a través de un módulo que contiene un conjunto de cmdlets y el proveedor de WSMan. Puede usar estos cmdlets para realizar las tareas de un extremo a otro necesarias para administrar la configuración de WS-Management en equipos locales y remotos.

Están disponibles los siguientes cmdlets de WS-Management.

Cmdlets de conexión

Connect-WSMan:

conecta el equipo local al servicio WS-Management (WinRM) en un equipo remoto.

Disconnect-WSMan:

Desconecta el equipo local del servicio WS-Management (WinRM) en un equipo remoto.

Cmdlets de datos de administración

Get-WSManInstance:

Muestra la información de administración de una instancia de un recurso especificada por un URI de recurso.

Invoke-WSManAction:

Invoca una acción en el objeto de destino especificado por el URI del recurso y los selectores.

New-WSManInstance:

crea una nueva instancia de un recurso de administración.

Remove-WSManInstance:

Elimina una instancia de recurso de administración.

Set-WSManInstance:

Modifica la información de administración que está relacionada con un recurso.

CMDLETS DE INSTALACIÓN Y CONFIGURACIÓN

Set-WSManQuickConfig:

Configura el equipo local para la administración remota. Puede usar el cmdlet Set-WSManQuickConfig para configurar WS-Management de manera que permita las conexiones remotas con el servicio WS-Management (WinRM). El cmdlet Set-WSManQuickConfig realiza las siguientes operaciones:

- Determina si se está ejecutando el servicio WS-Management (WinRM). Si no se está ejecutando el servicio WinRM, el cmdlet Set-WSManQuickConfig inicia el servicio.

Establece el tipo de inicio de servicio WS-Management (WinRM) en automático.

Crea un agente de escucha que acepta solicitudes de cualquier dirección IP. El protocolo de transporte predeterminado es HTTP.

Habilita una excepción de firewall para el tráfico de WS-Management.

Nota:

Para ejecutar este cmdlet en Windows Vista, Windows Server 2008 y versiones posteriores de Windows, debe iniciar Windows PowerShell con la opción "Ejecutar como administrador".

Test-WSMan: comprueba que WS-Management está instalado y configurado. El cmdlet Test-WSMan comprueba si el servicio WS-Management (WinRM) se está ejecutando y está configurado en un equipo local o remoto.

Disable-WSManCredSSP: deshabilita la autenticación CredSSP en un equipo cliente.

Enable-WSManCredSSP: habilita la autenticación CredSSP en un equipo cliente.

Get-WSManCredSSP: obtiene la configuración relacionada con CredSSP para un equipo cliente.

CMDLETS ESPECÍFICOS DE WS-MANAGEMENT

-- New-WSManSessionOption: crea un objeto WSManSessionOption que se usará como entrada para uno o varios parámetros de un cmdlet WS-Management.

Información adicional sobre WS-Management

Para obtener más información acerca de WS-Management, vea los temas siguientes en MSDN Library (Microsoft Developer Network).

"Windows Remote Management"

https://go.microsoft.com/fwlink/?LinkId=142321

"About Windows Remote Management"

https://go.microsoft.com/fwlink/?LinkId=142322

"Installation and Configuration for Windows Remote Management"

https://go.microsoft.com/fwlink/?LinkId=142323

"Windows Remote Management Architecture"

https://go.microsoft.com/fwlink/?LinkId=142324

"WS-Management Protocol"

https://go.microsoft.com/fwlink/?LinkId=142325

"Windows Remote Management and WMI"

https://go.microsoft.com/fwlink/?LinkId=142326

"Resource URIs"

https://go.microsoft.com/fwlink/?LinkId=142327

"Remote Hardware Management"

https://go.microsoft.com/fwlink/?LinkId=142328

"Events"

https://go.microsoft.com/fwlink/?LinkId=142329

VEA TAMBIÉN

Versión en línea: https://go.microsoft.com/fwlink/?LinkId=142331

Connect-WSMan

Disable-WSManCredSSP

Disconnect-WSMan

Enable-WSManCredSSP

Get-WSManCredSSP

Get-WSManInstance

Invoke-WSManAction

New-WSManInstance

Remove-WSManInstance

Set-WSManInstance

Set-WSManQuickConfig

Set-WSManSessionOption

Test-WSMan

PALABRAS CLAVE

about_WSMAN about_WinRM