Invoke-WmiMethod

Especifica los parámetros que se van a pasar al método invocado. El valor de este parámetro debe ser una matriz de objetos y estos deben aparecer en el orden requerido por el método invocado.

Importante: se requiere un segundo valor de $null; de lo contrario, el comando generará un mensaje de error similar a "No se puede convertir de tipo 'System.Byte' a tipo 'System.Array'.".

A continuación se muestra un ejemplo en el que se utiliza una matriz de objetos ($binSD) seguida de un valor NULL ($null):

PS C:\> $acl = Get-Acl test.txt

PS C:\> $binSD = $acl.GetSecurityDescriptorBinaryForm()

PS C:\> invoke-wmimethod -class Win32_SecurityDescriptorHelper -Name BinarySDToSDDL -argumentlist $binSD, $null

Ejecuta el comando como un trabajo en segundo plano. Use este parámetro para ejecutar comandos que tardan mucho tiempo en completarse.

Cuando se utiliza el parámetro AsJob, el comando devuelve un objeto que representa el trabajo en segundo plano y, a continuación, muestra el símbolo del sistema. Puede seguir trabajando en la sesión mientras se completa el trabajo. Si se utiliza Invoke-WmiMethod en un equipo remoto, el trabajo se crea en el equipo local y los resultados de los equipos remotos se devuelven automáticamente al equipo local. Para administrar el trabajo, utilice los cmdlets que contienen el sustantivo Job (cmdlets Job). Para obtener los resultados del trabajo, use el cmdlet Receive-Job.

Nota: para utilizar este parámetro en equipos remotos, los equipos locales y remotos deben estar configurados para la comunicación remota. Además, debe iniciar Windows PowerShell con la opción "Ejecutar como administrador" en Windows Vista y versiones posteriores de Windows. Para obtener más información, vea about_Remote_Requirements.

Para obtener más información sobre los trabajos en segundo plano en Windows PowerShell, vea about_Jobs y about_Remote_Jobs.

Especifica el nivel de autenticación que se va a utilizar con la conexión de WMI. Los valores válidos son:

-1: Unchanged

0: Default

1: None (no se realiza ninguna autenticación).

2: Connect (la autenticación se realiza solo cuando el cliente establece una relación con la aplicación).

3: Call (la autenticación se realiza solo al comienzo de cada llamada cuando la aplicación recibe la solicitud).

4: Packet (se autentican todos los datos que se reciben del cliente).

5: PacketIntegrity (se autentican y se comprueban todos los datos que se transfieren entre el cliente y la aplicación).

6: PacketPrivacy (se utilizan las propiedades de los demás niveles de autenticación y se cifran todos los datos).

Especifica la autoridad que se va a utilizar para autenticar la conexión de WMI. Puede especificar la autenticación estándar NTLM o Kerberos. Para utilizar NTLM, establezca el valor de autoridad en ntlmdomain:<nombreDeDominio>, donde <nombreDeDominio> identifica un nombre de dominio NTLM válido. Para utilizar Kerberos, especifique kerberos:<nombreDeDominio\nombreDeServidor>. No puede incluir el valor de autoridad cuando se conecta al equipo local.

Especifica la clase de WMI que contiene un método estático al que llamar.

Especifica el equipo en el que se desea ejecutar la operación de administración. El valor puede ser un nombre de dominio completo, un nombre NetBIOS o una dirección del protocolo Internet (IP). Use el nombre del equipo local, localhost, o bien, un punto (.) para especificar el equipo local. El equipo local es el valor predeterminado. Cuando el equipo remoto está en un dominio que no es el del usuario, se requiere un nombre de dominio completo. También se puede establecer el valor de este parámetro canalizando el valor al parámetro.

Especifica una cuenta de usuario con permiso para realizar esta acción. El valor predeterminado es el usuario actual. Escriba un nombre de usuario, como "Usuario01", "Dominio01\Usuario01" o Usuario@Contoso.com. O bien, escriba un objeto PSCredential, como el objeto devuelto por el cmdlet Get-Credential. Cuando escriba un nombre de usuario, se le solicitará una contraseña.

Habilita todos los privilegios del usuario actual antes de que el comando realice la llamada a WMI.

Especifica el nivel de suplantación que se va a usar. Los valores válidos son:

0: Default (lee el Registro local para determinar el nivel de suplantación predeterminado, que suele estar establecido en "3: Impersonate").

1: Anonymous (oculta las credenciales del autor de la llamada).

2: Identify (permite que los objetos consulten las credenciales del autor de la llamada).

3: Impersonate (permite a los objetos utilizar las credenciales del autor de la llamada).

4: Delegate (permite que los objetos dejen que otros objetos usen las credenciales del autor de la llamada).

Especifica un objeto ManagementObject que se va a usar como entrada. Cuando se utiliza este parámetro, todos los demás parámetros, excepto los parámetros Flag y Argument, se omiten.

Especifica la configuración regional preferida para los objetos de WMI. Especifica el valor del parámetro Locale como una matriz en el formato MS_<LCID> en el orden preferido.

Especifica el nombre del método que se va a invocar. Este parámetro es obligatorio y no puede ser NULL ni estar vacío.

Si se usa con el parámetro Class, este parámetro especifica el espacio de nombres del repositorio de WMI en el que se encuentra el objeto o la clase de WMI a que se hace referencia.

Especifica la ruta de acceso al objeto de WMI de una clase de WMI, o bien, la ruta de acceso al objeto de WMI de una instancia de una clase de WMI. La clase o la instancia que especifique debe contener el método que se especifica en el parámetro Name.

Permite al usuario especificar un valor de límite para el número de operaciones de WMI que se pueden ejecutar de manera simultánea. Este parámetro se utiliza con el parámetro AsJob. Este límite se aplica únicamente al comando actual; no se aplica a la sesión ni al equipo.

Solicita confirmación antes de ejecutar el comando.

Describe lo que ocurriría si ejecutara el comando sin ejecutarlo realmente.

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.