Invoke-WmiMethod

Syntaxe

class (Par défaut)

Invoke-WmiMethod
    [-Class] <String>
    [-Name] <String>
    [-ArgumentList <Object[]>]
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

object

Invoke-WmiMethod
    [-Name] <String>
    -InputObject <ManagementObject>
    [-ArgumentList <Object[]>]
    [-AsJob]
    [-ThrottleLimit <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

path

Invoke-WmiMethod
    [-Name] <String>
    -Path <String>
    [-ArgumentList <Object[]>]
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

WQLQuery

Invoke-WmiMethod
    [-Name] <String>
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

query

Invoke-WmiMethod
    [-Name] <String>
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

list

Invoke-WmiMethod
    [-Name] <String>
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Exemples

Exemple 1 : Répertorier l’ordre requis des paramètres de méthode WMI

Get-WmiObject Win32_Volume |
    Get-Member -MemberType Method -Name Format |
    Select-Object -ExpandProperty Definition

System.Management.ManagementBaseObject Format(System.String FileSystem, System.Boolean QuickFormat,
 System.UInt32 ClusterSize, System.String Label, System.Boolean EnableCompression,
 System.UInt32 Version)

Exemple 2 : Démarrer une instance d’une application

([wmiclass]'Win32_Process').Create.OverloadDefinitions

System.Management.ManagementBaseObject Create(System.String CommandLine, System.String CurrentDirectory,
 System.Management.ManagementObject#Win32_ProcessStartup ProcessStartupInformation)

Invoke-WmiMethod -Path Win32_Process -Name Create -ArgumentList C:\Windows\system32\notepad.exe

__GENUS          : 2
__CLASS          : __PARAMETERS
__SUPERCLASS     :
__DYNASTY        : __PARAMETERS
__RELPATH        :
__PROPERTY_COUNT : 2
__DERIVATION     : {}
__SERVER         :
__NAMESPACE      :
__PATH           :
ProcessId        : 11312
ReturnValue      : 0
PSComputerName   :

Exemple 3 : Renommer un fichier

$invokeWmiMethodSplat = @{
    Path = "CIM_DataFile.Name='C:\scripts\test.txt'"
    Name = 'Rename'
    ArgumentList = 'C:\scripts\test_bu.txt'
}
Invoke-WmiMethod @invokeWmiMethodSplat

__GENUS          : 2
__CLASS          : __PARAMETERS
__SUPERCLASS     :
__DYNASTY        : __PARAMETERS
__RELPATH        :
__PROPERTY_COUNT : 1
__DERIVATION     : {}
__SERVER         :
__NAMESPACE      :
__PATH           :
ReturnValue      : 0

Exemple 4 : Passage d’un tableau de valeurs à l’aide de « -ArgumentList »

$acl = Get-Acl test.txt
$binSD = $acl.GetSecurityDescriptorBinaryForm()
$invokeWmiMethodSplat = @{
    Class = 'Win32_SecurityDescriptorHelper'
    Name = 'BinarySDToSDDL'
    ArgumentList = $binSD, $null
}
Invoke-WmiMethod @invokeWmiMethodSplat

Paramètres

-ArgumentList

Spécifie les paramètres à passer à la méthode appelée. La valeur de ce paramètre doit être un tableau d’objets, et elles doivent apparaître dans l’ordre requis par la méthode appelée. L’applet de commande Invoke-CimCommand n’a pas ces limitations.

Pour déterminer l’ordre dans lequel répertorier ces objets, exécutez la méthode GetMethodParameters() sur la classe WMI, comme illustré dans l’exemple 1, à la fin de cette rubrique.

Propriétés du paramètre

Jeux de paramètres

-AsJob

Indique que cette applet de commande exécute la commande en tant que travail en arrière-plan. Utilisez ce paramètre pour exécuter des commandes qui prennent beaucoup de temps.

Lorsque vous utilisez le paramètre AsJob, la commande retourne un objet qui représente le travail en arrière-plan, puis affiche l’invite de commandes. Vous pouvez continuer à travailler dans la session pendant la fin du travail. Si Invoke-WmiMethod est utilisé sur un ordinateur distant, le travail est créé sur l’ordinateur local et les résultats des ordinateurs distants sont automatiquement retournés à l’ordinateur local. Pour gérer le travail, utilisez les applets de commande qui contiennent le nom Job (applets de commande job). Pour obtenir les résultats du travail, utilisez l’applet de commande Receive-Job.

Pour utiliser ce paramètre avec des ordinateurs distants, les ordinateurs locaux et distants doivent être configurés pour la communication à distance. En outre, vous devez démarrer Windows PowerShell à l’aide de l’option Exécuter en tant qu’administrateur dans Windows Vista et versions ultérieures de Windows. Pour plus d'informations, voir about_Remote_Requirements.

Pour plus d’informations sur les travaux en arrière-plan Windows PowerShell, consultez about_Jobs et about_Remote_Jobs.

Propriétés du paramètre

Jeux de paramètres

-Authentication

Spécifie le niveau d’authentification à utiliser avec la connexion WMI. Les valeurs acceptables pour ce paramètre sont les suivantes :

• -1: inchangé
• 0: par défaut
• 1: Aucun (aucune authentification n’est effectuée.)
• 2: Connect (l’authentification est effectuée uniquement lorsque le client établit une relation avec l’application.)
• 3: d’appel (l’authentification est effectuée uniquement au début de chaque appel lorsque l’application reçoit la requête.)
• 4: paquets (l’authentification est effectuée sur toutes les données reçues du client.)
• 5: PacketIntegrity (toutes les données transférées entre le client et l’application sont authentifiées et vérifiées.)
• 6: PacketPrivacy (les propriétés des autres niveaux d’authentification sont utilisées et toutes les données sont chiffrées.)

Propriétés du paramètre

Jeux de paramètres

-Authority

Spécifie l’autorité à utiliser pour authentifier la connexion WMI. Vous pouvez spécifier l’authentification Standard windows NT LAN Manager (NTLM) ou Kerberos. Pour utiliser NTLM, définissez le paramètre d’autorité sur ntlmdomain:<DomainName>, où <DomainName> identifie un nom de domaine NTLM valide. Pour utiliser Kerberos, spécifiez kerberos:<DomainName>\<ServerName>. Vous ne pouvez pas inclure le paramètre d’autorité lorsque vous vous connectez à l’ordinateur local.

Propriétés du paramètre

Jeux de paramètres

-Class

Spécifie la classe WMI qui contient une méthode statique à appeler.

Propriétés du paramètre

Jeux de paramètres

-ComputerName

Spécifie, sous la forme d’un tableau de chaînes, les ordinateurs sur utilisant cette applet de commande. La valeur par défaut est l’ordinateur local.

Tapez le nom NetBIOS, une adresse IP ou un nom de domaine complet d’un ou plusieurs ordinateurs. Pour spécifier l’ordinateur local, tapez le nom de l’ordinateur, un point (.) ou localhost.

Ce paramètre ne s’appuie pas sur la communication à distance Windows PowerShell. Vous pouvez utiliser le paramètre ComputerName même si votre ordinateur n’est pas configuré pour exécuter des commandes distantes.

Propriétés du paramètre

Jeux de paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Jeux de paramètres

-Credential

Spécifie un compte d’utilisateur autorisé à effectuer cette action. La valeur par défaut est l’utilisateur actuel. Tapez un nom d’utilisateur, tel que User01, Domain01\User01ou User@Contoso.com. Vous pouvez également entrer un objet PSCredential, tel qu’un objet retourné par l’applet de commande Get-Credential. Lorsque vous tapez un nom d’utilisateur, vous serez invité à entrer un mot de passe.

Propriétés du paramètre

Jeux de paramètres

-EnableAllPrivileges

Indique que cette applet de commande active tous les privilèges de l’utilisateur actuel avant que la commande effectue l’appel WMI.

Propriétés du paramètre

Jeux de paramètres

-Impersonation

Spécifie le niveau d’emprunt d’identité à utiliser. Les valeurs acceptables pour ce paramètre sont les suivantes :

• 0: par défaut (lit le registre local pour le niveau d’emprunt d’identité par défaut, généralement défini sur 3: emprunt d’identité.)
• 1: anonyme (masque les informations d’identification de l’appelant.)
• 2: Identifier (permet aux objets d’interroger les informations d’identification de l’appelant.)
• 3: emprunt d’identité (permet aux objets d’utiliser les informations d’identification de l’appelant.)
• 4: délégué (permet aux objets d’autoriser d’autres objets à utiliser les informations d’identification de l’appelant.)

Propriétés du paramètre

Jeux de paramètres

-InputObject

Spécifie un objet ManagementObject à utiliser comme entrée. Lorsque ce paramètre est utilisé, tous les autres paramètres, à l’exception de l’indicateur et paramètres d’argument sont ignorés.

Propriétés du paramètre

Jeux de paramètres

-Locale

Spécifie les paramètres régionaux préférés pour les objets WMI. Spécifiez la valeur du paramètre locale en tant que tableau au format MS_<LCID> dans l’ordre préféré.

Propriétés du paramètre

Jeux de paramètres

-Name

Spécifie le nom de la méthode à appeler. Ce paramètre est obligatoire et ne peut pas être null ou vide.

Propriétés du paramètre

Jeux de paramètres

-Namespace

Lorsqu’il est utilisé avec le paramètre de classe , ce paramètre spécifie l’espace de noms du référentiel WMI où se trouve la classe ou l’objet WMI référencé.

Propriétés du paramètre

Jeux de paramètres

-Path

Spécifie le chemin d’accès de l’objet WMI d’une classe WMI ou spécifie le chemin d’accès de l’objet WMI d’une instance d’une classe WMI. La classe ou l’instance que vous spécifiez doivent contenir la méthode spécifiée dans le paramètre Name.

Propriétés du paramètre

Jeux de paramètres

-ThrottleLimit

Spécifie une valeur de limitation pour le nombre d’opérations WMI qui peuvent être exécutées simultanément. Ce paramètre est utilisé avec le paramètre AsJob. La limite de limitation s’applique uniquement à la commande actuelle, et non à la session ou à l’ordinateur.

Propriétés du paramètre

Jeux de paramètres

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Jeux de paramètres

CommonParameters

Entrées

None

Sorties

None

Notes

Liens associés

• Get-WSManInstance
• Invoke-WSManAction
• New-WSManInstance
• Remove-WSManInstance
• Get-WmiObject
• Remove-WmiObject
• Set-WmiInstance