New-Item
创建新项。
语法
New-Item [-URI <Uri>] [-SDDL <string>] [-ExactMatch] [-Confirm] [-WhatIf] [<CommonParameters>]
说明
New-Item cmdlet 创建新项并设置该项的值。可创建项的类型取决于该项所在位置。例如,在文件系统中,New-Item 用于创建文件和文件夹。在注册表中,New-Item 用于创建注册表项和注册表条目。
在 Security 目录中,可以使用 New-Item cmdlet 创建和配置插件安全。
参数
-URI <Uri>
标识基于 Sddl 参数的值授权对其访问的 URI。
是否为必需? |
false |
位置? |
named |
默认值 |
|
是否接受管道输入? |
false |
是否接受通配符? |
false |
-SDDL <string>
指定访问控制条目的安全描述符定义语言 (SDDL)。这标识用于
授权对指定的资源 URI 进行访问的安全设置。
是否为必需? |
false |
位置? |
named |
默认值 |
|
是否接受管道输入? |
false |
是否接受通配符? |
false |
-ExactMatch
指定如何使用 Sddl 参数中指定的安全设置。如果 ExactMatch 参数设置为 True,
则 Sddl 中的安全设置仅用于授权严格按照 URI 指定的方式对 URI 进行访问尝试。
如果 ExactMatch 设置为 False,则 Sddl 中的安全设置用于授权对 URI 进行访问尝试,这些 URI 以
URI 中指定的字符串开头。
是否为必需? |
false |
位置? |
named |
默认值 |
|
是否接受管道输入? |
false |
是否接受通配符? |
false |
-Confirm
在执行命令之前提示您进行确认。
是否为必需? |
false |
位置? |
named |
默认值 |
|
是否接受管道输入? |
false |
是否接受通配符? |
false |
-WhatIf
描述如果执行该命令会发生什么情况(无需实际执行该命令)。
是否为必需? |
false |
位置? |
named |
默认值 |
|
是否接受管道输入? |
false |
是否接受通配符? |
false |
<CommonParameters>
此 cmdlet 支持通用参数:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息,请参阅 about_Commonparameters.
输入和输出
输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。
输入 |
System.Object 可以通过管道将新项的值传递给 New-Item cmdlet。 |
输出 |
Any |
说明
New-Item cmdlet 用于处理由任何提供程序公开的数据。要列出会话中可用的提供程序,请键入“Get-PsProvider”。有关详细信息,请参阅 About_Providers。
示例 1
C:\PS>New-Item -path WSMan:\localhost\Plugin\TestPlugin\Resources\Resource_5967683\Security -Sddl "O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;SA;GWGX;;;WD)"
此命令在 Resource_5967683(一个特定资源)的 Security 目录中创建一个安全条目。
另请参阅
概念
about_providers
Get-Item
Set-Item
Remove-Item
Clear-Item
Invoke-Item
Rename-Item
Move-Item
Copy-Item