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>]

说明

cmdlet New-Item 创建一个新项并设置其值。 可创建的项类型取决于项的位置。 例如，在文件系统中， New-Item 创建文件和文件夹。 在注册表中， New-Item 创建注册表项和条目。

New-Item 还可以设置它所创建的项的值。 例如，当它创建新文件时， New-Item 可以向该文件添加初始内容。

示例

示例 1：在当前目录中Create文件

此命令在当前目录中创建名为“testfile1.txt”的文本文件。 点 ('。 path 参数的值中的 ) 指示当前目录。 Value 参数后面的带引号的文本将作为内容添加到文件中。

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

示例 2：Create目录

此命令在驱动器中创建名为“Logfiles”的 C: 目录。 ItemType 参数指定新项是目录，而不是文件或其他文件系统对象。

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

示例 3：Create配置文件

此命令在 变量指定的 $profile 路径中创建 PowerShell 配置文件。

可以使用配置文件自定义 PowerShell。 $profile 是一个自动 (内置) 变量，用于存储“CurrentUser/CurrentHost”配置文件的路径和文件名。 默认情况下，即使 PowerShell 存储其路径和文件名，配置文件也不存在。

在此命令中 $profile ， 变量表示文件的路径。 ItemType 参数指定命令创建文件。 Force 参数允许在配置文件路径中创建文件，即使路径中的目录不存在也是如此。

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

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

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

注意

使用此方法创建文件时，生成的文件将编码为 UTF-8，没有字节顺序标记 (BOM) 。

示例 4：Create不同目录中的目录

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

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

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

示例 5：Create多个文件

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

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

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-Credential

注意

随 PowerShell 一起安装的任何提供程序都不支持此参数。 若要在运行此 cmdlet 时模拟其他用户或提升凭据，请使用 Invoke-Command。

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

-Force

强制此 cmdlet 创建对现有只读项进行写入的项。 不同提供程序有不同的实现。 有关详细信息，请参阅 about_Providers。 即使使用 Force 参数，cmdlet 也无法替代安全限制。

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

-ItemType

指定提供程序指定的新项的类型。 此参数的可用值取决于所使用的当前提供程序。

如果你的位置在驱动器中 FileSystem ，则允许使用以下值：

  • 文件
  • Directory
  • SymbolicLink
  • 交接点
  • HardLink

使用此方法创建文件时，生成的文件将编码为 UTF-8，没有字节顺序标记 (BOM) 。

在驱动器中 Certificate ，可以指定以下值：

  • Certificate 提供程序
  • 证书
  • 存储
  • StoreLocation

有关详细信息，请参阅 about_Providers。

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

-Name

指定新项的名称。

可以在 Name 或 Path 参数值中指定新项的名称，也可以在 Name 或 Path 值中指定新项的路径。

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

-Path

指定新项的位置的路径。 允许使用通配符。

可以在“ 名称”中指定新项的名称，或将其包含在 “路径”中。

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

-UseTransaction

在活动事务中使用该命令。 仅当正在执行事务时，此参数才有效。 有关详细信息，请参阅 about_Transactions。

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

-Value

指定新项的值。 还可以通过管道将值传递给 New-Item。

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

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 此 cmdlet 未运行。

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

输入

Object

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

输出

Object

此 cmdlet 返回它创建的项。

备注

New-Item 旨在处理由任何提供程序公开的数据。 若要列出会话中可用的提供程序，请键入 Get-PsProvider。 有关详细信息，请参阅 about_Providers。