Búsqueda de sitios web

Invocar-WSManAction (Microsoft.WSMan.Management)

Invocar-WSManAction

Módulo:
Microsoft.WSMan.Management

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

Sintaxis

Invoke-WSManAction
      [-Action] <String>
      [-ConnectionURI <Uri>]
      [-FilePath <String>]
      [-OptionSet <Hashtable>]
      [[-SelectorSet] <Hashtable>]
      [-SessionOption <SessionOption>]
      [-ValueSet <Hashtable>]
      [-ResourceURI] <Uri>
      [-Credential <PSCredential>]
      [-Authentication <AuthenticationMechanism>]
      [-CertificateThumbprint <String>]
      [<CommonParameters>]
Invoke-WSManAction
      [-Action] <String>
      [-ApplicationName <String>]
      [-ComputerName <String>]
      [-FilePath <String>]
      [-OptionSet <Hashtable>]
      [-Port <Int32>]
      [[-SelectorSet] <Hashtable>]
      [-SessionOption <SessionOption>]
      [-UseSSL]
      [-ValueSet <Hashtable>]
      [-ResourceURI] <Uri>
      [-Credential <PSCredential>]
      [-Authentication <AuthenticationMechanism>]
      [-CertificateThumbprint <String>]
      [<CommonParameters>]

Descripción

Este cmdlet solo está disponible en la plataforma Windows.

Invoke-WSManAction ejecuta una acción en el objeto especificado por RESOURCE_URI, donde los parámetros se especifican mediante pares clave-valor.

Este cmdlet utiliza la capa de conexión/transporte de WSMan para ejecutar la acción.

Ejemplos

Ejemplo 1: invocar un método

Invoke-WSManAction -Action startservice -ResourceURI wmicimv2/win32_service  -SelectorSet @{name="spooler"} -Authentication default

xsi         : http://www.w3.org/2001/XMLSchema-instance
p           : http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service
cim         : http://schemas.dmtf.org/wbem/wscim/1/common
lang        : en-US
ReturnValue : 0

Este comando llama al método StartService de la instancia de clase WMI Win32_Service que corresponde al servicio Spooler.

El valor de retorno indica si la acción fue exitosa. En este caso, un valor de retorno de 0 indica éxito. Un valor de retorno de 5 indica que el servicio ya se inició.

Ejemplo 2: invocar un método

Invoke-WSManAction -Action stopservice -ResourceURI wmicimv2/Win32_Service -SelectorSet @{Name="spooler"} -FilePath:input.xml -Authentication default

xsi         : http://www.w3.org/2001/XMLSchema-instance
p           : http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service
cim         : http://schemas.dmtf.org/wbem/wscim/1/common
lang        : en-US
ReturnValue : 0

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" />

Ejemplo 3: invocar un método con valores de parámetros especificados

Invoke-WSManAction -Action create -ResourceURI wmicimv2/win32_process -ValueSet @{commandline="notepad.exe";currentdirectory="C:\"}

xsi         : http://www.w3.org/2001/XMLSchema-instance
p           : http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Process
cim         : http://schemas.dmtf.org/wbem/wscim/1/common
lang        : en-US
ProcessId   : 6356
ReturnValue : 0

Este comando llama al método Create de la clase Win32_Process. Pasa al método dos valores de parámetros, Notepad.exe y C:\. Como resultado, se crea un nuevo proceso para ejecutar el Bloc de notas y el directorio actual del nuevo proceso se establece en C:\.

Ejemplo 4: invocar un método en una computadora remota

Invoke-WSManAction -Action startservice -ResourceURI wmicimv2/win32_service  -SelectorSet @{name="spooler"} -ComputerName server01 -Authentication default

xsi         : http://www.w3.org/2001/XMLSchema-instance
p           : http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service
cim         : http://schemas.dmtf.org/wbem/wscim/1/common
lang        : en-US
ReturnValue : 0

Este comando llama al método StartService de la instancia de clase WMI Win32_Service que corresponde al servicio Spooler. Debido a que se especifica el parámetro ComputerName, el comando se ejecuta en la computadora remota server01.

El valor de retorno indica si la acción fue exitosa. En este caso, un valor de retorno de 0 indica éxito. Un valor de retorno de 5 indica que el servicio ya se inició.

Parámetros

-Action

Especifica el método que se ejecutará en el objeto de administración especificado por ResourceURI y los selectores.

Tipo :

String

Posición:

1

Valor predeterminado:

None

Requerido:

True

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-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 final remoto tiene el siguiente formato:

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

Por ejemplo:

http://server01:8080/WSMAN

Internet Information Services (IIS), que aloja la sesión, reenvía las solicitudes con este punto final a la aplicación especificada. Esta configuración predeterminada de "WSMAN" es apropiada para la mayoría de los usos. Este parámetro está diseñado para usarse cuando varias computadoras establecen conexiones remotas a una computadora que ejecuta Windows PowerShell. En este caso, IIS aloja Web Services for Management (WS-Management) para mayor eficiencia.

Tipo :

String

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-Authentication

Especifica el mecanismo de autenticación que se utilizará en el servidor. Los valores posibles son:

  • Básico: Básico es un esquema en el que el nombre de usuario y la contraseña se envían en texto claro al servidor o proxy.
  • Predeterminado: utilice el método de autenticación implementado por el protocolo WS-Management. Este es el valor predeterminado.
  • Resumen: el resumen 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: Negociar es un esquema de desafío-respuesta que negocia con el servidor o proxy para determinar el esquema a utilizar para la autenticación. Por ejemplo, este valor de parámetro permite la negociación para determinar si se utiliza el protocolo Kerberos o NTLM.
  • CredSSP: utilice la autenticación del proveedor de soporte de seguridad de credenciales (CredSSP), que permite al usuario delegar credenciales. Esta opción está diseñada para comandos que se ejecutan en una computadora remota pero recopilan datos o ejecutan comandos adicionales en otras computadoras remotas.

Precaución

CredSSP delega las credenciales del usuario de la computadora local a una computadora remota. Esta práctica aumenta el riesgo de seguridad de la operación remota. Si la computadora remota está comprometida, cuando se le pasan las credenciales, las credenciales se pueden usar para controlar la sesión de red.

Tipo :

AuthenticationMechanism

Alias:

auth, am

Valores aceptados:

Ninguno, Predeterminado, Resumen, Negociar, Básico, Kerberos, ClientCertificate, Credssp

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-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 utilizan en la autenticación basada en certificados de cliente. Sólo se pueden asignar a cuentas de usuarios 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 Certificado de Windows PowerShell:.

Tipo :

String

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-ComputerName

Especifica la computadora en la 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. Utilice el nombre de la computadora local, use localhost o use un punto (.) para especificar la computadora local. La computadora local es la predeterminada. Cuando la computadora remota está en un dominio diferente al del usuario, debe usar un nombre de dominio completo. Puede canalizar un valor para este parámetro al cmdlet.

Tipo :

String

Alias:

cn

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-ConnectionURI

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

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

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

http://Server01:8080/WSMAN

El URI debe estar completamente calificado.

Tipo :

uri

Alias:

CURI, CU

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-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 "Usuario01", "Dominio01\Usuario01" o Usuario@Dominio.com. O bien, introduzca un objeto PSCredential, como el que devuelve el cmdlet Get-Credential. Cuando escriba un nombre de usuario, se le solicitará una contraseña.

Tipo :

PSCredencial

Alias:

cred, c

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-FilePath

Especifica la ruta de un archivo que se utiliza para actualizar un recurso de administración. El recurso de administración se especifica mediante el parámetro ResourceURI y el parámetro SelectorSet. Por ejemplo, el siguiente comando utiliza 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" />
Tipo :

String

Alias:

Path

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-OptionSet

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

El siguiente ejemplo demuestra la sintaxis que pasa los valores 1, 2 y 3 para los parámetros a, b y c:

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

tabla hash

Alias:

os

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-Port

Especifica el puerto que se utilizará cuando el cliente se conecte al servicio WinRM. Cuando el transporte es HTTP, el puerto predeterminado es 80. Cuando el transporte es HTTPS, el puerto predeterminado es 443. Cuando utiliza HTTPS como transporte, el valor del parámetro ComputerName debe coincidir con el nombre común del certificado (CN) 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 debe usarse solo para máquinas confiables.

Tipo :

Int32

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-ResourceURI

Contiene el identificador uniforme de recursos (URI) de la clase o instancia de recurso. El URI se utiliza para identificar un tipo específico de recurso, como discos o procesos, en una computadora.

Un URI consta de un prefijo y una ruta 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
Tipo :

uri

Alias:

ruri

Posición:

0

Valor predeterminado:

None

Requerido:

True

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-SelectorSet

Especifica un conjunto de pares de valores que se utilizan para seleccionar instancias de recursos de administración particulares. SelectorSet se utiliza cuando existe más de una instancia del recurso. El valor de SelectorSet debe ser una tabla hash.

El siguiente ejemplo muestra cómo ingresar un valor para este parámetro:

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

tabla hash

Posición:

2

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-SessionOption

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

Tipo :

SessionOption

Alias:

so

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-UseSSL

Especifica que se utiliza el protocolo Secure Sockets Layer (SSL) para establecer una conexión con la computadora remota. De forma predeterminada, no se utiliza SSL.

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

Tipo :

SwitchParameter

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-ValueSet

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

Tipo :

tabla hash

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

Entradas

Ninguno

No puede canalizar objetos a este cmdlet.

Salidas

Elemento Xml

Este cmdlet devuelve el resultado de la operación como un objeto XmlElement.

Artículos relacionados