Invoke-CimMethod
EGY CIM-osztály metódusát hívja meg.
Syntax
Invoke-CimMethod
[-ClassName] <String>
[-ComputerName <String[]>]
[[-Arguments] <IDictionary>]
[-MethodName] <String>
[-Namespace <String>]
[-OperationTimeoutSec <UInt32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-CimMethod
[-ClassName] <String>
-CimSession <CimSession[]>
[[-Arguments] <IDictionary>]
[-MethodName] <String>
[-Namespace <String>]
[-OperationTimeoutSec <UInt32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-CimMethod
-ResourceUri <Uri>
[-ComputerName <String[]>]
[[-Arguments] <IDictionary>]
[-MethodName] <String>
[-Namespace <String>]
[-OperationTimeoutSec <UInt32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-CimMethod
[-ResourceUri <Uri>]
[-InputObject] <CimInstance>
-CimSession <CimSession[]>
[[-Arguments] <IDictionary>]
[-MethodName] <String>
[-OperationTimeoutSec <UInt32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-CimMethod
[-ResourceUri <Uri>]
[-InputObject] <CimInstance>
[-ComputerName <String[]>]
[[-Arguments] <IDictionary>]
[-MethodName] <String>
[-OperationTimeoutSec <UInt32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-CimMethod
-ResourceUri <Uri>
-CimSession <CimSession[]>
[[-Arguments] <IDictionary>]
[-MethodName] <String>
[-Namespace <String>]
[-OperationTimeoutSec <UInt32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-CimMethod
[-CimClass] <CimClass>
[-ComputerName <String[]>]
[[-Arguments] <IDictionary>]
[-MethodName] <String>
[-OperationTimeoutSec <UInt32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-CimMethod
[-CimClass] <CimClass>
-CimSession <CimSession[]>
[[-Arguments] <IDictionary>]
[-MethodName] <String>
[-OperationTimeoutSec <UInt32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-CimMethod
-Query <String>
[-QueryDialect <String>]
[-ComputerName <String[]>]
[[-Arguments] <IDictionary>]
[-MethodName] <String>
[-Namespace <String>]
[-OperationTimeoutSec <UInt32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-CimMethod
-Query <String>
[-QueryDialect <String>]
-CimSession <CimSession[]>
[[-Arguments] <IDictionary>]
[-MethodName] <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 az Argumentumok paraméter által megadott név-érték párok használatával.
Ha az InputObject paraméter nincs 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 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 vagy a CimSession paraméter által megadott CIM-kiszolgálóval működik.
Ha az InputObject paraméter meg van adva, 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 bemeneti objektum CIM-munkamenetét vagy számítógépnevét használja.
- Ha a ComputerName vagy a CimSession paraméter van megadva, akkor ez a parancsmag a CimSession paraméter vagy a ComputerName paraméter értékét 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 objektumát, és a parancsmag használatával Get-CimInstance
elnevezett $x
változóban tárolja. Ezután a rendszer a változó tartalmát használja a parancsmag InputObject eleméhez Invoke-CimMethod
. A Rendszer meghívja a GetOwner metódust a CimInstance-hez.
$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 az Argumentumok paraméterrel elnevezett Létrehozás metódust.
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 a rendszernekInvoke-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.
Type: | IDictionary |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | CimClass |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 parancsot, amely létrehozza vagy lekéri a CIM-munkamenetet, például a New-CimSession
parancsmagokat.Get-CimSession
További információ: about_CimSession.
Type: | CimSession[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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ó. A tabulátorkiegészítéssel tallózhat az osztályok listájában, mivel a PowerShell lekéri a helyi WMI-kiszolgálóról az osztályok listáját az osztálynevek listájának megadásához.
Type: | String |
Aliases: | Class |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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álata a jobb teljesítmény érdekében, ha több műveletet hajtanak végre ugyanazon a számítógépen.
Type: | String[] |
Aliases: | CN, ServerName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Jóváhagyást kér a parancsmag futtatása előtt.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 az Osztály paramétert vagy a CimClass paramétert.
Type: | CimInstance |
Aliases: | CimInstance |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 .
Type: | String |
Aliases: | Name |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Namespace
Megadja a CIM-művelet névterét. Az alapértelmezett névtér a root/cimv2. A tabulátorkiegészítéssel tallózhat a névterek listájában, mivel a PowerShell lekéri a névterek listáját a helyi WMI-kiszolgálóról a névterek listájának megadásához.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 az OperationTimeoutSec paraméter értéke kisebb, mint az alapértelmezett kapcsolati újrapróbálkozási időkorlát 3 perc, akkor az OperationTimeoutSec paraméter értékénél hosszabb hálózati hibák nem állíthatók helyre.
Type: | UInt32 |
Aliases: | OT |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 úgy kell feloldani, hogy szögletes zárójelekbe (): százalékba ([]
%
), aláhúzásjelbe (_
) vagy nyitó szögletes zárójelbe ([
) foglalja őket.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 a WQL.
Type: | String |
Position: | Named |
Default value: | WQL |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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élda:
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-t http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/
használja, és hozzáfűzi az osztály nevét.
A ResourceURI csak a WSMan protokollal létrehozott CIM-munkamenetekkel használható, vagy a ComputerName paraméter megadásakor, 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.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Bevitelek
Ehhez a parancsmaghoz CIM-osztályt csövezhet.
Egy CIM-példányt erre a parancsmagra csövezhet.
Kimenetek
Ez a parancsmag egy objektumot ad vissza.
Jegyzetek
A PowerShell a következő aliasokat Invoke-CimMethod
tartalmazza:
- Windows:
icim
Ez a parancsmag csak Windows-platformokon érhető el.
Kapcsolódó hivatkozások
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: