Add-CMSecurityRoleToAdministrativeUser

Módulo:

ConfigurationManager

Adicione uma função de segurança a um usuário ou grupo.

Sintaxe

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

Description

Use esse cmdlet para adicionar uma função de segurança a um usuário administrativo ou grupo administrativo em Configuration Manager.

As permissões definidas em uma função representam tipos de objeto e ações disponíveis para cada tipo de objeto. Configuration Manager fornece algumas funções de segurança internas. Você também pode criar funções de segurança personalizadas. Para obter mais informações sobre funções de segurança, consulte Fundamentos da administração baseada em função em Configuration Manager.

Você pode especificar um usuário ou grupo administrativo por nome ou por ID ou pode usar o cmdlet Get-CMAdministrativeUser para obter um objeto de usuário ou grupo. Um usuário administrativo no Configuration Manager define um usuário ou grupo local ou de domínio. Você pode especificar uma função para adicionar por nome ou por ID ou pode usar o cmdlet Get-CMSecurityRole para obter uma função.

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 função de segurança personalizada a um grupo de usuários de domínio

Este comando adiciona a função de segurança personalizada SecurityRole17 para o grupo de domínio Administradores Ocidentais. Esse comando pressupõe que você já tenha criado a função de segurança personalizada e o usuário administrativo.

Add-CMSecurityRoleToAdministrativeUser -AdministrativeUserName "Contoso\Western Administrators " -RoleName "SecurityRole17"

Parâmetros

-AdministrativeUser

Especifique um objeto de usuário administrativo a ser configurado. Para obter esse objeto, use o cmdlet Get-CMAdministrativeUser .

Tipo:	IResultObject
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-AdministrativeUserId

Especifique a ID do usuário administrativo a ser configurado. Esse valor é a AdminID propriedade, que é um valor inteiro. Por exemplo, 16777234.

Tipo:	Int32
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-AdministrativeUserName

Especifique o nome do usuário administrativo a ser configurado.

Você pode usar caracteres curinga:

• *: vários caracteres
• ?: caractere único

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Confirm

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

Tipo:	SwitchParameter
Aliases:	cf
Cargo:	Named
Valor padrão:	False
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DisableWildcardHandling

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

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	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.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-InputObject

Especifique um objeto de função de segurança a ser adicionado. Para obter esse objeto, use o cmdlet Get-CMSecurityRole .

Tipo:	IResultObject
Aliases:	Role
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-RoleId

Especifique a ID da função de segurança a ser adicionada. Esse valor é a RoleID propriedade, por exemplo SMS000AR , para a função gerenciador de implantação do sistema operacional .

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RoleName

Especifique o nome da função de segurança a ser adicionada.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-WhatIf

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

Tipo:	SwitchParameter
Aliases:	wi
Cargo:	Named
Valor padrão:	False
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object

Links Relacionados

• Remove-CMSecurityRoleFromAdministrativeUser
• Add-CMSecurityScopeToAdministrativeUser
• Get-CMAdministrativeUser
• Get-CMSecurityRole
• Automatizar a administração baseada em função com Windows PowerShell