例
————————– 例 1 ————————–
PS C:\>new-item -path . -name testfile1.txt -itemtype "file" -value "This is a text string."このコマンドは testfile1.txt というテキストファイルを現在のディレクトリに作成します。Path パラメータの値にあるドット (.) が現在のディレクトリを表し、 Value パラメータに続く引用テキストはコンテンツとしてファイルに追加されます。
————————– 例 2 ————————–
PS C:\>new-item -path c:\ -name logfiles -itemtype directoryこのコマンドは C: ドライブに Logfiles というディレクトリを作成します。ItemType パラメータは、新しい項目がファイルや他のファイルシステムオブジェクトではなく、ディレクトリであることを指定します。
————————– 例 3 ————————–
PS C:\>new-item -path $profile -itemtype file -forceこのコマンドは、Windows PowerShell プロファイルを $profile 変数で指定されたパスに作成します。
Windows PowerShell をカスタマイズするためにプロファイルを使用できます。$profile は CurrentUser/CurrentHost プロファイルのパスとファイル名を格納する自動（組み込み）変数で、Windows PowerShell がそのパスとファイル名を格納しても、デフォルトではプロファイルは存在しません。
このコマンドを使用してプロファイルを作成した後、シェルをカスタマイズするためにプロファイルにエイリアス、関数、およびスクリプトを入力することができます。
詳細については、about_Automatic_Variables および about_Profiles を参照してください。
————————– 例 4 ————————–
PS C:\>new-item -itemtype directory -path c:\ps-test\scriptsこのコマンドは C:\PS-Test ディレクトリに新しい Scripts ディレクトリを作成しま す。
新しいディレクトリの項目名 Scripts は、Name パラメータの値で指定するのではなく、Path パラメータの値に含まれます。
————————– 例 5 ————————–
PS C:\>new-item -itemtype file -path "c:\ps-test\test.txt", "c:\ps-test\Logs\test.log"このコマンドは、New-Item コマンドレットを使用して 2 つの異なるディレクトリにファイルを作成します。Path パラメーターは複数の文字列を取るので、複数のアイテムを作成するために使用することができます。
必須パラメーター
新しいアイテムの名前を指定します。
NameまたはPathパラメータ値で新しい項目の名前を指定し、NameまたはPathパラメータ値で新しい項目へのパスを指定することができます。
| タイプを指定します。 | String |
| Position: | 名前付き |
| デフォルト値です。 | なし |
| パイプライン入力を受け付ける。 | True (ByPropertyName) |
| ワイルドカード文字を受け付けます。 | False |
新しい項目の位置へのパスを指定します。ワイルドカードも使用可能です。
新しい項目の名前は、Name パラメータで指定するか、Path パラメータに含めることができます。
| Type: | String |
| Position: | 1 |
| デフォルト値です。 | なし |
| パイプライン入力を受け付ける。 | True (ByPropertyName) |
| ワイルドカード文字を受け付けます。 | False |
オプション パラメータ
コマンドレットの実行前に確認のプロンプトが表示されます。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | 名前付き |
| デフォルト値。 | False |
| パイプラインの入力を受け付けます。 | False |
| ワイルドカード文字を許可する。 | False |
このアクションを実行する権限を持つユーザーアカウントを指定します.デフォルトは現在のユーザー.です.
「User01」や「Domain01User01」などのユーザー名を入力するか、Get-Credentialコマンドレットで生成されたものなど、PSCredentialオブジェクトを入力してください。
このパラメーターは、Windows PowerShellと共にインストールされたプロバイダーではサポートされていません
| Type: | PSCredential |
| Position: | Named |
| Default value: | なし |
| パイプライン入力を受け付ける。 | True (ByPropertyName) |
| ワイルドカード文字を受け付けます。 | False |
既存の読み取り専用項目の上に書き込む項目を作成できるようにします。実装はプロバイダによって異なります。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | なし |
| パイプライン入力を受け付ける。 | False |
| ワイルドカード文字を許可する。 | False |
Includes the command in active transaction.This parameter is valid only when a transaction is in progress.For more information, see
| Type.Includes the command in active transaction.See this parameter is only valid when an transaction is in progress.For more information, see [トランザクションの実行中にコマンドが有効です]: | SwitchParameter |
| Aliases: | usetx |
| Position: | Named |
| Default value: | False |
| パイプラインの入力を受け付けます。 | False |
| ワイルドカード文字を許可する。 | False |
New Itemの値を指定します。New-Itemにパイプで値を指定することもできます。
| Type: | Object |
| Position: | Named |
| Default value: | なし |
| パイプライン入力を受け付ける。 | True (ByPropertyName, ByValue) |
| ワイルドカード文字を受け付けます。 | False |
コマンドレットを実行すると何が起こるか表示します。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| パイプラインの入力を受け付けます。 | False |
| ワイルドカード文字を許可する。 | False |
Inputs
System.Object
New-Item コマンドレットに新しい項目の値をパイプすることが可能です。
出力
System.Object
New-Itemは、作成したアイテムを返します。
注意事項
New-Item コマンドレットは、任意のプロバイダーによって公開されたデータで動作するように設計されています。セッションで利用できるプロバイダーの一覧を表示するには、「Get-PsProvider」と入力してください。詳細については、about_Providersを参照してください。
- Clear-Item
- Copy-Item
- Get-Item
- Invoke-Item
- Move-Item
- Remove-Item
- Rename-Item
- Set-Item
- about_Providers
について