创建新项。

语法

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 目录中创建一个安全条目。






另请参阅




目录