New-CimInstance

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

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

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

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

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

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

New-CimInstance cmdlet 基于本地计算机或远程计算机上的类定义创建 CIM 类的实例。

使用 Property 参数设置所选属性的初始值。

默认情况下，New-CimInstance cmdlet 在本地计算机上创建实例。

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

此命令在计算机上的 root/cimv2 命名空间中创建名为win32_environment的 CIM 类的实例。

如果类不存在、属性错误或服务器拒绝调用，则不执行客户端验证。

如果已成功创建实例，则 New-CimInstance cmdlet 输出新创建的实例。

$class = Get-CimClass -ClassName Win32_Environment



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

此命令集检索 CIM 类对象，并使用 Get-CimClass cmdlet 将其存储在名为$class的变量中。 然后，变量的内容将传递给 New-CimInstance cmdlet。

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


Get-CimInstance -CimInstance $a


Invoke-CimMethod -CimInstance $a -MethodName GetOwner

此命令集在客户端计算机上创建名为 win32_Process 的 CIM 类的动态实例，而无需从服务器获取实例。 这组命令检索动态实例并将其存储在名为$a的变量中，并将变量的内容传递给 Get-CimInstance cmdlet。 然后，Get-CimInstance cmdlet 检索特定的单个实例，并使用 Invoke-CimMethod cmdlet 调用 GetOwner 方法。

如果服务器上存在具有此密钥的实例，则可以使用此动态实例执行操作。

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



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

此命令集获取命名空间根/某个位置中名为MSFT_Something的 CIM 类的实例，并使用 Get-CimClass cmdlet 将其存储在名为$class的变量中。 然后将变量的内容传递给 New-CimInstance cmdlet，以创建新的 CIM 实例，并在新实例上执行客户端验证。

例如，如果要验证实例，若要确保 Prop1 和 Prop2 实际存在并且键已正确标记，请使用 CimClass 参数而不是 ClassName 参数。

不能将 ComputerName 或 CimSession 参数与 ClientOnly 参数一起使用。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

此 cmdlet 不接受任何输入对象。

此 cmdlet 返回包含 CIM 实例信息的对象。