New-Item

モジュール:

Microsoft.PowerShell.Management

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

構文

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

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

New-Item
   [-Path] <string[]>
   -ConnectionURI <uri>
   [-ItemType <string>]
   [-Value <Object>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-OptionSet <hashtable>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <string>]
   [-SessionOption <SessionOption>]
   [-Port <int>]
   [<CommonParameters>]

New-Item
   [[-Path] <string[]>]
   -Name <string>
   [-ItemType <string>]
   [-Value <Object>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-OptionSet <hashtable>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <string>]
   [-SessionOption <SessionOption>]
   [-ApplicationName <string>]
   [-Port <int>]
   [-UseSSL]
   [<CommonParameters>]

New-Item
   [-Path] <string[]>
   [-ItemType <string>]
   [-Value <Object>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-Options <ScopedItemOptions>]
   [<CommonParameters>]

New-Item
   [[-Path] <string[]>]
   -Name <string>
   [-ItemType <string>]
   [-Value <Object>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-Options <ScopedItemOptions>]
   [<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: ディレクトリを作成する

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

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

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

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

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

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

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

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

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

例 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"

例 6: ワイルドカードを使用して複数のディレクトリにファイルを作成する

コマンドレットでは New-Item 、 Path パラメーターでワイルドカードがサポートされています。 次のコマンドは、temp.txtPath パラメーターのワイルドカードで指定されたすべてのディレクトリにファイルを作成します。

Get-ChildItem -Path C:\Temp\

Directory:  C:\Temp

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
d-----        5/15/2019   6:45 AM        1   One
d-----        5/15/2019   6:45 AM        1   Two
d-----        5/15/2019   6:45 AM        1   Three

New-Item -Path C:\Temp\* -Name temp.txt -ItemType File | Select-Object FullName

FullName
--------
C:\Temp\One\temp.txt
C:\Temp\Three\temp.txt
C:\Temp\Two\temp.txt

コマンドレットは Get-ChildItem 、ディレクトリの下に 3 つのディレクトリを C:\Temp 表示します。 ワイルドカードを使用すると、 New-Item コマンドレットは temp.txt 現在のディレクトリの下にあるすべてのディレクトリにファイルを作成します。 コマンドレットは New-Item 、新しく作成したファイルのパスを確認するためにパイプされた、作成した Select-Object 項目を出力します。

例 7: ファイルまたはフォルダーへのシンボリック リンクを作成する

次の使用例は、現在のフォルダー内のNotice.txt ファイルへのシンボリック リンクを作成します。

$link = New-Item -ItemType SymbolicLink -Path .\link -Target .\Notice.txt
$link | Select-Object LinkType, Target

LinkType     Target
--------     ------
SymbolicLink {.\Notice.txt}

この例では、 Target は Value パラメーターのエイリアスです。 シンボリック リンクのターゲットは、相対パスにすることができます。 PowerShell v6.2 より前のバージョンでは、ターゲットは完全修飾パスである必要があります。

PowerShell 7.1 以降では、相対パスを使用して Windows 上のフォルダーへの シンボリック リンク を作成できるようになりました。

例 8: -Force パラメーターを使用してフォルダーを再作成する

次の使用例は、ファイルを含むフォルダーを作成します。 次に、 を使用して同じフォルダーの作成を -Force試みます。 フォルダーは上書きされませんが、作成されたファイルをそのまま使用して既存のフォルダー オブジェクトを返すだけです。

PS> New-Item -Path .\TestFolder -ItemType Directory
PS> New-Item -Path .\TestFolder\TestFile.txt -ItemType File

PS> New-Item -Path .\TestFolder -ItemType Directory -Force

    Directory: C:\
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         5/1/2020   8:03 AM                TestFolder

PS> Get-ChildItem .\TestFolder\

    Directory: C:\TestFolder
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         5/1/2020   8:03 AM              0 TestFile.txt

例 9: -Force パラメーターを使用して既存のファイルを上書きする

この例では、 値を持つファイルを作成し、 を使用して -Forceファイルを再作成します。 これにより、既存のファイルが上書きされ、length プロパティで確認できるようにコンテンツが失われます

PS> New-Item ./TestFile.txt -ItemType File -Value 'This is just a test file'

    Directory: C:\Source\Test
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         5/1/2020   8:32 AM             24 TestFile.txt

New-Item ./TestFile.txt -ItemType File -Force

    Directory: C:\Source\Test
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         5/1/2020   8:32 AM              0 TestFile.txt

注意

スイッチで を-Force使用New-Itemしてレジストリ キーを作成する場合、コマンドはファイルを上書きする場合と同じように動作します。 レジストリ キーが既に存在する場合、キーとすべてのプロパティと値は空のレジストリ キーで上書きされます。

パラメーター

-ApplicationName

これは、 WSMan プロバイダーによって使用できる動的パラメーターです。 WSMan プロバイダーとこのパラメーターは、Windows でのみ使用できます。

接続のアプリケーション名を指定します。 ApplicationName パラメーターの既定値は WSMAN です。

詳細については、「 New-WSManInstance」を参照してください。

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

-Authentication

これは、 WSMan プロバイダーによって使用できる動的パラメーターです。 WSMan プロバイダーとこのパラメーターは、Windows でのみ使用できます。

サーバーで使用される認証メカニズムを指定します。

詳細については、「 New-WSManInstance」を参照してください。

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

-CertificateThumbprint

これは、 WSMan プロバイダーによって使用できる動的パラメーターです。 WSMan プロバイダーとこのパラメーターは、Windows でのみ使用できます。

この WSMan アクションを実行するアクセス許可を持つユーザー アカウントのデジタル公開キー証明書 (X509) を指定します。 証明書の拇印を入力します。

詳細については、「 New-WSManInstance」を参照してください。

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

-Confirm

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

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

-ConnectionURI

これは、 WSMan プロバイダーによって使用できる動的パラメーターです。 WSMan プロバイダーとこのパラメーターは、Windows でのみ使用できます。

WSMan の接続エンドポイントを指定します。

詳細については、「 New-WSManInstance」を参照してください。

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

-Credential

注意

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

Type:	PSCredential
Position:	Named
Default value:	Current user
Accept pipeline input:	True
Accept wildcard characters:	False

-Force

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

Force を使用して既存のジャンクションを上書きすることはできません。 既存のジャンクションを上書きしようとすると、"空ではないので削除できません" というエラーで失敗します。 新しいジャンクションを作成する前に、既存のジャンクションを削除する必要があります。

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

-ItemType

プロバイダーによって指定された新しい項目の種類を指定します。 このパラメーターの使用可能な値は、使用している現在のプロバイダーによって異なります。

場所がドライブ内にある FileSystem 場合は、次の値が許可されます。

• ファイル
• ディレクトリ
• SymbolicLink
• ジャンクション
• ハードリンク

注意

Windows で型を SymbolicLink 作成するには、管理者としての昇格が必要です。 ただし、開発者モードが有効になっているWindows 10 (ビルド 14972 以降) では、シンボリック リンクを作成する昇格は不要になりました。

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

• 証明書プロバイダー
• Certificate
• ストア
• StoreLocation

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

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

-Name

新しい項目の名前を指定します。 Name パラメーターまたは Path パラメーター値で新しい項目の名前を指定でき、[名前] または [パス] の値で新しい項目のパスを指定できます。 Name パラメーターを使用して渡された項目名は、Path パラメーターの値を基準にして作成されます。

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

-Options

これは、 Alias プロバイダーが使用できる動的パラメーターです。 詳細については、「 New-Alias」を参照してください。

エイリアスの Options プロパティの値を指定します。

有効な値は次のとおりです。

• None: エイリアスに制約はありません (既定値)
• ReadOnly: エイリアスは削除できますが、 Force パラメーターを使用しないと変更できません
• Constant: エイリアスを削除または変更することはできません
• Private: エイリアスは現在のスコープでのみ使用できます
• AllScope: エイリアスは、作成された新しいスコープにコピーされます
• Unspecified: オプションが指定されていません

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

-OptionSet

これは、 WSMan プロバイダーが使用できる動的パラメーターです。 WSMan プロバイダーとこのパラメーターは、Windows でのみ使用できます。

要求のオプションを変更または調整する一連のスイッチをサービスに渡します。

詳細については、「 New-WSManInstance」を参照してください。

Type:	Hashtable
Aliases:	OS
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Path

新しい項目の場所のパスを指定します。 既定値は、 Path を省略した場合の現在の場所です。 [名前] で新しい項目の名前を指定するか、[パス] に含めることができます。 Name パラメーターを使用して渡された項目名は、Path パラメーターの値を基準にして作成されます。

このコマンドレットの Path パラメーターは、他のコマンドレットの LiteralPath パラメーターと同様に機能します。 ワイルドカード文字は解釈されません。 すべての文字が場所のプロバイダーに渡されます。 プロバイダーは、すべての文字をサポートしていない場合があります。 たとえば、アスタリスク (*) 文字を含むファイル名を作成することはできません。

Type:	String[]
Position:	0
Default value:	Current location
Accept pipeline input:	True
Accept wildcard characters:	False

-Port

これは、 WSMan プロバイダーが使用できる動的パラメーターです。 WSMan プロバイダーとこのパラメーターは、Windows でのみ使用できます。

クライアントが WinRM サービスに接続するときに使用するポートを指定します。

詳細については、「 New-WSManInstance」を参照してください。

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

-SessionOption

これは、 WSMan プロバイダーが使用できる動的パラメーターです。 WSMan プロバイダーとこのパラメーターは、Windows でのみ使用できます。

WS-Management セッションの一連の拡張オプションを定義します。

詳細については、「 New-WSManInstance」を参照してください。

Type:	SessionOption
Aliases:	SO
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-UseSSL

これは、 WSMan プロバイダーが使用できる動的パラメーターです。 WSMan プロバイダーとこのパラメーターは、Windows でのみ使用できます。

Secure Sockets Layer (SSL) プロトコルを使用してリモート コンピューターとの接続を確立するように指定します。 既定では、SSL は使用されません。

詳細については、「 New-WSManInstance」を参照してください。

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

-Value

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

Type:	Object
Aliases:	Target
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

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

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

入力

Object

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

出力

Object

このコマンドレットは、作成した項目を返します。

メモ

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

• すべてのプラットフォーム:
  • ni

New-Item は、任意のプロバイダーによって公開されるデータを操作するように設計されています。 セッションで使用できるプロバイダーを一覧表示するには、「」と入力します Get-PsProvider。 詳細については、「about_Providers」を参照してください。

関連リンク

• Clear-Item
• Copy-Item
• Get-Item
• Invoke-Item
• Move-Item
• Remove-Item
• Rename-Item
• Set-Item
• about_Providers