New-CMAdministrativeUser

  • Referência
Módulo:
ConfigurationManager

Crie um usuário administrativo.

Syntax

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>]

Description

Use este cmdlet para criar um usuário administrativo para Configuration Manager. Um usuário administrativo no Configuration Manager define um usuário ou grupo local ou de domínio. Ao criar o usuário administrativo no Configuration Manager, você pode dar a ele acesso a funções de segurança, escopos de segurança e coleções. Para obter mais informações sobre funções de segurança, consulte Fundamentos da administração baseada em função em Configuration Manager.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: Adicionar um usuário administrativo

Esse comando adiciona o usuário de domínio contoso chamado AdminUser1 como um usuário administrativo. Ele adiciona esse usuário às funções de segurança internas do Administrador de Aplicativos e do Gerenciador de Atualizações de Software . O comando também adiciona o usuário aos escopos de segurança scope1 e scope2 e às coleções userCollection1 e 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

Exemplo 2: Adicionar um grupo de domínio

Este exemplo adiciona os Analistas de Segurança do grupo de domínio Contoso à função interna de segurança de analista somente leitura.

New-CMAdministrativeUser -Name "Contoso\Security Analysts" -RoleName "Read-only Analyst"

Parâmetros

-CollectionName

Especifique uma matriz de nomes de coleção. O cmdlet atribui o novo usuário administrativo a cada uma dessas coleções.

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

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

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

-Name

Especifique o nome do usuário administrativo a ser adicionado. Use o formato domain\name, em que name é o usuário ou o grupo.

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

-Permission

Especifique uma matriz de objetos de permissões a serem atribuídos a este novo usuário. Para obter esses objetos, use o cmdlet New-CMAdministrativeUserPermission .

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

-RoleName

Especifique uma matriz de nomes de função de segurança. Esse nome pode ser para uma função interna ou personalizada. Para ver a lista de funções de segurança internas, confira funções de segurança.

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

-SecurityScopeName

Especifique uma matriz de nomes de escopo de segurança. Um nome de escopo de segurança pode ser "Padrão" ou o nome de um escopo de segurança personalizado. O cmdlet atribui os escopos de segurança que você especifica ao usuário administrativo.

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

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

None

Saídas

IResultObject

Observações

Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_Admin classe WMI do servidor.