Set-WSManInstance

Sintaxis

ComputerName (valor predeterminado)

Set-WSManInstance
    [-ResourceURI] <Uri>
    [[-SelectorSet] <Hashtable>]
    [-ApplicationName <String>]
    [-ComputerName <String>]
    [-Dialect <Uri>]
    [-FilePath <String>]
    [-Fragment <String>]
    [-OptionSet <Hashtable>]
    [-Port <Int32>]
    [-SessionOption <SessionOption>]
    [-UseSSL]
    [-ValueSet <Hashtable>]
    [-Credential <PSCredential>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <String>]
    [<CommonParameters>]

URI

Set-WSManInstance
    [-ResourceURI] <Uri>
    [[-SelectorSet] <Hashtable>]
    [-ConnectionURI <Uri>]
    [-Dialect <Uri>]
    [-FilePath <String>]
    [-Fragment <String>]
    [-OptionSet <Hashtable>]
    [-SessionOption <SessionOption>]
    [-ValueSet <Hashtable>]
    [-Credential <PSCredential>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <String>]
    [<CommonParameters>]

Description

Ejemplos

Ejemplo 1: Deshabilitar un agente de escucha en el equipo local

Set-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{address="*";transport="https"} -ValueSet @{Enabled="false"}

cfg                   : http://schemas.microsoft.com/wbem/wsman/1/config/listener
xsi                   : http://www.w3.org/2001/XMLSchema-instance
lang                  : en-US
Address               : *
Transport             : HTTPS
Port                  : 443
Hostname              :
Enabled               : false
URLPrefix             : wsman
CertificateThumbprint :
ListeningOn           : {127.0.0.1, 172.30.168.171, ::1, 2001:4898:0:fff:0:5efe:172.30.168.171...}

Ejemplo 2: Establecer el tamaño máximo del sobre en el equipo local

Set-WSManInstance -ResourceURI winrm/config -ValueSet @{MaxEnvelopeSizekb = "200"}

cfg                 : http://schemas.microsoft.com/wbem/wsman/1/config
lang                : en-US
MaxEnvelopeSizekb   : 200
MaxTimeoutms        : 60000
MaxBatchItems       : 32000
MaxProviderRequests : 4294967295
Client              : Client
Service             : Service
Winrs               : Winrs

Ejemplo 3: Deshabilitar un agente de escucha en un equipo remoto

Set-WSManInstance -ResourceURI winrm/config/listener -ComputerName SERVER02 -SelectorSet @{address="*";transport="https"} -ValueSet @{Enabled="false"}

cfg                   : http://schemas.microsoft.com/wbem/wsman/1/config/listener
xsi                   : http://www.w3.org/2001/XMLSchema-instance
lang                  : en-US
Address               : *
Transport             : HTTPS
Port                  : 443
Hostname              :
Enabled               : false
URLPrefix             : wsman
CertificateThumbprint :
ListeningOn           : {127.0.0.1, 172.30.168.172, ::1, 2001:4898:0:fff:0:5efe:172.30.168.172...}

Parámetros

-ApplicationName

Especifica el nombre de la aplicación en la conexión. El valor predeterminado del parámetro ApplicationName es "WSMAN". El identificador completo del punto de conexión remoto tiene el siguiente formato:

<transport>://<server>:<port>/<ApplicationName>

Por ejemplo:

http://server01:8080/WSMAN

Internet Information Services (IIS), que hospeda la sesión, reenvía las solicitudes con este punto de conexión a la aplicación especificada. Esta configuración predeterminada de WSMAN es adecuada para la mayoría de los usos. Este parámetro está diseñado para usarse cuando numerosos equipos establecen conexiones remotas a un equipo que ejecuta Windows PowerShell. En este caso, IIS hospeda servicios web para administración (WS-Management) para mejorar la eficacia.

Propiedades de parámetro

Conjuntos de parámetros

-Authentication

Especifica el mecanismo de autenticación que se va a usar en el servidor. Los valores posibles son:

• Basic: Básico es un esquema en el que el nombre de usuario y la contraseña se envían en texto no cifrado al servidor o proxy.
• Default : use el método de autenticación implementado por el protocolo WS-Management. Este es el valor predeterminado.
• Digest: Digest es un esquema de desafío-respuesta que utiliza una cadena de datos especificada por el servidor para el desafío.
• Kerberos: el equipo cliente y el servidor se autentican mutuamente mediante certificados Kerberos.
• Negotiate: Negotiate es un esquema de desafío-respuesta que negocia con el servidor o proxy para determinar el esquema que se va a usar para la autenticación. Por ejemplo, este valor de parámetro permite a la negociación determinar si se usa el protocolo Kerberos o NTLM.
• CredSSP: use la autenticación del proveedor de soporte técnico de seguridad de credenciales (CredSSP), que permite al usuario delegar credenciales. Esta opción está diseñada para comandos que se ejecutan en un equipo remoto, pero recopilan datos de o ejecutan comandos adicionales en otros equipos remotos.

Propiedades de parámetro

Conjuntos de parámetros

-CertificateThumbprint

Especifica el certificado de clave pública digital (X509) de una cuenta de usuario que tiene permiso para realizar esta acción. Ingrese la huella digital del certificado.

Los certificados se usan en la autenticación basada en certificados de cliente. Solo se pueden asignar a cuentas de usuario locales; no funcionan con cuentas de dominio.

Para obtener una huella digital de certificado, use el comando Get-Item o Get-ChildItem en la unidad de Cert: de PowerShell.

Propiedades de parámetro

Conjuntos de parámetros

-ComputerName

Especifica el equipo en el que desea ejecutar la operación de administración. El valor puede ser un nombre de dominio completo, un nombre NetBIOS o una dirección IP. Use el nombre del equipo local, localhosto un punto (.) para especificar el equipo local. El valor predeterminado es el equipo local.

Cuando el equipo remoto está en un dominio diferente al del usuario, se debe usar un nombre de dominio completamente calificado. Puede canalizar un valor para este parámetro al cmdlet .

Propiedades de parámetro

Conjuntos de parámetros

-ConnectionURI

Especifica el extremo de la conexión. El formato de esta cadena es:

<Transport>://<Server>:<Port>/<ApplicationName>

La cadena siguiente es un valor con formato correcto para este parámetro:

http://Server01:8080/WSMAN

El identificador URI debe ser completo.

Propiedades de parámetro

Conjuntos de parámetros

-Credential

Especifica una cuenta de usuario que tiene permiso para realizar esta acción. El valor predeterminado es el usuario actual. Escriba un nombre de usuario, como User01, Domain01\User01o User@Domain.com. Como alternativa, introduzca un objeto de PSCredential, como uno devuelto por el cmdlet Get-Credential. Al escribir un nombre de usuario, se le pedirá una contraseña.

Propiedades de parámetro

Conjuntos de parámetros

-Dialect

Especifica el dialecto que se va a usar en el predicado de filtro. Puede ser cualquier dialecto compatible con el servicio remoto. Los alias siguientes se pueden usar para el URI del dialecto:

• WQL: http://schemas.microsoft.com/wbem/wsman/1/WQL
• Selector: http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
• Association: http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter

Propiedades de parámetro

Conjuntos de parámetros

-FilePath

Especifica la ruta de acceso de un archivo que se usa para actualizar un recurso de administración. Especifica el recurso de administración mediante el parámetro ResourceURI y el parámetro SelectorSet. Por ejemplo, el comando siguiente usa el parámetro FilePath:

Invoke-WSManAction -Action StopService -ResourceUri wmicimv2/Win32_Service -SelectorSet @{Name="spooler"} -FilePath:c:\input.xml -authentication default

Este comando llama al método StopService en el servicio Spooler utilizando la entrada de un archivo. El archivo, Input.xml, contiene el siguiente contenido:

<p:StopService_INPUT xmlns:p="http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service" />

Propiedades de parámetro

Conjuntos de parámetros

-Fragment

Especifica una sección dentro de la instancia que se va a actualizar o recuperar para la operación especificada. Por ejemplo, para obtener el estado de un servicio de administrador de trabajos en cola, especifique -Fragment Status.

Propiedades de parámetro

Conjuntos de parámetros

-OptionSet

Pasa un conjunto de modificadores a un servicio para modificar o refinar la naturaleza de la solicitud. Son similares a los modificadores usados en los shells de línea de comandos porque son específicos para el servicio. Se puede especificar cualquier número de opciones.

En el ejemplo siguiente se muestra la sintaxis que pasa los valores 1, 2y 3 para los parámetros a, by c:

-OptionSet @{a=1;b=2;c=3}

Propiedades de parámetro

Conjuntos de parámetros

-Port

Especifica el puerto que se va a usar cuando el cliente se conecta al servicio WinRM. Cuando el transporte es HTTP, el puerto predeterminado es 80. Cuando el transporte es HTTPS, el puerto predeterminado es 443.

Cuando se usa HTTPS como transporte, el valor del parámetro ComputerName debe coincidir con el nombre común (CN) del certificado del servidor. Sin embargo, si el parámetro SkipCNCheck se especifica como parte del parámetro SessionOption, el nombre común del certificado del servidor no tiene que coincidir con el nombre de host del servidor. El parámetro SkipCNCheck solo debe usarse para máquinas de confianza.

Propiedades de parámetro

Conjuntos de parámetros

-ResourceURI

Contiene el identificador uniforme de recursos (URI) de la clase o instancia de recursos. El URI se usa para identificar un tipo específico de recurso, como discos o procesos, 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

Propiedades de parámetro

Conjuntos de parámetros

-SelectorSet

Especifica un conjunto de pares de valores que se usan para seleccionar instancias de recursos de administración concretas. El parámetro SelectorSet se usa cuando existe más de una instancia del recurso. El valor del parámetro SelectorSet debe ser una tabla hash. En el ejemplo siguiente se muestra cómo escribir un valor para este parámetro:

-SelectorSet @{Name="WinRM";ID="yyy"}

Propiedades de parámetro

Conjuntos de parámetros

-SessionOption

Define un conjunto de opciones extendidas para la sesión WS-Management. Escriba un objeto SessionOption que cree con el cmdlet New-WSManSessionOption. Para obtener más información acerca de las opciones disponibles, consulte New-WSManSessionOption.

Propiedades de parámetro

Conjuntos de parámetros

-UseSSL

Especifica que debe utilizarse el protocolo de capa de sockets seguros (SSL) para establecer una conexión con equipo remoto. De forma predeterminada, no se usa SSL.

WS-Management cifra todo el contenido de Windows PowerShell que se transmite a través de la red. El parámetro UseSSL permite especificar la protección adicional de HTTPS en lugar de HTTP. Si SSL no está disponible en el puerto que se usa para la conexión y especifica este parámetro, se produce un error en el comando.

Propiedades de parámetro

Conjuntos de parámetros

-ValueSet

Especifica una tabla hash que ayuda a modificar un recurso de administración. Especifica el recurso de administración mediante el parámetro ResourceURI y el parámetro SelectorSet. El valor del parámetro ValueSet debe ser una tabla hash.

Propiedades de parámetro

Conjuntos de parámetros

CommonParameters

Entradas

None

Salidas

XmlElement

Vínculos relacionados

• Connect-WSMan
• Disable-WSManCredSSP
• Disconnect-WSMan
• Enable-WSManCredSSP
• Get-WSManCredSSP
• Get-WSManInstance
• Invoke-WSManAction
• New-WSManInstance
• New-WSManSessionOption
• Remove-WSManInstance
• Set-WSManQuickConfig
• Test-WSMan