Copy-CMSecurityRole
创建自定义安全角色。
语法
Copy-CMSecurityRole
[-Description <String>]
-Name <String>
-SourceRoleId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Copy-CMSecurityRole
[-Description <String>]
-Name <String>
-SourceRoleName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Copy-CMSecurityRole
[-Description <String>]
-InputObject <IResultObject>
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 说明
使用此 cmdlet 通过将现有安全角色用作模板来创建新的安全角色。 Configuration Manager 提供了多个内置安全角色。 如果需要其他安全角色，可以通过创建现有安全角色的副本，然后修改副本来创建自定义安全角色。
有关安全角色和权限的详细信息，请参阅 Configuration Manager 中基于角色的管理基础知识。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。
示例
示例 1：使用 ID 复制安全角色
此命令创建名为 SecRole02 的新安全角色。 它复制 ID SMS000CR为 的安全角色，即 软件更新管理员 角色。
Copy-CMSecurityRole -Name "SecRole02" -SourceRoleId "SMS000CR"参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
| 类型: | SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Description
指定安全角色的可选说明。
| 类型: | String |
| 别名: | RoleDescription |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-InputObject
指定要复制的安全角色对象。 若要获取此对象，请使用 Get-CMSecurityRole cmdlet。
| 类型: | IResultObject |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-Name
指定新安全角色的名称。
| 类型: | String |
| 别名: | RoleName |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-SourceRoleId
指定要复制的安全角色的 ID。 此值是 RoleID 属性，例如 SMS000AROS 部署管理器 角色。
| 类型: | String |
| 别名: | CopiedFromId |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-SourceRoleName
指定要复制的安全角色的名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
System.Object