Share via

New-CimInstance

  • Referencia
Modul:
CimCmdlets

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ű $classvá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 $alesz 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 $classvá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

CimInstance

Ez a parancsmag egy, a CIM-példány adatait tartalmazó objektumot ad vissza.

Jegyzetek

A PowerShell a következő aliasokat New-CimInstancetartalmazza:

  • Windows:
    • ncim

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