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 Windows In Configuration Manager bereitgestellten Methoden der Verwaltungsinstrumentation (Management Instrumentation, WMI) auf.
Hinweis
Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. 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 Begrenzungen hinzuzufügen.
Der Befehl ruft das Begrenzungsgruppenobjekt Boundary1 ab und verwendet den Pipelineoperator, um das Objekt an Invoke-CMWmiMethodzu ü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.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Gibt ein Verwaltungsobjekt oder ein Configuration Management-Objekt an.
| Type: | IResultObject |
| Aliases: | Instance |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MethodName
Gibt den Namen der aufzurufenden Methode an. Dieser Parameter ist obligatorisch und darf nicht null oder leer sein.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Parameter
Gibt den Namen der Eigenschaft und den Wert für die Methode an. Name und Wert müssen in einem Namen-Wert-Paar sein. Das Name-Wert-Paar wird in der Befehlszeile als Hashtabelle übergeben.
| Type: | Hashtable |
| Aliases: | Parameters |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
System.Object