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 コマンドレットは、ローカル コンピューターまたはリモート コンピューター上のクラス定義に基づいて CIM クラスのインスタンスを作成します。

[プロパティ] パラメーターを使用して、選択したプロパティの初期値を設定します。

既定では、New-CimInstance コマンドレットはローカル コンピューターにインスタンスを作成します。

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

このコマンドは、コンピュータ上の root/cimv2 名前空間に win32_environment という名前の CIM クラスのインスタンスを作成します。

クラスが存在しない場合、プロパティが間違っている場合、またはサーバーが呼び出しを拒否した場合、クライアント側の検証は実行されません。

インスタンスが正常に作成されると、New-CimInstance コマンドレットは新しく作成されたインスタンスを出力します。

$class = Get-CimClass -ClassName Win32_Environment



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

この一連のコマンドは、CIM クラス オブジェクトを取得し、Get-CimClass コマンドレットを使用して $class という名前の変数に格納します。 その後、変数の内容が New-CimInstance コマンドレットに渡されます。

$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 コマンドレットに渡します。 次に、Get-CimInstance コマンドレットは特定の 1 つのインスタンスを取得し、Invoke-CimMethod コマンドレットを使用して GetOwner メソッドを呼び出します。

この動的インスタンスは、このキーを持つインスタンスがサーバー上に存在する場合に操作を実行するために使用できます。

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



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

このコマンド セットは、名前空間 root/somewhere にある MSFT_Something という名前の CIM クラスのインスタンスを取得し、Get-CimClass コマンドレットを使用して $class という名前の変数に格納します。 その後、変数の内容を New-CimInstance コマンドレットに渡して、新しい CIM インスタンスを作成し、新しいインスタンスでクライアント側の検証を実行します。

たとえば、Prop1 と Prop2 が実際に存在し、キーが正しくマークされていることを確認するためにインスタンスを検証する場合は、ClassName パラメーターの代わりに CimClass パラメーターを使用します。

ComputerName パラメーターまたは CimSession パラメーターを ClientOnly パラメーターと共に使用することはできません。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

このコマンドレットは、入力オブジェクトを受け入れなくなります。

このコマンドレットは、CIM インスタンス情報を含むオブジェクトを返します。