New-CMAdministrativeUser

  • 参考
模块:
ConfigurationManager

创建管理用户。

语法

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 将新的管理用户分配给其中每个集合。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

此参数处理通配符，并可能导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

指定要添加的管理用户的名称。 使用 格式 domain\name，其中 name 是用户或组。

Type:String
Aliases:LogonName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Permission

指定要分配给此新用户的权限对象的数组。 若要获取这些对象，请使用 New-CMAdministrativeUserPermission cmdlet。

Type:IResultObject[]
Aliases:Permissions
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RoleName

指定安全角色名称数组。 此名称可以是内置角色或自定义角色。 若要查看内置安全角色的列表，请参阅 安全角色。

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SecurityScopeName

指定安全范围名称的数组。 安全范围名称可以是“默认”或自定义安全作用域的名称。 cmdlet 将指定的安全作用域分配给管理用户。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

None

输出

IResultObject

备注

有关此返回对象及其属性的详细信息，请参阅 SMS_Admin服务器 WMI 类。