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ódokon 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 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 az alábbi módokon működik:

  • Ha sem a ComputerName paraméter, sem a CimSession paraméter nincs megadva, akkor ez a parancsmag a bemeneti objektumBÓL származó CIM-munkamenetet vagy számítógépnevet 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 Terminate 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ányobjektumot, és a parancsmag használatával Get-CimInstance elnevezett $x változóban tárolja. Ezt követően a rendszer a változó tartalmát használja a parancsmag InputObject elemeként Invoke-CimMethod . A Rendszer meghívja a GetOwnermetó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 Createmetó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 egy CimClass objektum átadásával.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.

Type:IDictionary
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-CimClass

Egy CIM-osztályobjektumot ad 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érhet egy 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
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
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ó osztálylistáját az osztálynevek listájának megadásához.

Type:String
Aliases:Class
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Annak a számítógépnek a nevét adja meg, 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 ideiglenes munkamenetet hoz létre 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 komponensobjektum-modell (COM) használatával.

Csatlakozás CIM-munkamenet használatával 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
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
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ánymetóták meghívására használható. Az osztály statikus metódusainak meghívásához használja az Osztály vagy a CimClass paramétert.

Type:CimInstance
Aliases:CimInstance
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-MethodName

A meghívni kívánt CIM-metódus nevét adja meg. 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
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
Accept pipeline input:True
Accept wildcard characters:False

-OperationTimeoutSec

Megadja, hogy a parancsmag mennyi ideig várjon 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 3 perces kapcsolat-újrapróbálkozási időtúllépés, 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
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 fogadott példányokon. A lekérdezés dialektusát a QueryDialect paraméterrel adhatja meg.

Ha a megadott érték idézőjeleket ("), szimpla 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ójelek (): százalék ([]%), aláhúzásjel (_) vagy nyitó szögletes zárójel ([) közé kell foglalnia.

Type:String
Position:Named
Default value:None
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
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é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-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 létrehoz egy CIM-munkamenetet a WSMan használatával.

Ha ezt a paramétert a ComputerName paraméter megadása nélkül adja meg, vagy 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
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
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

CIM class

Ez a parancsmag egy CIM-osztályt fogad el bemeneti objektumként.

CIM instance

Ez a parancsmag egy CIM-példányt fogad el bemeneti objektumként.

Kimenetek

PSCustomObject

Ez a parancsmag egy objektumot ad vissza.