Invoke-WmiMethod

Syntax

class (Standard)

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>]

Beschreibung

Beispiele

Beispiel 1: Auflisten der erforderlichen Reihenfolge von WMI-Objekten

PS C:\> ([wmiclass]'Win32_Volume').GetMethodParameters('Format')
__GENUS           : 2
__CLASS           : __PARAMETERS
__SUPERCLASS      :
__DYNASTY         : __PARAMETERS
__RELPATH         :
__PROPERTY_COUNT  : 6
__DERIVATION      : {}
__SERVER          :
__NAMESPACE       :
__PATH            :
ClusterSize       : 0
EnableCompression : False
FileSystem        : NTFS
Label             :
QuickFormat       : False
Version           : 0
PSComputerName    :

Beispiel 2: Starten einer Instanz einer Anwendung

PS C:\> ([Wmiclass]'Win32_Process').GetMethodParameters('Create')
__GENUS                   : 2
__CLASS                   : __PARAMETERS
__SUPERCLASS              :
__DYNASTY                 : __PARAMETERS
__RELPATH                 :
__PROPERTY_COUNT          : 3
__DERIVATION              : {}
__SERVER                  :
__NAMESPACE               :
__PATH                    :
CommandLine               :
CurrentDirectory          :
ProcessStartupInformation :
PSComputerName            : PS C:\> Invoke-WmiMethod -Path win32_process -Name create -ArgumentList notepad.exe
__GENUS          : 2
__CLASS          : __PARAMETERS
__SUPERCLASS     :
__DYNASTY        : __PARAMETERS
__RELPATH        :
__PROPERTY_COUNT : 2
__DERIVATION     : {}
__SERVER         :
__NAMESPACE      :
__PATH           :
ProcessId        : 11312
ReturnValue      : 0
PSComputerName   :

Beispiel 3: Umbenennen einer Datei

PS C:\> Invoke-WmiMethod -Path "CIM_DataFile.Name='C:\scripts\test.txt'" -Name Rename -ArgumentList "C:\scripts\test_bu.txt"
__GENUS          : 2
__CLASS          : __PARAMETERS
__SUPERCLASS     :
__DYNASTY        : __PARAMETERS
__RELPATH        :
__PROPERTY_COUNT : 1
__DERIVATION     : {}
__SERVER         :
__NAMESPACE      :
__PATH           :
ReturnValue      : 0

Parameter

-ArgumentList

Gibt die Parameter an, die an die aufgerufene Methode übergeben werden sollen. Der Wert dieses Parameters muss ein Array von Objekten sein, und sie müssen in der Reihenfolge angezeigt werden, die von der aufgerufenen Methode benötigt wird. Für das Cmdlet Invoke-CimCommand gelten diese Einschränkungen nicht.

Um die Reihenfolge zu bestimmen, in der diese Objekte aufgelistet werden sollen, führen Sie die GetMethodParameters()-Methode für die WMI-Klasse aus, wie in Beispiel 1 am Ende dieses Themas dargestellt.

Wichtig: Wenn es sich bei dem ersten Wert um ein Array handelt, das mehr als ein Element enthält, ist der zweite Wert $null erforderlich. Andernfalls generiert der Befehl einen Fehler, z. B. "Objekt des Typs 'System.Byte' kann nicht in den Typ 'System.Array' umgewandelt werden.".

Es folgt ein Beispiel mit einem Array von Objekten ($binSD), gefolgt von einem NULL-Wert ($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

Parametereigenschaften

Parametersätze

-AsJob

Gibt an, dass dieses Cmdlet den Befehl als Hintergrundauftrag ausführt. Verwenden Sie diesen Parameter, um Befehle auszuführen, die lange dauern.

Wenn Sie den parameter AsJob verwenden, gibt der Befehl ein Objekt zurück, das den Hintergrundauftrag darstellt, und zeigt dann die Eingabeaufforderung an. Sie können weiterhin in der Sitzung arbeiten, während der Auftrag abgeschlossen ist. Wenn Invoke-WmiMethod für einen Remotecomputer verwendet wird, wird der Auftrag auf dem lokalen Computer erstellt, und die Ergebnisse von Remotecomputern werden automatisch an den lokalen Computer zurückgegeben. Verwenden Sie zum Verwalten des Auftrags die Cmdlets, die das Substantiv Job enthalten (die Job-Cmdlets). Verwenden Sie zum Abrufen der Auftragsergebnisse das Cmdlet Receive-Job.

Um diesen Parameter mit Remotecomputern zu verwenden, müssen die lokalen und Remotecomputer für remoting konfiguriert werden. Darüber hinaus müssen Sie Windows PowerShell mit der Option Als Administrator ausführen in Windows Vista und höheren Versionen von Windows starten. Weitere Informationen finden Sie unter about_Remote_Requirements.

Weitere Informationen zu Windows PowerShell-Hintergrundaufträgen finden Sie unter about_Jobs und about_Remote_Jobs.

Parametereigenschaften

Parametersätze

-Authentication

Gibt die Authentifizierungsebene an, die mit der WMI-Verbindung verwendet werden soll. Die zulässigen Werte für diesen Parameter sind:

-1: Unverändert

0: Verzug

1: Keine (Es wurde keine Authentifizierung durchgeführt.)

2: Verbinden (Die Authentifizierung wird nur durchgeführt, wenn der Client eine Beziehung mit der Anwendung aufbaut.)

3: Aufruf (Die Authentifizierung wird nur zu Beginn eines jeden Aufrufs durchgeführt, wenn die Anwendung die Anforderung erhält.)

4: Paket (Die Authentifizierung wird für alle Daten durchgeführt, die vom Client empfangen werden.)

5: PacketIntegrity (Alle Daten, die zwischen dem Client und der Anwendung übertragen werden, werden authentifiziert und verifiziert.)

6: PacketPrivacy (Die Eigenschaften der anderen Authentifizierungsebenen werden verwendet, und alle Daten werden verschlüsselt.)

Parametereigenschaften

Parametersätze

-Authority

Gibt die Autorität an, die zum Authentifizieren der WMI-Verbindung verwendet werden soll. Sie können die Standardmäßige Windows NT LAN Manager (NTLM) oder Kerberos-Authentifizierung angeben. Um NTLM zu verwenden, legen Sie die Autoritätseinstellung auf ntlmdomain fest:<DomainName>, wobei <DomainName-> einen gültigen NTLM-Domänennamen identifiziert. Um Kerberos zu verwenden, geben Sie kerberos:<DomainName\ServerName> an. Sie können die Autoritätseinstellung nicht einschließen, wenn Sie eine Verbindung mit dem lokalen Computer herstellen.

Parametereigenschaften

Parametersätze

-Class

Gibt die WMI-Klasse an, die eine statische Methode zum Aufrufen enthält.

Parametereigenschaften

Parametersätze

-ComputerName

Gibt als Zeichenfolgenarray die Computer an, auf denen dieses Cmdlet den Befehl ausführt. Der Standardwert ist der lokale Computer.

Geben Sie den NetBIOS-Namen, eine IP-Adresse oder einen vollqualifizierten Domänennamen eines oder mehrerer Computer ein. Um den lokalen Computer anzugeben, geben Sie den Computernamen, einen Punkt (.) oder localhost ein.

Dieser Parameter basiert nicht auf Windows PowerShell-Remoting. Sie können den parameter ComputerName verwenden, auch wenn Ihr Computer nicht für die Ausführung von Remotebefehlen konfiguriert ist.

Parametereigenschaften

Parametersätze

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Parametersätze

-Credential

Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Die Standardeinstellung ist der aktuelle Benutzer. Geben Sie einen Benutzernamen ein, z. B. "User01", "Domäne01\Benutzer01" oder "User@Contoso.com". Oder geben Sie ein PSCredential-Objekt ein, z. B. ein Objekt, das vom Cmdlet Get-Credential zurückgegeben wird. Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert.

Parametereigenschaften

Parametersätze

-EnableAllPrivileges

Gibt an, dass dieses Cmdlet alle Berechtigungen des aktuellen Benutzers aktiviert, bevor der Befehl den WMI-Aufruf vorgibt.

Parametereigenschaften

Parametersätze

-Impersonation

Gibt die zu verwendende Identitätswechselebene an. Die zulässigen Werte für diesen Parameter sind:

0: Standard (Liest die lokale Registrierung für die Standardidentitätswechselebene, die in der Regel auf "3: Identitätswechsel" festgelegt ist.)

1: Anonym (Blendet die Anmeldeinformationen des Anrufers aus.)

2: Identifizieren (Ermöglicht Objekten, die Anmeldeinformationen des Aufrufers abzufragen.)

3: Identitätswechsel annehmen (Ermöglicht Objekten, die Anmeldeinformationen des Aufrufers zu verwenden.)

4: Delegieren (Ermöglicht Objekten, anderen Objekten die Verwendung der Anmeldeinformationen des Aufrufers zu gestatten.)

Parametereigenschaften

Parametersätze

-InputObject

Gibt ein ManagementObject--Objekt an, das als Eingabe verwendet werden soll. Wenn dieser Parameter verwendet wird, werden alle anderen Parameter außer dem Flag und Argument Parameter ignoriert.

Parametereigenschaften

Parametersätze

-Locale

Gibt das bevorzugte Gebietsschema für WMI-Objekte an. Geben Sie den Wert des Parameters Gebietsschema als Array im MS_LCID-Format<> in der bevorzugten Reihenfolge an.

Parametereigenschaften

Parametersätze

-Name

Gibt den Namen der methode an, die aufgerufen werden soll. Dieser Parameter ist obligatorisch und darf nicht null oder leer sein.

Parametereigenschaften

Parametersätze

-Namespace

Wenn dieser Parameter mit dem parameter Class verwendet wird, gibt dieser Parameter den WMI-Repositorynamespace an, in dem sich die referenzierte WMI-Klasse oder das Objekt befindet.

Parametereigenschaften

Parametersätze

-Path

Gibt den WMI-Objektpfad einer WMI-Klasse an oder gibt den WMI-Objektpfad einer Instanz einer WMI-Klasse an. Die angegebene Klasse oder Instanz muss die im parameter Name angegebene Methode enthalten.

Parametereigenschaften

Parametersätze

-ThrottleLimit

Gibt einen Drosselungswert für die Anzahl der WMI-Vorgänge an, die gleichzeitig ausgeführt werden können. Dieser Parameter wird zusammen mit dem parameter AsJob verwendet. Der Drosselungsgrenzwert gilt nur für den aktuellen Befehl, nicht für die Sitzung oder den Computer.

Parametereigenschaften

Parametersätze

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Parametersätze

CommonParameters

Eingaben

None

Ausgaben

None

Ähnliche Themen

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