New-CimInstance

Referentie

Module:: CimCmdlets

Hiermee maakt u een CIM-exemplaar.

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

Deze cmdlet is alleen beschikbaar op het Windows-platform.

De New-CimInstance cmdlet maakt een exemplaar van een CIM-klasse op basis van de klassedefinitie op de lokale computer of een externe computer. De cmdlet maakt standaard New-CimInstance een exemplaar op de lokale computer.

Voorbeelden

Voorbeeld 1: Een exemplaar van een CIM-klasse maken

In dit voorbeeld wordt een exemplaar van een CIM-klasse gemaakt met de naam win32_environment in de hoofd-/cimv2-naamruimte op de computer.

New-CimInstance -ClassName Win32_Environment -Property @{Name="testvar";VariableValue="testvalue";UserName="domain\user"}

Er wordt geen validatie aan de clientzijde uitgevoerd als de klasse niet bestaat, de eigenschappen zijn onjuist of als de server de aanroep weigert. Als het exemplaar is gemaakt, voert de cmdlet het zojuist gemaakte exemplaar uit.

Voorbeeld 2: Een exemplaar van een CIM-klasse maken met behulp van een klasseschema

In dit voorbeeld wordt een CIM-klasseobject opgehaald en opgeslagen in een variabele met de naam $class. De inhoud van de variabele wordt vervolgens doorgegeven aan de New-CimInstance cmdlet.

$class = Get-CimClass -ClassName Win32_Environment
New-CimInstance -CimClass $class -Property @{Name="testvar";VariableValue="testvalue";UserName="Contoso\User1"}

Voorbeeld 3: Een dynamisch exemplaar maken op de client

In dit voorbeeld wordt een dynamisch exemplaar van een CIM-klasse gemaakt met de naam Win32_Process op de clientcomputer zonder dat het exemplaar van de server wordt opgehaald. Het nieuwe exemplaar wordt opgeslagen in de variabele $a. Dit dynamische exemplaar kan worden gebruikt om bewerkingen uit te voeren als het exemplaar met deze sleutel op de server bestaat.

$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 :

De Get-CimInstance cmdlet haalt vervolgens één exemplaar op. De Invoke-CimMethod cmdlet roept de Methode GetOwner aan op het opgehaalde exemplaar.

Voorbeeld 4: Een exemplaar maken voor een CIM-klasse van een specifieke naamruimte

In dit voorbeeld wordt een exemplaar van een CIM-klasse met de naam MSFT_Something opgehaald in de hoofdmap/ergens van de naamruimte en wordt deze opgeslagen in een variabele met de naam $class. De variabele wordt doorgegeven aan de New-CimInstance cmdlet om een nieuw CIM-exemplaar te maken en validaties aan de clientzijde uit te voeren op het nieuwe exemplaar.

$class = Get-CimClass -ClassName MSFT_Something -Namespace root/somewhere
New-CimInstance -CimClass $class -Property @{"Prop1"=1;"Prop2"="value"} -ClientOnly

In dit voorbeeld wordt met behulp van de parameter CimClass in plaats van de parameter ClassName gevalideerd dat Prop1 en Prop2 daadwerkelijk bestaan en dat de sleutels correct zijn gemarkeerd.

U kunt de parameter ComputerName of CimSession niet gebruiken met de parameter ClientOnly .

Parameters

-CimClass

Hiermee geeft u een CIM-klasseobject op dat het type van het exemplaar vertegenwoordigt. Gebruik de Get-CimClass cmdlet om de klassedeclaratie van een computer op te halen. Het gebruik van deze parameter resulteert in betere schemavalidaties aan de clientzijde.

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

-CimSession

Voert de opdracht uit met behulp van de opgegeven CIM-sessie. Voer een variabele in die de CIM-sessie bevat of een opdracht waarmee de CIM-sessie wordt gemaakt of ophaalt, zoals de New-CimSession of Get-CimSession cmdlets. Zie about_CimSession voor meer informatie.

Type:	CimSession[]
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ClassName

Hiermee geeft u de naam van de CIM-klasse waarvan de bewerking een exemplaar maakt. OPMERKING: U kunt tabvoltooiing gebruiken om door de lijst met klassen te bladeren, omdat PowerShell een lijst met klassen ophaalt van de lokale WMI-server om een lijst met klassennamen op te geven.

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

-ClientOnly

Geeft aan dat het exemplaar alleen wordt gemaakt in PowerShell zonder naar de CIM-server te gaan. U kunt deze parameter gebruiken om een CIM-exemplaar in het geheugen te maken voor gebruik in volgende PowerShell-bewerkingen.

Type:	SwitchParameter
Aliases:	Local
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputerName

Hiermee geeft u de naam van de computer waarop u de CIM-bewerking wilt uitvoeren. U kunt een FQDN (Fully Qualified Domain Name), een NetBIOS-naam of een IP-adres opgeven.

Als u deze parameter opgeeft, maakt de cmdlet een tijdelijke sessie naar de opgegeven computer met behulp van het WSMan-protocol.

Als u deze parameter niet opgeeft, voert de cmdlet de bewerking uit op de lokale computer met com (Component Object Model).

Als er meerdere bewerkingen op dezelfde computer worden uitgevoerd, kunt u beter verbinding maken met een CIM-sessie.

Type:	String[]
Aliases:	CN, ServerName
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Key

Hiermee geeft u de eigenschappen die worden gebruikt als sleutels. CimSession en ComputerName kunnen niet worden gebruikt wanneer sleutel is opgegeven.

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Namespace

Hiermee geeft u de naamruimte van de klasse voor het nieuwe exemplaar op. De standaardnaamruimte is root/cimv2. U kunt tabvoltooiing gebruiken om door de lijst met naamruimten te bladeren, omdat PowerShell een lijst met naamruimten ophaalt van de lokale WMI-server om de lijst met naamruimten op te geven.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-OperationTimeoutSec

Hiermee geeft u de hoeveelheid tijd op die de cmdlet wacht op een reactie van de CIM-server. De waarde van deze parameter is standaard 0, wat betekent dat de cmdlet de standaardtime-outwaarde voor de server gebruikt. Als de parameter OperationTimeoutSec is ingesteld op een waarde die kleiner is dan de robuuste time-out voor opnieuw proberen van 3 minuten, kunnen netwerkfouten die langer duren dan de waarde van de parameter OperationTimeoutSec niet worden hersteld, omdat er een time-out optreedt voordat de client opnieuw verbinding kan maken.

Type:	UInt32
Aliases:	OT
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Property

Hiermee geeft u de eigenschappen van het CIM-exemplaar op met behulp van een hash-tabel (naam-waardeparen).

Als u de CimClass-parameter opgeeft, voert de New-CimInstance cmdlet een eigenschapsvalidatie uit op de client om ervoor te zorgen dat de opgegeven eigenschappen consistent zijn met de klassedeclaratie op de server. Als de CimClass-parameter niet is opgegeven, wordt de eigenschapsvalidatie uitgevoerd op de server.

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

-ResourceUri

Hiermee geeft u de resource uniform resource identifier (URI) van de resourceklasse of het exemplaar. De URI wordt gebruikt om een specifiek type resource, zoals schijven of processen, op een computer te identificeren.

Een URI bestaat uit een voorvoegsel en een pad naar een resource. Bijvoorbeeld:

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

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

Als u deze parameter niet opgeeft, wordt standaard de STANDAARD-URI http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ van de DMTF-resource gebruikt en wordt de klassenaam eraan toegevoegd.

ResourceURI kan alleen worden gebruikt met CIM-sessies die zijn gemaakt met behulp van het WSMan-protocol of bij het opgeven van de parameter ComputerName , waarmee een CIM-sessie wordt gemaakt met WSMan. Als u deze parameter opgeeft zonder de parameter ComputerName op te geven of als u een CIM-sessie opgeeft die is gemaakt met het DCOM-protocol, krijgt u een foutmelding, omdat het DCOM-protocol de parameter ResourceURI niet ondersteunt.

Als zowel de parameter ResourceUri als de filterparameter zijn opgegeven, wordt de filterparameter genegeerd.

Type:	Uri
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Invoerwaarden

None

Deze cmdlet accepteert geen invoerobjecten.

Uitvoerwaarden

Object

Met deze cmdlet wordt een object geretourneerd dat de CIM-exemplaargegevens bevat.