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