Add-CMSecurityRoleToAdministrativeUser
将安全角色添加到用户或组。
语法
Add-CMSecurityRoleToAdministrativeUser
-AdministrativeUserName <String>
-RoleName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMSecurityRoleToAdministrativeUser
-AdministrativeUser <IResultObject>
-RoleId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMSecurityRoleToAdministrativeUser
-AdministrativeUser <IResultObject>
-RoleName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMSecurityRoleToAdministrativeUser
-AdministrativeUser <IResultObject>
-InputObject <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMSecurityRoleToAdministrativeUser
-AdministrativeUserId <Int32>
-RoleId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMSecurityRoleToAdministrativeUser
-AdministrativeUserId <Int32>
-RoleName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMSecurityRoleToAdministrativeUser
-AdministrativeUserId <Int32>
-InputObject <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMSecurityRoleToAdministrativeUser
-AdministrativeUserName <String>
-RoleId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-CMSecurityRoleToAdministrativeUser
-AdministrativeUserName <String>
-InputObject <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 说明
使用此 cmdlet 将安全角色添加到 Configuration Manager 中的管理用户或管理组。
角色中定义的权限表示可用于每个对象类型的对象类型和操作。 Configuration Manager 提供一些内置安全角色。 还可以创建自定义安全角色。 有关安全角色的详细信息，请参阅 Configuration Manager 中基于角色的管理基础知识。
可以按名称或 ID 指定管理用户或组，也可以使用 Get-CMAdministrativeUser cmdlet 获取用户或组对象。 Configuration Manager 中的 管理用户 定义本地或域用户或组。 可以指定要按名称或 ID 添加的角色，也可以使用 Get-CMSecurityRole cmdlet 获取角色。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。
示例
示例 1：向域用户组添加自定义安全角色
此命令为域组 Western Administrators 添加自定义安全角色 SecurityRole17。 此命令假定已创建自定义安全角色和管理用户。
Add-CMSecurityRoleToAdministrativeUser -AdministrativeUserName "Contoso\Western Administrators " -RoleName "SecurityRole17"参数
-AdministrativeUser
指定要配置的管理用户对象。 若要获取此对象，请使用 Get-CMAdministrativeUser cmdlet。
| 类型: | IResultObject |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-AdministrativeUserId
指定要配置的管理用户的 ID。 此值是 AdminID 属性，它是一个整数值。 例如，16777234。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-AdministrativeUserName
指定要配置的管理用户的名称。
可以使用通配符：
-
*：多个字符 -
?：单个字符
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
| 类型: | SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | False |
| 必需: | 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 |
| 别名: | Role |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-RoleId
指定要添加的安全角色的 ID。 此值是 RoleID 属性，例如 SMS000AROS 部署管理器 角色。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-RoleName
指定要添加的安全角色的名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
System.Object