Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.
Das Cmdlet Invoke-CimMethod ruft eine Methode einer CIM-Klasse oder CIM-Instanz unter Verwendung der durch den Parameter Arguments angegebenen Name-Wert-Paare auf.
Wenn der parameter InputObject nicht angegeben ist, funktioniert das Cmdlet auf eine der folgenden Arten:
Wenn weder der parameter ComputerName noch der CimSession Parameter angegeben ist, funktioniert dieses Cmdlet unter Verwendung einer COM-Sitzung (Component Object Model) für lokale Windows-Verwaltungsinstrumentation (Windows Management Instrumentation, WMI).
Wenn entweder der Parameter ComputerName oder der Parameter CimSession angegeben ist, funktioniert dieses Cmdlet mit dem CIM-Server, der durch entweder den Parameter ComputerName oder CimSession angegeben wird.
Wenn der parameter InputObject angegeben ist, funktioniert das Cmdlet auf eine der folgenden Arten:
Wenn weder der ComputerName Parameter noch der CimSession Parameter angegeben wird, verwendet dieses Cmdlet den CIM-Sitzungs- oder Computernamen aus dem Eingabeobjekt.
Wenn entweder der Parameter ComputerName oder der Parameter CimSession angegeben wird, dann verwendet dieses Cmdlet entweder den Wert des Parameters CimSession oder den Wert des Parameters ComputerName. Dies ist kein häufiges Szenario.
Beispiele
Beispiel 1: Aufrufen einer Methode
Dieses Beispiel ruft die Methode Terminate der Klasse Win32_Process auf.
$method = @{
Query = 'select * from Win32_Process where name like "notepad%"'
MethodName = "Terminate"
}
Invoke-CimMethod @method
Beispiel 2: Aufrufen einer Methode mithilfe des CIM-Instanzobjekts
In diesem Beispiel wird das CIM-Instanzobjekt abgerufen und in einer Variablen namens $x mithilfe des Cmdlets Get-CimInstance gespeichert. Der Inhalt der Variablen wird dann als InputObject für das Cmdlet Invoke-CimMethod genutzt. Die Methode GetOwner wird für die CimInstance aufgerufen.
$x = Get-CimInstance -Query 'Select * from Win32_Process where name like "notepad%"'
Invoke-CimMethod -InputObject $x -MethodName GetOwner
Beispiel 3: Aufrufen einer statischen Methode mithilfe von Argumenten
In diesem Beispiel wird die Create-Methode aufgerufen, die mit dem Parameter Arguments benannt wird.
Gibt die Parameter an, die an die aufgerufene Methode übergeben werden sollen. Geben Sie die Werte für diesen Parameter als Name-Wert-Paare an, die in einer Hashtabelle gespeichert sind. Die Reihenfolge der eingegebenen Werte ist nicht wichtig.
Gibt ein CIM-Klassenobjekt an, das eine CIM-Klassendefinition auf dem Server darstellt. Verwenden Sie diesen Parameter beim Aufrufen einer statischen Methode einer Klasse.
Sie können das Cmdlet Get-CimClass verwenden, um eine Klassendefinition vom Server abzurufen.
Die Verwendung dieses Parameters führt zu besseren clientseitigen Schemaüberprüfungen.
Führt den Befehl mithilfe der angegebenen CIM-Sitzung aus. Geben Sie eine Variable ein, die die CIM-Sitzung enthält, oder einen Befehl, der die CIM-Sitzung erstellt oder abruft, z. B. die New-CimSession- oder Get-CimSession-Cmdlets. Weitere Informationen finden Sie unter about_CimSession.
Gibt den Namen der CIM-Klasse an, für die der Vorgang ausgeführt werden soll. Dieser Parameter wird nur für statische Methoden verwendet. Sie können die Tab-Vervollständigung verwenden, um die Liste der Klassen zu durchsuchen, da PowerShell eine Liste von Klassen vom lokalen WMI-Server abruft, um eine Liste der Klassennamen bereitzustellen.
Gibt den Namen des Computers an, auf dem Der CIM-Vorgang ausgeführt werden soll. Sie können einen vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN), einen NetBIOS-Namen oder eine IP-Adresse angeben.
Bei Verwendung dieses Parameters erstellt das Cmdlet mithilfe des WsMan-Protokolls eine temporäre Sitzung auf dem angegebenen Computer. Andernfalls führt das Cmdlet den Vorgang auf dem lokalen Computer mithilfe des Component Object Model (COM) aus.
Stellen Sie eine Verbindung über eine CIM-Sitzung her, um die Leistung zu verbessern, wenn mehrere Operationen auf demselben Computer ausgeführt werden.
Gibt ein CIM-Instanzobjekt an, das als Eingabe zum Aufrufen einer Methode verwendet werden soll. Dieser Parameter kann nur zum Aufrufen von Instanzmethoden verwendet werden. Um statische Klassenmethoden aufzurufen, verwenden Sie den parameter Class oder den parameter CimClass.
Gibt den Namen der zu aufrufenden CIM-Methode an. Dieser Parameter ist obligatorisch und darf nicht null oder leer sein. Um die statische Methode einer CIM-Klasse aufzurufen, verwenden Sie den ClassName- oder den CimClass-Parameter.
Gibt den Namespace für den CIM-Vorgang an. Der Standardnamespace ist root/CIMV2. Sie können die Registerkartenvervollständigung verwenden, um die Liste der Namespaces zu durchsuchen, da PowerShell eine Liste der Namespaces vom lokalen WMI-Server abruft, um die Liste der Namespaces bereitzustellen.
Gibt die Zeitspanne an, die das Cmdlet auf eine Antwort vom Computer wartet. Standardmäßig ist der Wert 0, was bedeutet, dass das Cmdlet den Standardtimeoutwert für den Server verwendet.
Wenn der OperationTimeoutSec-Parameter auf einen Wert festgelegt ist, der kleiner als das Standardzeitlimit für Verbindungswiederholungsversuche von 3 Minuten ist, können Netzwerkfehler, die länger als der Wert des OperationTimeoutSec-Parameters dauern, nicht wiederhergestellt werden.
Gibt eine Abfrage an, die auf dem CIM-Server ausgeführt werden soll. Für die Instanzen, die Sie als Ergebnis der Abfrage erhalten, wird eine Methode aufgerufen. Sie können den Abfragedialekt mithilfe des QueryDialect--Parameters angeben.
Wenn der angegebene Wert doppelte Anführungszeichen ("), einfache Anführungszeichen (') oder einen umgekehrten Schrägstrich (\) enthält, müssen Sie diese Zeichen durch einen vorangestellten umgekehrten Schrägstrich (\) ersetzen. Wenn der angegebene Wert den WQL LIKE-Operator verwendet, müssen Sie die folgenden Zeichen durch Einschließen in eckige Klammern ([]) vermeiden: Prozent (%), Unterstrich (_) oder öffnende eckige Klammer ([).
Gibt den URI (Uniform Resource Identifier) der Ressourcenklasse oder -instanz an.
Der URI wird verwendet, um einen bestimmten Ressourcentyp zu identifizieren, z. B. Datenträger oder Prozesse, auf einem Computer.
Ein URI besteht aus einem Präfix und einem Pfad zu einer Ressource. Beispiel:
Wenn Sie diesen Parameter nicht angeben, wird standardmäßig der URI der DMTF-Standardressource http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ verwendet, und der Klassenname wird daran angefügt.
ResourceUri- kann nur mit CIM-Sitzungen verwendet werden, die mit dem WSMan-Protokoll erstellt wurden, oder wenn sie den ComputerName Parameter angeben, der eine CIM-Sitzung mit WSMan erstellt.
Wenn Sie diesen Parameter angeben, ohne den ComputerName Parameter anzugeben, oder wenn Sie eine MIT DCOM-Protokoll erstellte CIM-Sitzung angeben, wird ein Fehler angezeigt. Das DCOM-Protokoll unterstützt den parameter ResourceUri nicht.
Wenn sowohl der Parameter ResourceUri als auch der Parameter Filter angegeben werden, wird der Parameter Filter ignoriert.
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Die Quelle für diesen Inhalt finden Sie auf GitHub, wo Sie auch Issues und Pull Requests erstellen und überprüfen können. Weitere Informationen finden Sie in unserem Leitfaden für Mitwirkende.
