Acerca de los cmdlets de WS-ManagementAbout WS-Management Cmdlets

DESCRIPCIÓN BREVESHORT DESCRIPTION

Proporciona información general de los servicios web para administración (WS-Management) como referencia para usar los cmdlets de WS-Management en Windows PowerShell.Provides an overview of Web Services for Management (WS-Management) as background for using the WS-Management cmdlets in Windows PowerShell.

DESCRIPCIÓN LARGALONG DESCRIPTION

En este tema se proporciona información general de los servicios web para administración (WS-Management) como fondo para usar los cmdlets de WS-Management en Windows PowerShell.This topic provides an overview of Web Services for Management (WS-Management) as background for using the WS-Management cmdlets in Windows PowerShell. En este tema también se proporcionan vínculos a más información sobre WS-Management.This topic also provides links to more information about WS-Management. La implementación de Microsoft de WS-Management también se conoce como Administración remota de Windows (WinRM).The Microsoft implementation of WS-Management is also known as Windows Remote Management (WinRM).

Acerca de WS-ManagementAbout WS-Management

Administración remota de Windows es la implementación de Microsoft del Protocolo de WS-Management, un protocolo estándar compatible con firewall y basado en SOAP que permite que los sistemas operativos y de hardware de distintos proveedores interoperen.Windows Remote Management is the Microsoft implementation of the WS-Management protocol, a standard SOAP-based, firewall-friendly protocol that allows hardware and operating systems from different vendors to interoperate. La especificación del protocolo WS-Management proporciona una manera común de que los sistemas tengan acceso a la información de administración de una infraestructura de tecnología de la información (TI) y la intercambie.The WS-Management protocol specification provides a common way for systems to access and exchange management information across an information technology (IT) infrastructure. 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.WS-Management and Intelligent Platform Management Interface (IPMI), along with the Event Collector, are components of the Windows Hardware Management features.

El protocolo de WS-Management se basa en las siguientes especificaciones de servicio web estándar: HTTPS, SOAP sobre HTTP (perfil WS-I), SOAP 1,2, WS-Addressing, WS-Transfer, WS-Enumeration y WS-Eventing.The WS-Management protocol is based on the following standard Web service specifications: HTTPS, SOAP over HTTP (WS-I profile), SOAP 1.2, WS-Addressing, WS-Transfer, WS-Enumeration, and WS-Eventing.

WS-Management y WMIWS-Management and WMI

WS-Management se puede utilizar para recuperar los datos expuestos por Instrumental de administración de Windows (WMI).WS-Management can be used to retrieve data exposed by Windows Management Instrumentation (WMI). Puede obtener datos de WMI con scripts o aplicaciones que usan el WS-Management API de scripting o a través de la herramienta de línea de comandos de WinRM.You can obtain WMI data with scripts or applications that use the WS-Management Scripting API or through the WinRM command-line tool. WS-Management es compatible con la mayoría de las clases y operaciones de WMI conocidas, incluidos los objetos incrustados.WS-Management supports most of the familiar WMI classes and operations, including embedded objects. WS-Management puede aprovechar WMI para recopilar datos acerca de los recursos o para administrar recursos en equipos basados en Windows.WS-Management can leverage WMI to collect data about resources or to manage resources on a Windows-based computers. 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.That means that you can obtain data about objects such as disks, network adapters, services, or processes in your enterprise through the existing set of WMI classes. También puede tener acceso a los datos de hardware que están disponibles en el proveedor IPMI estándar de WMI.You can also access the hardware data that is available from the standard WMI IPMI provider.

WS-Management proveedor de Windows PowerShell (WSMan)WS-Management Windows PowerShell Provider (WSMan)

El proveedor WSMan proporciona una vista jerárquica de las opciones de configuración de WS-Management disponibles.The WSMan provider provides a hierarchical view into the available WS-Management configuration settings. El proveedor permite explorar y establecer las diversas opciones de configuración de WS-Management.The provider allows you to explore and set the various WS-Management configuration options.

Configuración de WS-ManagementWS-Management Configuration

Si WS-Management no está instalado y configurado, la comunicación remota de Windows PowerShell no está disponible, los cmdlets de WS-Management no se ejecutan, no se ejecutan WS-Management scripts y el proveedor de WSMan no puede realizar operaciones de datos.If WS-Management is not installed and configured, Windows PowerShell remoting is not available, the WS-Management cmdlets do not run, WS-Management scripts do not run, and the WSMan provider cannot perform data operations. La herramienta de línea de comandos de WS-Management, WinRM y el reenvío de eventos también dependen de la configuración de WS-Management.The WS-Management command-line tool, WinRM, and event forwarding also depend on the WS-Management configuration.

Cmdlets de WS-ManagementWS-Management Cmdlets

WS-Management funcionalidad se implementa en Windows PowerShell a través de un módulo que contiene un conjunto de cmdlets y el proveedor de WSMan.WS-Management functionality is implemented in Windows PowerShell through a module that contains a set of cmdlets and the WSMan provider. Puede usar estos cmdlets para completar las tareas de un extremo a otro necesarias para administrar la configuración de WS-Management en equipos locales y remotos.You can use these cmdlets to complete the end-to-end tasks necessary to manage WS-Management settings on local and remote computers.

Están disponibles los siguientes cmdlets de WS-Management.The following WS-Management cmdlets are available.

Cmdlets de conexiónConnection Cmdlets

  • Connect-WSMan: conecta el equipo local al servicio WS-Management (WinRM) en un equipo remoto.Connect-WSMan: Connects the local computer to the WS-Management (WinRM) service on a remote computer.

  • Disconnect-WSMan: desconecta el equipo local del servicio WS-Management (WinRM) de un equipo remoto.Disconnect-WSMan: Disconnects the local computer from the WS-Management (WinRM) service on a remote computer.

Cmdlets de Management-DataManagement-Data Cmdlets

  • Get-WSManInstance: muestra información de administración de una instancia de recurso especificada por un URI de recurso.Get-WSManInstance: Displays management information for a resource instance that is specified by a resource URI.

  • Invoke-WSManAction: invoca una acción en el objeto de destino especificado por el URI de recurso y por los selectores.Invoke-WSManAction: Invokes an action on the target object that is specified by the resource URI and by the selectors.

  • New-WSManInstance: crea una nueva instancia de recurso de administración.New-WSManInstance: Creates a new management resource instance.

  • Remove-WSManInstance: elimina una instancia de recurso de administración.Remove-WSManInstance: Deletes a management resource instance.

  • Set-WSManInstance: modifica la información de administración relacionada con un recurso.Set-WSManInstance: Modifies the management information that is related to a resource.

Cmdlets de instalación y configuraciónSetup and Configuration Cmdlets

  • Set-WSManQuickConfig: configura el equipo local para la administración remota.Set-WSManQuickConfig: Configures the local computer for remote management. Puede usar el cmdlet Set-WSManQuickConfig para configurar WS-Management para permitir conexiones remotas con el servicio WS-Management (WinRM).You can use the Set-WSManQuickConfig cmdlet to configure WS-Management to allow remote connections to the WS-Management (WinRM) service. El cmdlet Set-WSManQuickConfig realiza las operaciones siguientes:The Set-WSManQuickConfig cmdlet performs the following operations:

    • Determina si el servicio WS-Management (WinRM) se está ejecutando.It determines whether the WS-Management (WinRM) service is running. Si el servicio WinRM no se está ejecutando, el cmdlet Set-WSManQuickConfig inicia el servicio.If the WinRM service is not running, the Set-WSManQuickConfig cmdlet starts the service.
    • Establece el tipo de inicio del servicio WS-Management (WinRM) en automático.It sets the WS-Management (WinRM) service startup type to automatic.
    • Crea un agente de escucha que acepta solicitudes de cualquier dirección IP.It creates a listener that accepts requests from any IP address. El protocolo de transporte predeterminado es HTTP.The default transport protocol is HTTP.
    • Habilita una excepción de Firewall para el tráfico WS-Management.It enables a firewall exception for WS-Management traffic.

    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".Note: To run this cmdlet in Windows Vista, Windows Server 2008, and later versions of Windows, you must start Windows PowerShell with the "Run as administrator" option.

  • Test-WSMan: comprueba que WS-Management esté instalado y configurado.Test-WSMan: Verifies that WS-Management is installed and configured. El cmdlet Test-WSMan comprueba si el servicio WS-Management (WinRM) se está ejecutando y está configurado en un equipo local o remoto.The Test-WSMan cmdlet tests whether the WS-Management (WinRM) service is running and configured on a local or remote computer.

  • Disable-WSManCredSSP: deshabilita la autenticación CredSSP en un equipo cliente.Disable-WSManCredSSP: Disables CredSSP authentication on a client computer.

  • Enable-WSManCredSSP: habilita la autenticación CredSSP en un equipo cliente.Enable-WSManCredSSP: Enables CredSSP authentication on a client computer.

  • Get-WSManCredSSP: obtiene la configuración relacionada con CredSSP para un equipo cliente.Get-WSManCredSSP: Gets the CredSSP-related configuration for a client computer.

Cmdlets específicos de WS-ManagementWS-Management-Specific Cmdlets

  • New-WSManSessionOption: crea un objeto WSManSessionOption para usarlo como entrada para uno o varios parámetros de un cmdlet WS-Management.New-WSManSessionOption: Creates a WSManSessionOption object to use as input to one or more parameters of a WS-Management cmdlet.

Información adicional sobre el WS-ManagementAdditional WS-Management Information

Para obtener más información acerca de WS-Management, vea los temas siguientes en la documentación de Windows.For more information about WS-Management, see the following topics in the Windows documentation.

Administración remota de WindowsWindows Remote Management

Acerca de Administración remota de WindowsAbout Windows Remote Management

Instalación y configuración de Administración remota de WindowsInstallation and Configuration for Windows Remote Management

Arquitectura de Administración remota de WindowsWindows Remote Management Architecture

Protocolo WS-ManagementWS-Management Protocol

Administración remota de Windows y WMIWindows Remote Management and WMI

URI de recursosResource URIs

Administración remota de hardwareRemote Hardware Management

EventosEvents

CONSULTE TAMBIÉNSEE ALSO

Connect-WSManConnect-WSMan

Disable-WSManCredSSPDisable-WSManCredSSP

Disconnect-WSManDisconnect-WSMan

Enable-WSManCredSSPEnable-WSManCredSSP

Get-WSManCredSSPGet-WSManCredSSP

Get-WSManInstanceGet-WSManInstance

Invoke-WSManActionInvoke-WSManAction

New-WSManInstanceNew-WSManInstance

Remove-WSManInstanceRemove-WSManInstance

Set-WSManInstanceSet-WSManInstance

Set-WSManQuickConfigSet-WSManQuickConfig

Test-WSManTest-WSMan