New-Item

モジュール:: Microsoft.PowerShell.Management

新しい項目を作成します。

構文

New-Item
   [-Path] <String[]>
   [-ItemType <String>]
   [-Value <Object>]
   [-Force]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [<CommonParameters>]

New-Item
   [[-Path] <String[]>]
   -Name <String>
   [-ItemType <String>]
   [-Value <Object>]
   [-Force]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [<CommonParameters>]

説明

New-Item コマンドレットは、新しい項目を作成し、その値を設定します。作成できる項目の種類は、項目の場所によって異なります。たとえば、ファイルシステムでは、New-Item によってファイルとフォルダーが作成されます。レジストリで、レジストリキーとエントリ New-Item 作成します。

New-Item は、作成する項目の値を設定することもできます。たとえば、新しいファイルを作成するときに、New-Item ファイルに初期コンテンツを追加できます。

例

例 1: 現在のディレクトリにファイルを作成する

このコマンドは、現在のディレクトリに "testfile1.txt" という名前のテキストファイルを作成します。 Path パラメーターの値のドット ('.') は、現在のディレクトリを示します。 Value パラメーターに続く引用符で囲まれたテキストが、コンテンツとしてファイルに追加されます。

New-Item -Path . -Name "testfile1.txt" -ItemType "file" -Value "This is a text string."

例 2: ディレクトリを作成する

このコマンドは、C: ドライブに "Logfiles" という名前のディレクトリを作成します。 ItemType パラメーターは、新しい項目がファイルやその他のファイルシステムオブジェクトではなくディレクトリであることを指定します。

New-Item -Path "c:\" -Name "logfiles" -ItemType "directory"

例 3: プロファイルを作成する

このコマンドは、$profile 変数で指定されたパスに PowerShell プロファイルを作成します。

プロファイルを使用して PowerShell をカスタマイズできます。 $profile は、"CurrentUser/CurrentHost" プロファイルのパスとファイル名を格納する自動 (組み込み) 変数です。既定では、PowerShell にパスとファイル名が格納されている場合でも、プロファイルは存在しません。

このコマンドでは、$profile 変数はファイルのパスを表します。 ItemType パラメーターは、コマンドがファイルを作成することを指定します。 Force パラメーターを使用すると、パス内のディレクトリが存在しない場合でも、プロファイルパスにファイルを作成できます。

プロファイルを作成したら、プロファイルにエイリアス、関数、スクリプトを入力してシェルをカスタマイズできます。

詳細については、「about_Automatic_Variables と about_Profiles」を参照してください。

New-Item -Path $profile -ItemType "file" -Force

注

このメソッドを使用してファイルを作成すると、結果のファイルはバイトオーダーマーク (BOM) なしで UTF-8 としてエンコードされます。

例 4: 別のディレクトリにディレクトリを作成する

この例では、"C:\PS-Test" ディレクトリに新しい Scripts ディレクトリを作成します。

新しいディレクトリ項目 "Scripts" の名前は、Nameの値に指定されるのではなく、Path パラメーターの値に含まれます。構文で示されているように、どちらのコマンド形式も有効です。

New-Item -ItemType "directory" -Path "c:\ps-test\scripts"

例 5: 複数のファイルを作成する

この例では、2 つの異なるディレクトリにファイルを作成します。 Path は複数の文字列を受け取るため、複数の項目を作成するために使用できます。

New-Item -ItemType "file" -Path "c:\ps-test\test.txt", "c:\ps-test\Logs\test.log"

パラメーター

-Confirm

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

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Credential

注

このパラメーターは、PowerShell でインストールされているプロバイダーではサポートされていません。このコマンドレットを実行するときに別のユーザーを偽装したり、資格情報を昇格したりするには、Invoke-Commandを使用します。

型:	PSCredential
配置:	Named
規定値:	Current user
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Force

このコマンドレットは、既存の読み取り専用アイテムに書き込む項目を強制的に作成します。実装はプロバイダーによって異なります。詳細については、about_Providersを参照してください。 Force パラメーターを使用しても、コマンドレットはセキュリティ制限をオーバーライドできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ItemType

新しい項目のプロバイダー指定の型を指定します。このパラメーターで使用できる値は、使用している現在のプロバイダーによって異なります。

場所が FileSystem ドライブ内にある場合は、次の値を使用できます。

ファイル
ディレクトリ
シンボリックリンク
接合部
ハードリンク

このメソッドを使用してファイルを作成すると、結果のファイルはバイトオーダーマーク (BOM) なしで UTF-8 としてエンコードされます。

Certificate ドライブでは、次の値を指定できます。

証明書プロバイダー
証書
ストア
店舗所在地

詳細については、about_Providersを参照してください。

型:	String
Aliases:	Type
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Name

新しい項目の名前を指定します。

Name または Path パラメーター値で新しい項目の名前を指定できます。また、新しい項目のパスを Name または Path 値で指定できます。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Path

新しい項目の場所のパスを指定します。ワイルドカード文字を使用できます。

[名前] で新しい項目の名前指定するか、パスに含めることができます。

型:	String[]
配置:	0
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	True

-UseTransaction

アクティブなトランザクションにコマンドを含みます。このパラメーターは、トランザクションが進行中の場合にのみ有効です。詳細については、about_Transactionsを参照してください。

型:	SwitchParameter
Aliases:	usetx
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Value

新しい項目の値を指定します。値をパイプ処理して New-Itemすることもできます。

型:	Object
Aliases:	Target
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットを実行した場合の動作を示します。コマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

Object

新しい項目の値をこのコマンドレットにパイプできます。

出力