Invoke-CimMethod

Modul:

CimCmdlets Module

EGY CIM-osztály metódusát hívja meg.

Syntax

ClassNameComputerSet (Alapértelmezett)

Invoke-CimMethod
    [-ClassName] <String>
    [[-Arguments] <IDictionary>]
    [-MethodName] <String>
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ClassNameSessionSet

Invoke-CimMethod
    [-ClassName] <String>
    [[-Arguments] <IDictionary>]
    [-MethodName] <String>
    -CimSession <CimSession[]>
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceUriComputerSet

Invoke-CimMethod
    [[-Arguments] <IDictionary>]
    [-MethodName] <String>
    -ResourceUri <Uri>
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CimInstanceSessionSet

Invoke-CimMethod
    [-InputObject] <CimInstance>
    [[-Arguments] <IDictionary>]
    [-MethodName] <String>
    -CimSession <CimSession[]>
    [-ResourceUri <Uri>]
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CimInstanceComputerSet

Invoke-CimMethod
    [-InputObject] <CimInstance>
    [[-Arguments] <IDictionary>]
    [-MethodName] <String>
    [-ResourceUri <Uri>]
    [-ComputerName <String[]>]
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceUriSessionSet

Invoke-CimMethod
    [[-Arguments] <IDictionary>]
    [-MethodName] <String>
    -ResourceUri <Uri>
    -CimSession <CimSession[]>
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CimClassComputerSet

Invoke-CimMethod
    [-CimClass] <CimClass>
    [[-Arguments] <IDictionary>]
    [-MethodName] <String>
    [-ComputerName <String[]>]
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CimClassSessionSet

Invoke-CimMethod
    [-CimClass] <CimClass>
    [[-Arguments] <IDictionary>]
    [-MethodName] <String>
    -CimSession <CimSession[]>
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

QueryComputerSet

Invoke-CimMethod
    [[-Arguments] <IDictionary>]
    [-MethodName] <String>
    -Query <String>
    [-QueryDialect <String>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

QuerySessionSet

Invoke-CimMethod
    [[-Arguments] <IDictionary>]
    [-MethodName] <String>
    -Query <String>
    -CimSession <CimSession[]>
    [-QueryDialect <String>]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Ez a parancsmag csak a Windows platformon érhető el.

A Invoke-CimMethod parancsmag egy CIM-osztály vagy CIM-példány metódusát hívja meg a Argumentumok paraméter által megadott név-érték párok használatával.

Ha a InputObject paraméter nincs megadva, a parancsmag a következő módok egyikével működik:

• Ha sem a ComputerName paraméter, sem a CimSession paraméter nincs megadva, akkor ez a parancsmag a helyi Windows Management Instrumentation (WMI) rendszeren működik egy komponensobjektum-modell (COM) munkamenettel.
• Ha a ComputerName paraméter vagy a CimSession paraméter van megadva, akkor ez a parancsmag a ComputerName paraméter vagy a CimSession paraméter által megadott CIM-kiszolgálóval működik.

Ha a InputObject paraméter van megadva, a parancsmag az alábbi módok egyikével működik:

• Ha sem a ComputerName paraméter, sem a CimSession paraméter nincs megadva, akkor ez a parancsmag a bemeneti objektum CIM-munkamenetét vagy számítógépnevét használja.
• Ha a ComputerName paraméter vagy a CimSession paraméter van megadva, akkor ez a parancsmag a CimSession paraméterértéket vagy ComputerName paraméterértéket használja. Ez nem gyakori forgatókönyv.

Példák

1. példa: Metódus meghívása

Ez a példa meghívja a Win32_Process osztály Megszakítás metódusát.

Invoke-CimMethod -Query 'select * from Win32_Process where name like "notepad%"' -MethodName "Terminate"

2. példa: Metódus meghívása CIM-példányobjektum használatával

Ez a példa lekéri a CIM-példány objektumot, és egy $x nevű változóban tárolja a Get-CimInstance parancsmag használatával. Ezután a parancsmag Invoke-CimMethod a változó tartalmát használja. A GetOwner metódus meghívása a CimInstance.

$x = Get-CimInstance -Query 'Select * from Win32_Process where name like "notepad%"'
Invoke-CimMethod -InputObject $x -MethodName GetOwner

3. példa: Statikus metódus meghívása argumentumokkal

Ez a példa meghívja a Create metódust, amely a Argumentumok paraméterrel van elnevezve.

Invoke-CimMethod -ClassName Win32_Process -MethodName "Create" -Arguments @{
  CommandLine = 'notepad.exe'; CurrentDirectory = "C:\windows\system32"
}

4. példa: Ügyféloldali ellenőrzés

Ez a példa az xyz metódus ügyféloldali ellenőrzését hajtja végre úgy, hogy egy CimClass objektumot ad át Invoke-CimMethod.

$c = Get-CimClass -ClassName Win32_Process
Invoke-CimMethod -CimClass $c -MethodName "xyz" -Arguments @{ CommandLine = 'notepad.exe' }

Paraméterek

-Arguments

Megadja azokat a paramétereket, amelyeket át kell adni a hívott metódusnak. Adja meg a paraméter értékeit név-érték párokként, amelyeket egy kivonattáblában tárol. A megadott értékek sorrendje nem fontos.

Paramétertulajdonságok

Típus:	IDictionary
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	1
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-CimClass

Egy CIM-osztályobjektumot határoz meg, amely a kiszolgálón található CIM-osztálydefiníciót jelöli. Használja ezt a paramétert egy osztály statikus metódusának meghívásához.

A Get-CimClass parancsmaggal lekérheti az osztálydefiníciót a kiszolgálóról.

A paraméter használata jobb ügyféloldali sémaérvényesítést eredményez.

Paramétertulajdonságok

Típus:	CimClass
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

CimClassComputerSet

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CimClassSessionSet

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-CimSession

A parancsot a megadott CIM-munkamenet használatával futtatja. Adjon meg egy változót, amely tartalmazza a CIM-munkamenetet, vagy egy olyan parancsot, amely létrehozza vagy lekéri a CIM-munkamenetet, például a New-CimSession vagy Get-CimSession parancsmagokat. További információért lásd: about_CimSession.

Paramétertulajdonságok

Típus:	CimSession[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

ClassNameSessionSet

Position:	Named
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CimInstanceSessionSet

Position:	Named
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CimClassSessionSet

Position:	Named
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

QuerySessionSet

Position:	Named
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

ResourceUriSessionSet

Position:	Named
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-ClassName

Annak a CIM-osztálynak a nevét adja meg, amelynek a műveletet végre kell hajtania. Ez a paraméter csak statikus metódusokhoz használható. Használhatja a tabulátorkiegészítést az osztályok listájának böngészéséhez, mivel a PowerShell a helyi WMI-kiszolgálóról kér le egy osztálylistát az osztálynevek megjelenítéséhez.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Osztály

Paraméterkészletek

ClassNameComputerSet

Position:	0
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

ClassNameSessionSet

Position:	0
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-ComputerName

Megadja annak a számítógépnek a nevét, amelyen futtatni szeretné a CIM-műveletet. Megadhat teljes tartománynevet (FQDN), NetBIOS-nevet vagy IP-címet.

A paraméter használatakor a parancsmag létrehoz egy ideiglenes munkamenetet a megadott számítógépen a WsMan protokoll használatával. Ellenkező esetben a parancsmag végrehajtja a műveletet a helyi számítógépen a Component Object Model (COM) használatával.

Csatlakozás CIM-munkamenet használatával a jobb teljesítmény érdekében, ha ugyanazon a számítógépen több műveletet hajtanak végre.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Kína, Kiszolgálónév

Paraméterkészletek

ClassNameComputerSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

ResourceUriComputerSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

CimClassComputerSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

CimInstanceComputerSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

QueryComputerSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Cf

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-InputObject

Megadja a metódus meghívásához bemenetként használandó CIM-példányobjektumot. Ez a paraméter csak példány metódusok meghívására használható. Az osztály statikus metódusainak meghívásához használja a Class paramétert vagy a CimClass paramétert.

Paramétertulajdonságok

Típus:	CimInstance
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	CimInstance

Paraméterkészletek

CimInstanceComputerSet

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CimInstanceSessionSet

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-MethodName

Megadja a meghívandó CIM-metódus nevét. Ez a paraméter kötelező, és nem lehet null értékű vagy üres. A CIM-osztály statikus metódusának meghívásához használja a ClassName vagy a CimClass paramétert.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Név

Paraméterkészletek

(All)

Position:	2
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Namespace

Megadja a CIM-művelet névterét. Az alapértelmezett névtér root/cimv2. A tabulátorkiegészítéssel tallózhat a névterek között, mert a PowerShell a helyi WMI-kiszolgálóról kér le egy névtérlistát, hogy biztosítsa a névterek listáját.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

ClassNameComputerSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

ClassNameSessionSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

ResourceUriComputerSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

ResourceUriSessionSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

QuerySessionSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

QueryComputerSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-OperationTimeoutSec

Megadja, hogy a parancsmag mennyi időt vár a számítógép válaszára. Alapértelmezés szerint az érték 0, ami azt jelenti, hogy a parancsmag a kiszolgáló alapértelmezett időtúllépési értékét használja.

Ha a OperationTimeoutSec paraméter értéke kisebb, mint az alapértelmezett kapcsolati újrapróbálkozási időkorlát 3 perc, a OperationTimeoutSec paraméter értékénél hosszabb hálózati hibák nem állíthatók helyre.

Paramétertulajdonságok

Típus:	UInt32
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	OT

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Query

A CIM-kiszolgálón futtatandó lekérdezést adja meg. A rendszer metódust hív meg a lekérdezés eredményeként kapott példányokon. A lekérdezés dialektusát a QueryDialect paraméterrel adhatja meg.

Ha a megadott érték dupla idézőjeleket ("), egyszeri idézőjeleket (') vagy fordított perjelet (\) tartalmaz, ezeket a karaktereket a fordított perjel (\) karakter előtagjával kell feloldani. Ha a megadott érték a WQL LIKE operátort használja, akkor a következő karaktereket szögletes zárójelekbe ([]): százalék (%), aláhúzásjel (_) vagy nyitó szögletes zárójelbe ([) kell foglalnia.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

QuerySessionSet

Position:	Named
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

QueryComputerSet

Position:	Named
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-QueryDialect

A Lekérdezés paraméterhez használt lekérdezési nyelvet adja meg. A paraméter elfogadható értékei a következők: WQL vagy CQL.

Az alapértelmezett érték WQL.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	WQL
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

QuerySessionSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

QueryComputerSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-ResourceUri

Az erőforrásosztály vagy -példány erőforrás-egységes erőforrás-azonosítóját (URI) adja meg. Az URI egy adott típusú erőforrás, például lemezek vagy folyamatok azonosítására szolgál a számítógépen.

Az URI egy előtagból és egy erőforrás elérési útból áll. Például:

http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

http://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings

Alapértelmezés szerint, ha nem adja meg ezt a paramétert, a rendszer a DMTF standard erőforrás URI-http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ használja, és hozzáfűzi az osztály nevét.

ResourceURI csak a WSMan protokollal létrehozott CIM-munkamenetekkel, vagy a ComputerName paraméter megadásakor használható, amely a WSMan használatával hoz létre CIM-munkamenetet.

Ha ezt a paramétert a ComputerName paraméter megadása nélkül adja meg, vagy ha egy DCOM protokoll használatával létrehozott CIM-munkamenetet ad meg, hibaüzenet jelenik meg. A DCOM protokoll nem támogatja a ResourceURI paramétert.

Ha a ResourceUri paraméter és a Szűrő paraméter is meg van adva, a Szűrő paraméter figyelmen kívül lesz hagyva.

Paramétertulajdonságok

Típus:	Uri
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

CimInstanceComputerSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

CimInstanceSessionSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Wi

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

CimClass

Ehhez a parancsmaghoz CIM-osztályt csövezhet.

CimInstance

Egy CIM-példányt erre a parancsmagra csövezhet.

Kimenetek

PSCustomObject

Ez a parancsmag egy objektumot ad vissza.

Jegyzetek

A PowerShell a következő aliasokat tartalmazza Invoke-CimMethod:

• Windows:
  • icim

Ez a parancsmag csak Windows-platformokon érhető el.

Kapcsolódó hivatkozások

• Get-CimClass
• Get-CimInstance (CimInstance lekérése)
• Get-CimSession
• New-CimSession