New-Item 帮助信息

如下说明是翻译PowerShell中: help New-Item 产生的帮助信息.

译者: Edengundam(马涛)

 

New-Item

 

大纲

在一个名称空间创建一个新项.

 

语法

New-Item [-path] <string[]> [-force] [-credential <PSCredential>] [-itemType <string>] [-value <Object>] [-whatIf] [-confirm] [<CommonParameters>]

 

New-Item [-path] <string[]> -name <string> [-force] [-credential <PSCredential>] [-itemType <string>] [-value <Object>] [-whatIf] [-confirm] [<CommonParameters>]

 

详细描述

在一个名称空间创建一个新项. 创建项的类型取决于使用的Windows PowerShell提供程序. 当使用文件系统提供程序时, New-Item被用来创建文件和文件夹; 当使用注册表提供程序时, New-Item被用来创建新的注册表项. 此cmdlet还能为新项设置值. 例如, 当创建一个新的文件时, 你可以使用New-Item为文件添加初始信息.

 

参数

 

-path <string[]>

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

 

强制参数?	true
参数位置?	1
默认值	String.empty
允许从管道绑定输入?	true (根据属性名)
允许通配符扩展?	false

 

-itemType <string>

指定提供程序支持新项的类型

 

强制参数?	false
参数位置?	named
默认值	String.empty
允许从管道绑定输入?	true (根据属性名)
允许通配符扩展?	false

 

-value <Object>

指定新项的值.

 

强制参数?	false
参数位置?	named
默认值	Null
允许从管道绑定输入?	true (ByValue, 根据属性名)
允许通配符扩展?	false

 

-name <string>

指定新项的名称.

 

强制参数?	true
参数位置?	named
默认值	String.empty
允许从管道绑定输入?	true (根据属性名)
允许通配符扩展?	false

 

-force <SwitchParameter>

在不破坏安全性的前提下, 能够避免影响命令成功执行的限制条件, 例如: 更改已经存在的变量名.

 

强制参数?	false
参数位置?	named
默认值
允许从管道绑定输入?	false
允许通配符扩展?	false

 

-credential <PSCredential>

使用其他凭证进行资源访问认证. 如果指定了一个之前使用Get-Credential获得的PSCredential对象, 将会直接使用该对象. 如果此处使用用户名, 命令执行时会提示输入该用户密码.

 

强制参数?	false
参数位置?	named
默认值
允许从管道绑定输入?	true (根据属性名)
允许通配符扩展?	false

 

-whatIf

描述执行此命令将会发生的现象, 不会真正执行此命令.

 

强制参数?	false
参数位置?	named
默认值
允许从管道绑定输入?	false
允许通配符扩展?	false

 

-confirm

执行命令前提示你进行确认.

 

强制参数?	false
参数位置?	named
默认值
允许从管道绑定输入?	false
允许通配符扩展?	false

 

<公共参数>

此命令支持公共参数: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息, 输入, "get-help about_commonparameters".

 

输入类型

String

 

返回类型

Any

 

例1

 

C:/PS>new-item -path . -name testfile1.txt -type "file" -value "This is a text string."

 

此命令在当前目录创建一个名为testfile1.txt的文本文件. 参数-Path值中的点(.)指定当前目录. 跟在参数-value后面被引号引起来的字符串, 将作为文件内容添加到文件中.

 

例2

 

C:/PS>new-item -path c:/ -name logfiles -lype directory

 

此命令将在C:驱动器中创建创建名为Logfiles的目录. 参数-type指定创建的新项是一个目录, 而不是文件或其他的文件系统对象.

 

例3

 

C:/PS>new-item -path $profile -type file -force

 

下面的命令将会在变量$profile指定的位置创建一个Windows PowerShell配置文件(profile).

 

你可以使用配置文件来个性化Windows PowerShell. $profile是一个自动(内置)变量, 用来存储你的Windows PowerShell配置文件的路径和文件名称. 默认情况下, 配置文件时不存在, 虽然说Windows PowerShell还是保存了对该文件的目录和文件名称信息. (查看变量$profile的值, 输入"$profile". 要查看自动变量的列表, 键入"get-help about_automatic_variables".)

 

这个命令中, 变量$profile表示指向文件的路径. 参数Type (或者InfoType)指定命令创建一个文件(配置文件就是一个文本文件). 参数Force允许你在profile目录中创建一个文件, 即使当路径中某个目录不存在, 此命令也会执行成功(PowerShell负责创建它们).

 

当你使用此命令创建了配置文件, 你可以在这个配置文件中输入别名, 函数和脚本来个性化你的shell.

 

相关链接

Get-Item

Set-Item

Remove-Item

Clear-Item

Invoke-Item

Rename-Item

Move-Item

Copy-Item

about_namespace