New-CimInstance
Létrehoz egy CIM-példányt.
Syntax
New-CimInstance
[-ClassName] <String>
[-Key <String[]>]
[[-Property] <IDictionary>]
[-Namespace <String>]
[-OperationTimeoutSec <UInt32>]
[-ComputerName <String[]>]
[-ClientOnly]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CimInstance
[-ClassName] <String>
[-Key <String[]>]
[[-Property] <IDictionary>]
[-Namespace <String>]
[-OperationTimeoutSec <UInt32>]
-CimSession <CimSession[]>
[-ClientOnly]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CimInstance
-ResourceUri <Uri>
[-Key <String[]>]
[[-Property] <IDictionary>]
[-Namespace <String>]
[-OperationTimeoutSec <UInt32>]
-CimSession <CimSession[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CimInstance
-ResourceUri <Uri>
[-Key <String[]>]
[[-Property] <IDictionary>]
[-Namespace <String>]
[-OperationTimeoutSec <UInt32>]
[-ComputerName <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CimInstance
[-CimClass] <CimClass>
[[-Property] <IDictionary>]
[-OperationTimeoutSec <UInt32>]
-CimSession <CimSession[]>
[-ClientOnly]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CimInstance
[-CimClass] <CimClass>
[[-Property] <IDictionary>]
[-OperationTimeoutSec <UInt32>]
[-ComputerName <String[]>]
[-ClientOnly]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Ez a parancsmag csak a Windows platformon érhető el.
A New-CimInstance
parancsmag létrehoz egy CIM-osztálypéldányt a helyi számítógépen vagy egy távoli számítógépen található osztálydefiníció alapján. Alapértelmezés szerint a New-CimInstance
parancsmag létrehoz egy példányt a helyi számítógépen.
Példák
1. példa: CIM-osztály példányának létrehozása
Ez a példa létrehoz egy win32_environment nevű CIM-osztálypéldányt a számítógép gyökér/cimv2 névterében.
New-CimInstance -ClassName Win32_Environment -Property @{Name="testvar";VariableValue="testvalue";UserName="domain\user"}
Az ügyféloldali ellenőrzés nem történik meg, ha az osztály nem létezik, a tulajdonságok hibásak, vagy ha a kiszolgáló elutasítja a hívást. Ha a példány sikeresen létrejött, a parancsmag az újonnan létrehozott példányt adja ki.
2. példa: CIM-osztály példányának létrehozása osztályséma használatával
Ez a példa lekéri a CIM-osztályobjektumot, és egy nevű $class
változóban tárolja. Ezután a rendszer átadja a változó tartalmát a New-CimInstance
parancsmagnak.
$class = Get-CimClass -ClassName Win32_Environment
New-CimInstance -CimClass $class -Property @{Name="testvar";VariableValue="testvalue";UserName="Contoso\User1"}
3. példa: Dinamikus példány létrehozása az ügyfélen
Ez a példa egy Win32_Process nevű CIM-osztály dinamikus példányát hozza létre az ügyfélszámítógépen anélkül, hogy lekérte a példányt a kiszolgálóról. Az új példány a változóban $a
lesz tárolva. Ez a dinamikus példány akkor használható műveletek végrehajtására, ha az ezzel a kulccsal rendelkező példány megtalálható a kiszolgálón.
$a = New-CimInstance -ClassName Win32_Process -Property @{Handle=0} -Key Handle -ClientOnly
Get-CimInstance -CimInstance $a
Invoke-CimMethod -CimInstance $a -MethodName GetOwner
ProcessId Name HandleCount WorkingSetSize VirtualSize
--------- ---- ----------- -------------- -----------
0 System Idle Process 0 8192 8192
Domain :
ReturnValue : 2
User :
PSComputerName :
A Get-CimInstance
parancsmag ezután egy adott példányt kér le. A Invoke-CimMethod
parancsmag meghívja a GetOwner metódust a lekért példányon.
4. példa: Példány létrehozása egy adott névtér CIM-osztályához
Ez a példa lekéri egy MSFT_Something nevű CIM-osztály egy példányát a névtér gyökerében/valahol, és egy nevesített $class
változóban tárolja. A változó át lesz adva a New-CimInstance
parancsmagnak egy új CIM-példány létrehozásához és az ügyféloldali érvényesítések végrehajtásához az új példányon.
$class = Get-CimClass -ClassName MSFT_Something -Namespace root/somewhere
New-CimInstance -CimClass $class -Property @{"Prop1"=1;"Prop2"="value"} -ClientOnly
Ebben a példában a CimClass paraméter használata a ClassName paraméter helyett ellenőrzi, hogy a Prop1 és a Prop2 valóban létezik-e, és hogy a kulcsok megfelelően vannak-e megjelölve.
A ComputerName vagy a CimSession paraméter nem használható a ClientOnly paraméterrel.
Paraméterek
-CimClass
Egy CIM-osztályobjektumot ad meg, amely a példány típusát jelöli. Get-CimClass
A parancsmaggal lekérheti az osztálydeklarációt egy számítógéprő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űvelet létrehoz egy példányt. MEGJEGYZÉS: 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 |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ClientOnly
Azt jelzi, hogy a példány csak a PowerShellben jön létre a CIM-kiszolgálóra való ugrás nélkül. Ezzel a paramétersel létrehozhat egy memórián belüli CIM-példányt a későbbi PowerShell-műveletekhez.
Type: | SwitchParameter |
Aliases: | Local |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
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.
Ha megadja ezt a paramétert, a parancsmag létrehoz egy ideiglenes munkamenetet a megadott számítógépen a WSMan protokoll használatával.
Ha nem adja meg ezt a paramétert, a parancsmag a helyi számítógépen hajtja végre a műveletet a Component Object Model (COM) használatával.
Ha ugyanazon a számítógépen több műveletet végeznek, a CIM-munkamenet használatával való csatlakozás jobb teljesítményt nyújt.
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 |
-Key
Megadja a kulcsként használt tulajdonságokat. A Kulcs megadásakor a CimSession és a ComputerName nem használható.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Namespace
Az új példány osztályának névterét adja meg. 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 CIM-kiszolgáló válaszára. Alapértelmezés szerint ennek a paraméternek az értéke 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 a robusztus kapcsolat újrapróbálkozási időtúllépése 3 perc, akkor az OperationTimeoutSec paraméter értékénél hosszabb hálózati hibák nem állíthatók helyre, mert a kiszolgálón végzett művelet túllépi az időkorlátot, mielőtt az ügyfél újracsatlakozhat.
Type: | UInt32 |
Aliases: | OT |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Property
A CIM-példány tulajdonságait adja meg kivonattáblával (név-érték párok).
Ha megadja a CimClass paramétert, a New-CimInstance
parancsmag tulajdonságellenőrzést hajt végre az ügyfélen, hogy a megadott tulajdonságok összhangban legyenek a kiszolgálón található osztálydeklarációval. Ha a CimClass paraméter nincs megadva, akkor a tulajdonság érvényesítése a kiszolgálón történik.
Type: | IDictionary |
Aliases: | Arguments |
Position: | 1 |
Default value: | None |
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, mert 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: | True |
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
None
Ehhez a parancsmaghoz nem lehet objektumokat csövezni.
Kimenetek
Ez a parancsmag egy, a CIM-példány adatait tartalmazó objektumot ad vissza.
Jegyzetek
A PowerShell a következő aliasokat New-CimInstance
tartalmazza:
- Windows:
ncim
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: