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 cmdlet 将创建新项并设置其值。 可以创建的项的类型取决于项的位置。 例如，在文件系统中，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 参数允许在配置文件路径中创建文件，即使路径中的目录不存在也是如此。

创建配置文件后，可以在配置文件中输入别名、函数和脚本来自定义 shell。

有关详细信息，请参阅 about_Automatic_Variables 和 about_Profiles。

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

此示例在“C：\PS-Test”目录中创建新的脚本目录。

新目录项“Scripts”的名称包含在 Path 参数的值中，而不是在 Name的值中指定。 如语法所示，任一命令形式都有效。

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

此示例在两个不同的目录中创建文件。 由于 Path 需要多个字符串，因此可以使用它来创建多个项。

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

New-Item cmdlet 支持 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 cmdlet 显示 C:\Temp 目录下的三个目录。 使用通配符，New-Item cmdlet 会在当前目录下的所有目录中创建 temp.txt 文件。 New-Item cmdlet 输出所创建的项，这些项通过管道传递给 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

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

可以将新项的值通过管道传递给此 cmdlet。

该 cmdlet 在创建新环境变量时返回 DictionaryEntry 对象。

该 cmdlet 在文件系统中创建新目录时返回 DirectoryInfo 对象。

该 cmdlet 在文件系统中创建新文件时返回 FileInfo 对象。

该 cmdlet 在创建新别名时返回 AliasInfo 对象。

该 cmdlet 在创建新函数时返回 FunctionInfo 对象。

该 cmdlet 在创建新变量时返回 PSVariable 对象。

PowerShell 包含以下与 New-Item相关的别名：

• 所有平台：
  • ni

New-Item 被设计用于处理任何供应商公开的数据。 若要列出会话中可用的提供程序，请键入 Get-PSProvider。 有关详细信息，请参阅 about_Providers。