Compartir a través de

about_WSMan_Provider

  • Artículo

Nombre del proveedor

WSMan

Unidades

WSMan:

Descripción breve

Proporciona acceso a la información de configuración de los Servicios web para la administración (WS-Management).

Descripción detallada

Esta información solo se aplica a PowerShell que se ejecuta en Windows.

El proveedor WSMan para PowerShell le permite agregar, cambiar, borrar y eliminar datos de configuración WS-Management en equipos locales o remotos.

El proveedor WSMan expone una unidad de PowerShell con una estructura de directorios que corresponde a una agrupación lógica de WS-Management opciones de configuración. Estas agrupaciones se conocen como contenedores.

A partir de Windows PowerShell 3.0, el proveedor WSMan se ha actualizado para admitir nuevas propiedades para las configuraciones de sesión, como OutputBufferingMode. Las configuraciones de sesión aparecen como elementos en el directorio Plugin de la WSMan: unidad y las propiedades aparecen como elementos en cada configuración de sesión.

El proveedor WSMan admite los siguientes cmdlets, que se tratan en este artículo.

Nota

Puede usar comandos en la WSMan: unidad para cambiar los valores de las nuevas propiedades. Sin embargo, no puede usar la WSMan: unidad en PowerShell 2.0 para cambiar las propiedades introducidas en Windows PowerShell 3.0. Aunque no se genera ningún error, los comandos no son efectivos para cambiar esta configuración, use la unidad WSMan en Windows PowerShell 3.0.

Organización de WSMan: Drive

  • Cliente: puede configurar varios aspectos del cliente de WS-Management. La información de configuración se almacena en el Registro.

  • Servicio: puede configurar varios aspectos del servicio WS-Management. La información de configuración se almacena en el Registro.

    Nota

    la configuración del servicio se conoce a veces como configuración del servidor.

  • Shell: puede configurar varios aspectos del shell de WS-Management, como la configuración para permitir el acceso remoto al shell (AllowRemoteShellAccess) y el número máximo de usuarios simultáneos permitidos (MaxConcurrentUsers).

  • Agente de escucha: puede crear y configurar un agente de escucha. Un agente de escucha es un servicio de administración que implementa el protocolo WS-Management para enviar y recibir mensajes.

  • Complemento: los complementos se cargan y usan el servicio WS-Management para proporcionar diversas funciones. De forma predeterminada, PowerShell proporciona tres complementos:

    • Complemento de reenvío de eventos.
    • Complemento Microsoft.PowerShell.
    • Complemento del proveedor de Instrumental de administración de Windows (WMI). Estos tres complementos admiten el reenvío de eventos, la configuración y el acceso WMI.

  • ClientCertificate: puede crear y configurar un certificado de cliente. Se utiliza un certificado de cliente cuando el cliente de WS-Management está configurado para utilizar la autenticación de certificado.

Jerarquía de directorios del proveedor WSMan

La jerarquía de directorios del proveedor WSMan para el equipo local es la siguiente.

WSMan:\localhost
--- Client
--- Service
--- Shell
--- Listener
------ <Specific_Listener>
--- Plugin
------ Event Forwarding Plugin
--------- InitializationParameters
--------- Resources
------------ Security
------ Microsoft.Powershell
--------- InitializationParameters
--------- Resources
------------ Security
------ WMI Provider
--------- InitializationParameters
--------- Resources
------------ Security
--- ClientCertificate

La jerarquía de directorios del proveedor WSMan para un equipo remoto es la misma que la de un equipo local. Sin embargo, para tener acceso a los valores de configuración de un equipo remoto, necesitará establecer una conexión con el equipo remoto mediante Connect-WSMan. Una vez que se realiza una conexión a un equipo remoto, se muestra el nombre del equipo remoto en el proveedor.

WSMan:\<Remote_Computer_Name>

Este comando usa el Set-Location cmdlet para cambiar la ubicación actual a la WSMan: unidad.

Set-Location WSMan:

Para volver a una unidad del sistema de archivos, escriba el nombre de la unidad. Por ejemplo, escriba .

Set-Location C:

Este comando usa el Set-Location comando para cambiar la ubicación actual a la ubicación raíz en la ubicación del almacén del sistema remoto. Use una \ barra diagonal / inversa o diagonal para indicar un nivel de la WSMan: unidad.

Set-Location -Path  WSMan:\SERVER01

Nota

El comando anterior da por supuesto que existe una conexión con el sistema remoto.

Mostrar el contenido de la unidad WSMan:

Este comando usa el Get-Childitem cmdlet para mostrar los almacenes de WS-Management en la ubicación del almacén localhost.

Get-ChildItem -path WSMan:\Localhost

Si está en la WSMan: unidad, puede omitir el nombre de la unidad.

Este comando usa el Get-Childitem cmdlet para mostrar los almacenes de WS-Management en la ubicación del almacén "SERVER01" del equipo remoto.

Get-ChildItem -path WSMan:\SERVER01

Nota

El comando anterior da por supuesto que existe una conexión con el sistema remoto.

Establecer el valor de los elementos en la unidad WSMAN:

Puede usar el cmdlet para cambiar las Set-Item opciones de configuración en la WSMAN unidad. En el ejemplo siguiente se establece el valor TrustedHosts para aceptar todos los hosts con el sufijo "contoso.com".

# You do not need to specify the -Path parameter name when using Set-Item.
PS WSMAN:\localhost\Client> Set-Item .\TrustedHosts -Value "*.contoso.com"

El Set-Item cmdlet admite un parámetro -Concatenate adicional que anexa un valor en lugar de cambiarlo. En el ejemplo siguiente se anexará un nuevo valor "*.domain2.com" al valor anterior almacenado en TrustedHost:

Set-Item WSMAN:\localhost\Client\TrustedHosts *.domain2.com -Concatenate

Creación de elementos en la unidad WSMAN:

Creación de un nuevo agente de escucha

El New-Item cmdlet crea elementos dentro de una unidad de proveedor. Cada proveedor tiene diferentes tipos de elementos que puede crear. En la WSMAN: unidad, puede crear agentes de escucha que configure para recibir y responder a solicitudes remotas. El siguiente comando crea un nuevo agente de escucha HTTP mediante el New-Item cmdlet .

New-Item -Path WSMan:\localhost\Listener -Address * -Transport HTTP -force

Creación de un complemento

Este comando crea (registra) un complemento para el servicio WS-Management.

New-Item -Path WSMan:\localhost\Plugin `
         -Plugin TestPlugin `
         -FileName %systemroot%\system32\WsmWmiPl.dll `
         -Resource http://schemas.dmtf.org/wbem/wscim/2/cim-schema `
         -SDKVersion 1 `
         -Capability "Get","Put","Invoke","Enumerate" `
         -XMLRenderingType text

Creación de una nueva entrada de recursos

Este comando crea una entrada de recursos en el directorio Resources de testPlugin. Este comando supone que se ha creado un testPlugin mediante un comando independiente.

New-Item -Path WSMan:\localhost\Plugin\TestPlugin\Resources `
         -ResourceUri http://schemas.dmtf.org/wbem/wscim/3/cim-schema `
         -Capability "Enumerate"

Creación de una nueva entrada de seguridad para un recurso

Este comando crea una entrada de seguridad en el directorio Seguridad de Resource_5967683 (un recurso específico). Este comando supone que la entrada de recursos se ha creado mediante un comando independiente.

$path = "WSMan:\localhost\Plugin\TestPlugin\Resources\Resource_5967683"
New-Item -Path $path\Security `
         -Sddl "O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;SA;GWGX;;;WD)"

Creación de un nuevo certificado de cliente

Este comando crea una entrada ClientCertificate que el cliente de WS-Management puede usar. El nuevo ClientCertificate se mostrará en el directorio ClientCertificate como "ClientCertificate_1234567890". Todos los parámetros son obligatorios. El emisor debe ser la huella digital del certificado de emisores.

$cred = Get-Credential
New-Item -Path WSMan:\localhost\ClientCertificate `
         -Issuer 1b3fd224d66c6413fe20d21e38b304226d192dfe `
         -URI wmicimv2/* `
         -Credential $cred;

Creación de un nuevo parámetro de inicialización

Este comando crea un parámetro initialization denominado "testparametername" en el directorio "InitializationParameters". Este comando supone que se ha creado "TestPlugin" mediante un comando independiente.

New-Item -Path WSMan:\localhost\Plugin\TestPlugin\InitializationParameters `
         -ParamName testparametername `
         -ParamValue testparametervalue

Parámetros dinámicos

Los parámetros dinámicos son parámetros de cmdlet que agrega un proveedor de PowerShell y solo están disponibles cuando el cmdlet se usa en la unidad habilitada para el proveedor.

Cadena de dirección <>

Especifica la dirección para la que se creó este agente de escucha. El valor puede ser uno de los siguientes:

  • Cadena literal "*". (El carácter comodín (*) hace que el comando enlace todas las direcciones IP de todos los adaptadores de red).
  • Cadena literal "IP:" seguida de una dirección IP válida en formato IPv4 dotted-decimal o en formato cloned-hexadecimal IPv6.
  • Cadena literal "MAC:" seguida de la dirección MAC de un adaptador. Por ejemplo: MAC:32-a3-58-90-be-cc.

Nota

El valor de la dirección se establece al crear un agente de escucha.

Cmdlets admitidos

Enumeración de funcionalidad <>

Cuando se trabaja con complementos , este parámetro especifica una operación que se admite en este identificador uniforme de recursos (URI). Debe crear una entrada para cada tipo de operación que admita el URI. Puede especificar cualquier atributo válido para una operación determinada, si la operación la admite.

Estos atributos incluyen SupportsFiltering y SupportsFragment.

  • Create: las operaciones de Create se admiten en el URI.
    • El atributo SupportFragment se usa si la operación de Create admite el concepto.
    • El atributo SupportFiltering NO es válido para las operaciones de Create y debe establecerse en "False".

    Nota

    Esta operación no es válida para un URI si también se admiten las operaciones de shell.

  • Eliminar: las operaciones de eliminación se admiten en el URI.
    • El atributo SupportFragment se usa si la operación Delete admite el concepto.
    • El atributo SupportFiltering NO es válido para las operaciones delete y debe establecerse en "False".

    Nota

    Esta operación no es válida para un URI si también se admiten las operaciones de shell.

  • Enumerar: las operaciones de enumeración se admiten en el URI.
    • El atributo SupportFragment NO se admite para las operaciones Enumerate y debe establecerse en False.
    • El atributo SupportFiltering es válido y, si el complemento admite el filtrado, este atributo debe establecerse en "True".

    Nota

    Esta operación no es válida para un URI si también se admiten las operaciones de shell.

  • Get: las operaciones Get se admiten en el URI.
    • El atributo SupportFragment se usa si la operación Get admite el concepto.
    • El atributo SupportFiltering NO es válido para las operaciones Get y debe establecerse en "False".

    Nota

    Esta operación no es válida para un URI si también se admiten las operaciones de shell.

  • Invoke: las operaciones de invocación se admiten en el URI.
    • El atributo SupportFragment no se admite para las operaciones Invoke y debe establecerse en False.
    • El atributo SupportFiltering no es válido y debe establecerse en "False".

    Nota

    Esta operación no es válida para un URI si también se admiten las operaciones de shell.

  • Put: las operaciones put se admiten en el URI.
    • El atributo SupportFragment se usa si la operación Put admite el concepto.
    • El atributo SupportFiltering no es válido para las operaciones Put y debe establecerse en "False".

    Nota

    Esta operación no es válida para un URI si también se admiten las operaciones de shell.

  • Suscripción: las operaciones de suscripción se admiten en el URI.
    • El atributo SupportFragment no se admite para las operaciones Subscribe y debe establecerse en False.
    • El atributo SupportFiltering no es válido para las operaciones Subscribe y debe establecerse en "False".

    Nota

    Esta operación no es válida para un URI si también se admiten las operaciones de shell.

  • Shell: las operaciones de shell se admiten en el URI.
    • El atributo SupportFragment no se admite para las operaciones de Shell y debe establecerse en "False".
    • El atributo SupportFiltering no es válido para las operaciones de Shell y debe establecerse en "False".

    Nota

    Esta operación no es válida para un URI si también se admite cualquier otra operación.

    Nota

    Si se configuró una operación de shell para un URI, las operaciones Get, Put, Create, Delete, Invoke y Enumerate se procesan internamente en el servicio WS-Management (WinRM) para administrar los shells. Como resultado, el complemento no puede controlar las operaciones.

Cmdlets admitidos

CertificateThumbprint <String>

Especifica la huella digital del certificado del servicio.

Este valor representa la cadena de valores hexadecimales de dos dígitos en el campo de huella digital del certificado. Especifica el certificado de clave pública digital (X509) de una cuenta de usuario que tiene permiso para realizar esta acción. Los certificados se usan para la autenticación basada en certificados de cliente. Solo se pueden asignar a cuentas de usuario locales y no funcionan con cuentas de dominio. Para obtener una huella digital de certificado, use los Get-Item cmdlets o Get-ChildItem en la unidad de PowerShell Cert: .

Cmdlets admitidos

Boolean habilitado <>

Especifica si el agente de escucha está habilitado o deshabilitado. El valor predeterminado es True.

Cmdlets compatibles

FileName (plugin) <String>

Especifica el nombre de archivo del complemento de operaciones. Las variables de entorno que se colocan en esta entrada se expandirán en el contexto de los usuarios cuando se reciba una solicitud. Dado que cada usuario podría tener una versión diferente de la misma variable de entorno, cada usuario podría tener un complemento diferente. Esta entrada no puede estar en blanco y debe apuntar a un complemento válido.

Cmdlets compatibles

Cadena de nombre de <host>

Especifica el nombre de host del equipo en el que se ejecuta el servicio WS-Management (WinRM).

El valor debe ser un nombre de dominio completo, una cadena literal IPv4 o IPv6 o un carácter comodín.

Cmdlets compatibles

Cadena del emisor <>

Especifica el nombre de la entidad de certificación que emitió el certificado.

Cmdlets compatibles

Los <> complementos WS-Management son bibliotecas de vínculos dinámicos (DLL) nativas.

que conecta y amplía la funcionalidad de WS-Management . La API del complemento de WSW-Management proporciona funcionalidad que permite al usuario escribir complementos mediante la implementación de determinadas API para URI y operaciones de recursos compatibles. Una vez configurados los complementos para el servicio WS-Management (WinRM) o para Internet Information Services (IIS), los complementos se cargan en el host de WS-Management o en el host de IIS, respectivamente. Las solicitudes remotas se enrutan a estos puntos de entrada de complemento para realizar operaciones.

Cmdlets compatibles

Port <Unsigned Short Integer>

Especifica el puerto TCP para el que se creó este agente de escucha. Puede especificar cualquier valor entre 1 y 65535.

Cmdlets compatibles

Cadena de recurso <>

Especifica un extremo que representa un tipo distinto de valor u operación de administración. Un servicio expone uno o más recursos, y algunos recursos pueden tener más de una instancia. Un recurso de administración es similar a una clase WMI o a una tabla de base de datos, y una instancia es similar a una instancia de la clase o a una fila de la tabla. Por ejemplo, la clase Win32_LogicalDisk representa un recurso. Win32_LogicalDisk="C:\\" es una instancia específica del recurso.

Un identificador uniforme de recursos (URI) contiene un prefijo y una ruta de acceso a un recurso. Por ejemplo:

http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor

Cmdlets compatibles

Cadena de recurso <>

Especifica el identificador uniforme de recursos (URI) que identifica un tipo específico de recurso, como un disco o un proceso, en un equipo.

Un URI consta de un prefijo y una ruta de acceso a un recurso. Por ejemplo:

http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor

Cmdlets compatibles

SdkVersion <String>

Especifica la versión del SDK del complemento de WS-Management. El único valor válido es 1.

Cmdlets compatibles

Cadena de asunto <>

Especifica la entidad identificada por el certificado.

Cmdlets compatibles

Cadena de transporte <>

Especifica el transporte que se va a utilizar para enviar y recibir las solicitudes y las respuestas del protocolo WS-Management. El valor debe ser HTTP o HTTPS.

Nota: El valor de transporte se establece al crear un agente de escucha.

Cmdlets compatibles

Cadena de URI <>

Identifica el URI para el que se autoriza el acceso en función del valor del parámetro Sddl.

Cmdlets compatibles

UrlPrefix <String>

Un prefijo de dirección URL en el que se aceptan solicitudes de HTTP o HTTPS. Se trata de una cadena que contiene solo los caracteres [a-z], [A-Z], [9-0]carácter de subrayado () y barra diagonal inversa_ (/). La cadena no debe comenzar con ni terminar con una barra diagonal inversa (/). Por ejemplo, si el nombre del equipo es "SampleComputer", el cliente de WS-Management especificaría http://SampleMachine/URLPrefix en la dirección de destino.

Cmdlets compatibles

Cadena de valor <>

Especifica el valor de un parámetro de inicialización, que es un valor específico del complemento utilizado para especificar las opciones de configuración.

Cmdlets compatibles

CADENA XMLRenderingType <>

Especifica el formato en el que se pasa XML a los complementos a través del objeto WSMAN_DATA . Los valores válidos son los siguientes:

  • Texto: los datos XML entrantes se encuentran en una estructura WSMAN_DATA_TYPE_TEXT , que representa el XML como un búfer de memoria PCWSTR .
  • XMLReader: los datos XML entrantes se encuentran en una estructura WSMAN_DATA_TYPE_WS_XML_READER , que representa el XML como un objeto XmlReader , que se define en el archivo de encabezado "WebServices.h".

Cmdlets compatibles

Uso de la canalización

Los cmdlets del proveedor aceptan entradas de canalización. Puede usar la canalización para simplificar la tarea mediante el envío de datos del proveedor de un cmdlet a otro cmdlet de proveedor. Para más información sobre cómo usar la canalización con cmdlets de proveedor, consulte las referencias de cmdlet proporcionadas en este artículo.

Ayuda

A partir de Windows PowerShell 3.0, puede obtener temas de ayuda personalizados sobre cmdlets de proveedor que explican cómo se comportan dichos cmdlets en una unidad del sistema de archivos.

Para obtener los temas de ayuda personalizados para la unidad del sistema de archivos, ejecute un comando Get-Help en una unidad del sistema de archivos o use el -Path parámetro de Get-Help para especificar una unidad del sistema de archivos.

Get-Help Get-ChildItem

Get-Help Get-ChildItem -Path wsman:

Consulte también