Add-CMSecurityRoleToAdministrativeUser

Módulo:

ConfigurationManager

Agregue un rol de seguridad a un usuario o grupo.

Sintaxis

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 este cmdlet para agregar un rol de seguridad a un usuario administrativo o grupo administrativo en Configuration Manager.

Los permisos definidos en un rol representan los tipos de objeto y las acciones disponibles para cada tipo de objeto. Configuration Manager proporciona algunos roles de seguridad integrados. También puede crear roles de seguridad personalizados. Para obtener más información sobre los roles de seguridad, consulte Aspectos básicos de la administración basada en roles en Configuration Manager.

Puede especificar un usuario o grupo administrativo por nombre o por identificador o puede usar el cmdlet Get-CMAdministrativeUser para obtener un objeto de usuario o grupo. Un usuario administrativo de Configuration Manager define un usuario o grupo local o de dominio. Puede especificar un rol para agregar por nombre o por identificador, o bien puede usar el cmdlet Get-CMSecurityRole para obtener un rol.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Adición de un rol de seguridad personalizado a un grupo de usuarios de dominio

Este comando agrega el rol de seguridad personalizado SecurityRole17 para el grupo de dominios Administradores occidentales. Este comando supone que ya ha creado el rol de seguridad personalizado y el usuario administrativo.

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

Parámetros

-AdministrativeUser

Especifique un objeto de usuario administrativo que se va a configurar. Para obtener este objeto, use el cmdlet Get-CMAdministrativeUser .

Tipo:	IResultObject
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-AdministrativeUserId

Especifique el identificador del usuario administrativo que se va a configurar. Este valor es la AdminID propiedad , que es un valor entero. Por ejemplo, 16777234.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AdministrativeUserName

Especifique el nombre del usuario administrativo que se va a configurar.

Puede usar caracteres comodín:

• *: varios caracteres
• ?: carácter único

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-InputObject

Especifique un objeto de rol de seguridad que se va a agregar. Para obtener este objeto, use el cmdlet Get-CMSecurityRole .

Tipo:	IResultObject
Alias:	Role
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-RoleId

Especifique el identificador del rol de seguridad que se va a agregar. Este valor es la RoleID propiedad , por ejemplo SMS000AR , para el rol administrador de implementación del sistema operativo .

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RoleName

Especifique el nombre del rol de seguridad que se va a agregar.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object

Vínculos relacionados

• Remove-CMSecurityRoleFromAdministrativeUser
• Add-CMSecurityScopeToAdministrativeUser
• Get-CMAdministrativeUser
• Get-CMSecurityRole
• Automatización de la administración basada en roles con Windows PowerShell