如下说明是翻译
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