New-CimInstance

Syntax

ClassNameComputerSet (Standard)

New-CimInstance
    [-ClassName] <String>
    [[-Property] <IDictionary>]
    [-Key <String[]>]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-ComputerName <String[]>]
    [-ClientOnly]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ClassNameSessionSet

New-CimInstance
    [-ClassName] <String>
    [[-Property] <IDictionary>]
    -CimSession <CimSession[]>
    [-Key <String[]>]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-ClientOnly]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceUriSessionSet

New-CimInstance
    [[-Property] <IDictionary>]
    -ResourceUri <Uri>
    -CimSession <CimSession[]>
    [-Key <String[]>]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceUriComputerSet

New-CimInstance
    [[-Property] <IDictionary>]
    -ResourceUri <Uri>
    [-Key <String[]>]
    [-Namespace <String>]
    [-OperationTimeoutSec <UInt32>]
    [-ComputerName <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CimClassComputerSet

New-CimInstance
    [-CimClass] <CimClass>
    [[-Property] <IDictionary>]
    [-OperationTimeoutSec <UInt32>]
    [-ComputerName <String[]>]
    [-ClientOnly]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CimClassSessionSet

New-CimInstance
    [-CimClass] <CimClass>
    [[-Property] <IDictionary>]
    -CimSession <CimSession[]>
    [-OperationTimeoutSec <UInt32>]
    [-ClientOnly]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Beispiele

Beispiel 1: Erstellen einer Instanz einer CIM-Klasse

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

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

$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

$a = New-CimInstance -ClassName Win32_Process -Property @{Handle=0} -Key Handle -ClientOnly


Get-CimInstance -CimInstance $a


Invoke-CimMethod -CimInstance $a -MethodName GetOwner

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

$class = Get-CimClass -ClassName MSFT_Something -Namespace root/somewhere



New-CimInstance -CimClass $class -Property @{"Prop1"=1;"Prop2"="value"} -ClientOnly

Parameter

-CimClass

Gibt ein CIM-Klassenobjekt an, das den Typ der Instanz darstellt.

Sie können das cmdlet Get-CimClass verwenden, um die Klassendeklaration von einem Computer abzurufen.

Die Verwendung dieses Parameters führt zu besseren clientseitigen Schemaüberprüfungen.

Parametereigenschaften

Parametersätze

-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_CimSessions.

Parametereigenschaften

Parametersätze

-ClassName

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

Parametereigenschaften

Parametersätze

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

Parametereigenschaften

Parametersätze

-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 Ws-Man-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.

Parametereigenschaften

Parametersätze

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Parametersätze

-Key

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

Parametereigenschaften

Parametersätze

-Namespace

Gibt den Namespace der Klasse für die neue Instanz an.

Der Standardnamespace ist root/cimv2. HINWEIS: Sie können den Tabstoppabschluss verwenden, um die Liste der Namespaces zu durchsuchen, da PowerShell eine Liste von Namespaces vom lokalen WMI-Server abruft, um die Liste der Namespaces bereitzustellen.

Parametereigenschaften

Parametersätze

-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 Parameter OperationTimeoutSec auf einen Wert festgelegt ist, der kleiner als das robuste Verbindungsretrytimeout von 3 Minuten ist, können Netzwerkfehler, die mehr als der Wert des OperationTimeoutSec-Parameters dauern, nicht wiederhergestellt werden, da der Vorgang auf dem Server zu einem Timeout vor dem erneuten Herstellen der Verbindung führen kann.

Parametereigenschaften

Parametersätze

-Property

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

Wenn Sie den CimClass-Parameter angeben, führt das cmdlet New-CimInstance eine Eigenschaftsprüfung auf dem Client durch, 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.

Parametereigenschaften

Parametersätze

-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. Beispiel:

https://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 URI der DMTF-Standardressource http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ verwendet, und der Klassenname wird daran angefügt.

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 ohne Angabe des ComputersName-Parameters angeben oder 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.

Parametereigenschaften

Parametersätze

-WhatIf

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

Parametereigenschaften

Parametersätze

CommonParameters

Eingaben

None

Ausgaben

Object

Ähnliche Themen

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