about_WSMan_Provider

  • Artículo

Nombre del proveedor

WSMan

Unidades

WSMan:

Descripción breve

Proporciona acceso a la información de configuración de 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 de 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 las opciones de configuración de WS-Management. 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 del WSMan: Unidad

  • Cliente: puede configurar varios aspectos del cliente 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 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 usa un certificado de cliente cuando el cliente WS-Management está configurado para usar la autenticación de certificados.

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 un equipo local. Sin embargo, para acceder a los valores de configuración de un equipo remoto, debe establecer una conexión con el equipo remoto mediante Conectar-WSMan. Una vez realizada una conexión a un equipo remoto, el nombre del equipo remoto aparece 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 una barra diagonal / para indicar un nivel de la WSMan: unidad.

Set-Location -Path  WSMan:\SERVER01

Nota:

En el comando anterior se supone que ya existe una conexión al sistema remoto.

Mostrar el contenido de la unidad WSMan:

Este comando usa el Get-Childitem cmdlet para mostrar los almacenes 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 WS-Management en la ubicación del almacén "SERVER01" del equipo remoto.

Get-ChildItem -path WSMan:\SERVER01

Nota:

En el comando anterior se supone que ya existe una conexión al sistema remoto.

Establecimiento del 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 tipos de elementos diferentes que puede crear. En la WSMAN: unidad, puede crear agentes de escucha que configure para recibir y responder a solicitudes remotas. El comando siguiente 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 entrada de recursos

Este comando crea una entrada de recurso 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 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 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 en todos los adaptadores de red).
  • La 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 Address 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 lo admite.

Estos atributos incluyen SupportsFiltering y SupportsFragment.

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

    Nota:

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

  • Delete: 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 operaciones de Shell.

  • Enumeración: 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 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 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 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 operaciones de Shell.

  • Suscripción: las operaciones de suscripción se admiten en el URI.
    • El atributo SupportFragment no se admite para las operaciones De suscripción 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 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 una operación de Shell está configurada para un URI, las operaciones Get, Put, Create, Delete, Invoke y Enumerate se procesan internamente en el servicio WS-Management (WinRM) para administrar 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 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 admitidos

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 admitidos

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 admitidos

Cadena del emisor <>

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

Cmdlets admitidos

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

que se conecta a y amplía la funcionalidad de WS-Management . La API del complemento WSW-Management proporciona funcionalidad que permite a un 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 WS-Management o en el host de IIS, respectivamente. Las solicitudes remotas se enrutan a estos puntos de entrada del complemento para realizar operaciones.

Cmdlets admitidos

Port <Unsigned Short Integer>

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

Cmdlets admitidos

Cadena de recurso <>

Especifica un punto de conexión que representa un tipo distinto de operación o valor de administración. Un servicio expone uno o varios 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 admitidos

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 admitidos

SDKVersion <String>

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

Cmdlets admitidos

Cadena de asunto <>

Especifica la entidad identificada por el certificado.

Cmdlets admitidos

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 admitidos

Cadena de URI <>

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

Cmdlets admitidos

UrlPrefix <String>

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

Cmdlets admitidos

Cadena de valor <>

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

Cmdlets admitidos

XmlRenderingType String <>

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

  • Texto: los datos XML entrantes se encuentran en una estructura de 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 de 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 admitidos

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