New-CMAdministrativeUser
创建管理用户。
语法
New-CMAdministrativeUser
[-CollectionName <String[]>]
-Name <String>
-RoleName <String[]>
[-SecurityScopeName <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMAdministrativeUser
-Name <String>
-Permission <IResultObject[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 说明
使用此 cmdlet 为 Configuration Manager 创建管理用户。 Configuration Manager 中的 管理用户 定义本地或域用户或组。 在 Configuration Manager 中创建管理用户时，可以授予其访问安全角色、安全作用域和集合的权限。 有关安全角色的详细信息，请参阅 Configuration Manager 中基于角色的管理基础知识。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。
示例
示例 1：添加管理用户
此命令将名为 AdminUser1 的 Contoso 域用户添加为管理用户。 它将此用户添加到 应用程序管理员 和 软件更新管理器 内置安全角色。 该命令还将用户添加到 scope1 和 scope2 安全作用域，以及 userCollection1 和 deviceCollection1 集合。
$name = "Contoso\AdminUser1"
$roles = "Application Administrator","Software Update Manager"
$scopes = "scope1","scope2"
$colls = "userCollection1","deviceCollection1"
New-CMAdministrativeUser -Name $name -RoleName $roles -SecurityScopeName $scopes -CollectionName $colls示例 2：添加域组
本示例将 Contoso 域组 “安全分析师 ”添加到内置的 “只读分析师 ”安全角色。
New-CMAdministrativeUser -Name "Contoso\Security Analysts" -RoleName "Read-only Analyst"参数
-CollectionName
指定集合名称的数组。 cmdlet 将新的管理用户分配给其中每个集合。
| 类型: | String[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | 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 |
-Name
指定要添加的管理用户的名称。 使用 格式 domain\name，其中 name 是用户或组。
| 类型: | String |
| 别名: | LogonName |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Permission
指定要分配给此新用户的权限对象的数组。 若要获取这些对象，请使用 New-CMAdministrativeUserPermission cmdlet。
| 类型: | IResultObject[] |
| 别名: | Permissions |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-RoleName
指定安全角色名称数组。 此名称可以是内置角色或自定义角色。 若要查看内置安全角色的列表，请参阅 安全角色。
| 类型: | String[] |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-SecurityScopeName
指定安全范围名称的数组。 安全范围名称可以是“默认”或自定义安全作用域的名称。 cmdlet 将指定的安全作用域分配给管理用户。
| 类型: | String[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
None
输出
IResultObject
备注
有关此返回对象及其属性的详细信息，请参阅 SMS_Admin服务器 WMI 类。