New-CimInstance

Modul:

CimCmdlets

Erstellt eine CIM-Instanz.

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>]

Beschreibung

Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.

Das Cmdlet New-CimInstance erstellt eine Instanz einer CIM-Klasse auf Grundlage der Klassendefinition entweder auf einem lokalen Computer oder auf einem Remotecomputer. Standardmäßig erstellt das Cmdlet New-CimInstance eine Instanz auf dem lokalen Computer.

Beispiele

Beispiel 1: Erstellen einer Instanz einer CIM-Klasse

In diesem Beispiel wird eine Instanz einer CIM-Klasse namens win32_environment im Root/cimv2-Namespace auf dem Computer erstellt.

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

Es wird keine clientseitige Überprüfung ausgeführt, wenn die Klasse nicht vorhanden ist, die Eigenschaften falsch sind oder der Server den Aufruf ablehnt. Wenn die Instanz erfolgreich erstellt wird, gibt das Cmdlet die neu erstellte Instanz aus.

Beispiel 2: Erstellen einer Instanz einer CIM-Klasse mithilfe eines Klassenschemas

In diesem Beispiel wird ein CIM-Klassenobjekt abgerufen und in einer Variablen namens $classgespeichert. Der Inhalt der Variablen wird dann an das Cmdlet New-CimInstance übergeben.

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

Beispiel 3: Erstellen einer dynamischen Instanz auf dem Client

In diesem Beispiel wird eine dynamische Instanz einer CIM-Klasse namens Win32_Process auf dem Clientcomputer erstellt, ohne die Instanz vom Server zu erhalten. Die neue Instanz wird in der Variablen $agespeichert. Diese dynamische Instanz kann verwendet werden, um Vorgänge auszuführen, wenn die Instanz mit diesem Schlüssel auf dem Server vorhanden ist.

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

Das cmdlet Get-CimInstance ruft dann eine bestimmte einzelne Instanz ab. Das Invoke-CimMethod-Cmdlet ruft die GetOwner-Methode für die abgerufene Instanz auf.

Beispiel 4: Erstellen einer Instanz für eine CIM-Klasse eines bestimmten Namespaces

In diesem Beispiel wird eine Instanz einer CIM-Klasse namens MSFT_Something im Namespace root/somewhere abgerufen und in einer Variablen namens $classgespeichert. Die Variable wird an das Cmdlet New-CimInstance übergeben, um eine neue CIM-Instanz zu erstellen und clientseitige Überprüfungen für die neue Instanz durchzuführen.

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

In diesem Beispiel wird durch Verwenden des Parameters CimClass anstelle des parameters ClassName überprüft, ob Prop1 und Prop2- tatsächlich vorhanden sind und dass die Schlüssel richtig gekennzeichnet sind.

Sie können den Parameter ComputerName oder CimSession nicht mit dem parameter ClientOnly verwenden.

Parameter

-CimClass

Gibt ein CIM-Klassenobjekt an, das den Typ der Instanz darstellt. Verwenden Sie das Cmdlet Get-CimClass, um die Klassendeklaration von einem Computer abzurufen. Die Verwendung dieses Parameters führt zu besseren clientseitigen Schemaüberprüfungen.

Typ:	CimClass
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-CimSession

Führt den Befehl mithilfe der angegebenen CIM-Sitzung aus. Geben Sie eine Variable ein, die die CIM-Sitzung enthält, oder einen Befehl, der die CIM-Sitzung erstellt oder abruft, z. B. die New-CimSession- oder Get-CimSession-Cmdlets. Weitere Informationen finden Sie unter about_CimSession.

Typ:	CimSession[]
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-ClassName

Gibt den Namen der CIM-Klasse an, von der der Vorgang eine Instanz erstellt. HINWEIS: Sie können die Tabulatorvervollständigung nutzen, um die Klassenliste zu durchsuchen, da PowerShell eine Liste von Klassen vom lokalen WMI-Server abruft, um Klassennamen bereitzustellen.

Typ:	String
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-ClientOnly

Gibt an, dass die Instanz nur in PowerShell erstellt wird, ohne zum CIM-Server zu wechseln. Sie können diesen Parameter verwenden, um eine CIM-Instanz im Arbeitsspeicher für die Verwendung in nachfolgenden PowerShell-Vorgängen zu erstellen.

Typ:	SwitchParameter
Aliase:	Local
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ComputerName

Gibt den Namen des Computers an, auf dem Der CIM-Vorgang ausgeführt werden soll. Sie können einen vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN), einen NetBIOS-Namen oder eine IP-Adresse angeben.

Wenn Sie diesen Parameter angeben, erstellt das Cmdlet mithilfe des WSMan-Protokolls eine temporäre Sitzung auf dem angegebenen Computer.

Wenn Sie diesen Parameter nicht angeben, führt das Cmdlet den Vorgang auf dem lokalen Computer mithilfe des Component Object Model (COM) aus.

Wenn mehrere Vorgänge auf demselben Computer ausgeführt werden, bietet die Verbindung mit einer CIM-Sitzung eine bessere Leistung.

Typ:	String[]
Aliase:	CN, ServerName
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Key

Gibt die Eigenschaften an, die als Schlüssel verwendet werden. CimSession und ComputerName können nicht verwendet werden, wenn Key angegeben wird.

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Namespace

Gibt den Namespace der Klasse für die neue Instanz an. Der Standardnamespace ist root/cimv2. Sie können die Tabvervollständigung verwenden, um die Liste der Namespaces zu durchsuchen, da PowerShell eine Liste von Namespaces vom lokalen WMI-Server abruft, um diese bereitzustellen.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-OperationTimeoutSec

Gibt die Zeitspanne an, die das Cmdlet auf eine Antwort vom CIM-Server wartet. Standardmäßig ist der Wert dieses Parameters 0, was bedeutet, dass das Cmdlet den Standardtimeoutwert für den Server verwendet. Wenn der OperationTimeoutSec-Parameter auf einen Wert festgelegt ist, der kleiner als das robuste Verbindungsretrytimeout von 3 Minuten ist, können Netzwerkfehler, die länger als der Wert des OperationTimeoutSec-Parameters andauern, nicht behoben werden, da der Vorgang auf dem Server zu einem Timeout führt, bevor der Client die Verbindung erneut herstellen kann.

Typ:	UInt32
Aliase:	OT
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Property

Gibt die Eigenschaften der CIM-Instanz mithilfe einer Hashtabelle (Name-Wert-Paare) an.

Wenn Sie den parameter CimClass angeben, führt das cmdlet New-CimInstance eine Eigenschaftenüberprüfung auf dem Client aus, um sicherzustellen, dass die angegebenen Eigenschaften mit der Klassendeklaration auf dem Server konsistent sind. Wenn der CimClass Parameter nicht angegeben ist, erfolgt die Eigenschaftenüberprüfung auf dem Server.

Typ:	IDictionary
Aliase:	Arguments
Position:	1
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-ResourceUri

Gibt den URI (Uniform Resource Identifier) der Ressourcenklasse oder -instanz an. Der URI wird verwendet, um einen bestimmten Ressourcentyp zu identifizieren, z. B. Datenträger oder Prozesse, auf einem Computer.

Ein URI besteht aus einem Präfix und einem Pfad zu einer Ressource. Zum Beispiel:

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

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

Wenn Sie diesen Parameter nicht angeben, wird standardmäßig der DMTF-Standardressourcen-URI http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ verwendet, und der Klassenname wird daran angehängt.

ResourceURI- kann nur mit CIM-Sitzungen verwendet werden, die mit dem WSMan-Protokoll erstellt wurden, oder beim Angeben des ComputerName-Parameters, der eine CIM-Sitzung mit WSMan erstellt. Wenn Sie diesen Parameter angeben, ohne den parameter ComputerName anzugeben, oder wenn Sie eine MIT DCOM-Protokoll erstellte CIM-Sitzung angeben, wird ein Fehler angezeigt, da das DCOM-Protokoll den ResourceURI Parameter nicht unterstützt.

Wenn sowohl der Parameter ResourceUri als auch der Parameter Filter angegeben werden, wird der Parameter Filter ignoriert.

Typ:	Uri
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

None

Sie können keine Objekte an dieses Cmdlet weiterleiten.

Ausgaben

CimInstance

Dieses Cmdlet gibt ein Objekt zurück, das die CIM-Instanzinformationen enthält.

Hinweise

PowerShell enthält die folgenden Aliase für New-CimInstance:

• Windows:
  • ncim

Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.

Ähnliche Themen

• Get-CimClass
• Get-CimInstance
• Remove-CimInstance
• Set-CimInstance