New-CimInstance

モジュール:

CimCmdlets

CIM インスタンスを作成します。

構文

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

説明

このコマンドレットは、Windows プラットフォームでのみ使用できます。

このコマンドレットは New-CimInstance 、ローカル コンピューターまたはリモート コンピューター上のクラス定義に基づいて CIM クラスのインスタンスを作成します。 既定では、コマンドレットは New-CimInstance ローカル コンピューター上にインスタンスを作成します。

例

例 1: CIM クラスのインスタンスを作成する

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

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

クラスが存在しない場合、プロパティが間違っている場合、またはサーバーが呼び出しを拒否した場合、クライアント側の検証は実行されません。 インスタンスが正常に作成されると、コマンドレットは新しく作成されたインスタンスを出力します。

例 2: クラス スキーマを使用して CIM クラスのインスタンスを作成する

この例では、CIM クラス オブジェクトを取得し、. $class. その後、変数の内容がコマンドレットに New-CimInstance 渡されます。

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

例 3: クライアントで動的インスタンスを作成する

この例では、サーバーからインスタンスを取得せずに、クライアント コンピューターに Win32_Process という名前の CIM クラスの動的インスタンスを作成します。 新しいインスタンスは変数 $aに格納されます。 この動的インスタンスは、このキーを持つインスタンスがサーバー上に存在する場合に操作を実行するために使用できます。

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

その後、コマンドレットは Get-CimInstance 特定の単一インスタンスを取得します。 コマンドレットは Invoke-CimMethod 、取得したインスタンスで GetOwner メソッドを呼び出します。

例 4: 特定の名前空間の CIM クラスのインスタンスを作成する

この例では、名前空間のルートまたはどこかに MSFT_Something という名前の CIM クラスのインスタンスを取得し、それを名前付きの$class変数に格納します。 この変数は、新しい CIM インスタンスを New-CimInstance 作成し、新しいインスタンスでクライアント側の検証を実行するためにコマンドレットに渡されます。

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

この例では、ClassName パラメーターの代わりに CimClass パラメーターを使用すると、Prop1 と Prop2 が実際に存在し、キーが正しくマークされていることを検証します。

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

パラメーター

-CimClass

インスタンスの型を表す CIM クラス オブジェクトを指定します。 コマンドレットを Get-CimClass 使用して、コンピューターからクラス宣言を取得します。 このパラメーターを使用すると、クライアント側のスキーマ検証が向上します。

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

-CimSession

指定した CIM セッションを使用してコマンドを実行します。 CIM セッションを含む変数、または CIM セッションを作成または取得するコマンド (コマンドレットGet-CimSessionなど) をNew-CimSession入力します。 詳細については、「about_CimSession」を参照してください。

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

-ClassName

操作でインスタンスを作成する CIM クラスの名前を指定します。 注: PowerShell はローカル WMI サーバーからクラスの一覧を取得してクラス名の一覧を提供するため、タブ補完を使用してクラスの一覧を参照できます。

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

-ClientOnly

インスタンスが Cim サーバーに移動せずに PowerShell でのみ作成されることを示します。 このパラメーターを使用して、後続の PowerShell 操作で使用するメモリ内 CIM インスタンスを作成できます。

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

-ComputerName

CIM 操作を実行するコンピューターの名前を指定します。 完全修飾 doメイン 名 (FQDN)、NetBIOS 名、または IP アドレスを指定できます。

このパラメーターを指定すると、コマンドレットは WSMan プロトコルを使用して、指定したコンピューターへの一時的なセッションを作成します。

このパラメーターを指定しない場合、コマンドレットはコンポーネント オブジェクト モデル (COM) を使用してローカル コンピューターで操作を実行します。

同じコンピューターで複数の操作が実行されている場合、CIM セッションを使用して接続するとパフォーマンスが向上します。

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

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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

-Key

キーとして使用されるプロパティを指定します。 キーが指定されている場合、CimSession と ComputerName を使用できません。

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

-Namespace

新しいインスタンスのクラスの名前空間を指定します。 既定の名前空間は root/cimv2 です。 PowerShell はローカル WMI サーバーから名前空間の一覧を取得して名前空間の一覧を提供するため、タブ補完を使用して名前空間の一覧を参照できます。

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

-OperationTimeoutSec

CIM サーバーからの応答をコマンドレットが待機する時間を指定します。 既定では、このパラメーターの値は 0 です。これは、コマンドレットがサーバーの既定のタイムアウト値を使用することを意味します。 OperationTimeoutSec パラメーターが、堅牢な接続再試行タイムアウトの 3 分未満の値に設定されている場合、クライアントが再接続する前にサーバー上の操作がタイムアウトするため、OperationTimeoutSec パラメーターの値を超えるネットワーク 障害は復旧できません。

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

-Property

ハッシュ テーブル (名前と値のペア) を使用して CIM インスタンスのプロパティを指定します。

CimClass パラメーターを指定した場合、コマンドレットはNew-CimInstanceクライアントでプロパティ検証を実行して、指定されたプロパティがサーバー上のクラス宣言と一致していることを確認します。 CimClass パラメーターが指定されていない場合、プロパティの検証はサーバーで行われます。

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

-ResourceUri

リソース クラスまたはインスタンスのリソース Uniform Resource Identifier (URI) を指定します。 URI は、ディスクやプロセスなど、コンピューター上の特定の種類のリソースを特定するために使用されます。

URI は、プレフィックスとリソースのパスで構成されます。 次に例を示します。

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

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

既定では、このパラメーターを指定しない場合は、DMTF 標準リソース URI http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ が使用され、クラス名が追加されます。

ResourceURI は、WSMan プロトコルを使用して作成された CIM セッション、または WSMan を使用して CIM セッションを作成する ComputerName パラメーターを指定する場合にのみ使用できます。 ComputerName パラメーターを指定せずにこのパラメーターを指定した場合、または DCOM プロトコルを使用して作成された CIM セッションを指定した場合、DCOM プロトコルは ResourceURI パラメーターをサポートしていないため、エラーが発生します。

ResourceUri パラメーターと Filter パラメーターの両方が指定されている場合、Filter パラメーターは無視されます。

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

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

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

入力

None

このコマンドレットにオブジェクトをパイプすることはできません。

出力

CimInstance

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

メモ

PowerShell には、次のエイリアスが New-CimInstance含まれています。

• Windows:
  • ncim

このコマンドレットは、Windows プラットフォームでのみ使用できます。

関連リンク

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