Invoke-CMWmiMethod
Ruft eine WMI-Methode auf.
Syntax
Invoke-CMWmiMethod
[-ClassName] <String>
-MethodName <String>
[-Parameter <Hashtable>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Invoke-CMWmiMethod
[-InputObject] <IResultObject>
-MethodName <String>
[-Parameter <Hashtable>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Beschreibung
Das Cmdlet Invoke-CMWmiMethod ruft WMI-Methoden (Windows Management Instrumentation) auf, die in Configuration Manager bereitgestellt werden.
Hinweis
Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.
Beispiele
Beispiel 1: Aufrufen einer WMI-Methode mithilfe der Pipeline
PS XYZ:\> Get-CMBoundaryGroup -Name "Boundary1" | Invoke-CMWmiMethod -MethodName "AddBoundary" -Parameter @{BoundaryId = 16777217,16777218}Dieser Befehl verwendet eine WMI-Methode, um einer Begrenzungsgruppe ein Array von Grenzen hinzuzufügen.
Der Befehl ruft das Begrenzungsgruppenobjekt mit dem Namen Boundary1 ab und verwendet den Pipelineoperator, um das Objekt an Invoke-CMWmiMethod zu übergeben. Invoke-CMWmiMethod ruft die WMI-Methode AddBoundary auf, die die durch ihre IDs angegebenen Grenzen zur Begrenzungsgruppe Boundary1 hinzufügt.
Parameter
-ClassName
Gibt den Namen der WMI-Klasse an, die die statische Methode enthält, die Sie aufrufen möchten.
| Typ: | String |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-InputObject
Gibt ein Verwaltungsobjekt oder ein Konfigurationsverwaltungsobjekt an.
| Typ: | IResultObject |
| Aliase: | Instance |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-MethodName
Gibt den Namen der methode an, die aufgerufen werden soll. Dieser Parameter ist obligatorisch und darf nicht NULL oder leer sein.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Parameter
Gibt den Namen der Eigenschaft und den Wert für die Methode an. Name und Wert müssen in einem Name/Wert-Paar enthalten sein. Das Name-Wert-Paar wird in der Befehlszeile als Hashtabelle übergeben.
| Typ: | Hashtable |
| Aliase: | Parameters |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
System.Object