New-Item

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 ファイルに初期コンテンツを追加できます。

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

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

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

New-Item -Path "C:\" -Name "Logfiles" -ItemType "Directory"

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

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

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

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

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

New-Item -Path $PROFILE -ItemType "File" -Force

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

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

New-Item -ItemType "Directory" -Path "C:\ps-test\scripts"

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

New-Item -ItemType "File" -Path "C:\ps-test\test.txt", "C:\ps-test\Logs\test.log"

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

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

次の使用例は、現在のフォルダー内の 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 上のフォルダーに SymbolicLink を作成できるようになりました。

次の使用例は、ファイルを含むフォルダーを作成します。 次に、-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

次の使用例は、値を含むファイルを作成し、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

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

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

コマンドレットは、新しい環境変数を作成するときに、DictionaryEntry オブジェクトを返します。

このコマンドレットは、ファイルシステムで新しいディレクトリを作成するときに、DirectoryInfo オブジェクトを返します。

このコマンドレットは、ファイルシステムで新しいファイルを作成するときに、FileInfo オブジェクトを返します。

このコマンドレットは、新しいエイリアスを作成するときに、AliasInfo オブジェクトを返します。

コマンドレットは、新しい関数を作成するときに、FunctionInfo オブジェクトを返します。

このコマンドレットは、新しい変数を作成するときに、PSVariable オブジェクトを返します。

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

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

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