Compartir a través de


Add-AzureRmADGroupMember

Agrega un usuario a un grupo de AD existente.

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Syntax

Add-AzureRmADGroupMember
   -MemberObjectId <Guid[]>
   -TargetGroupObjectId <Guid>
   [-PassThru]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-AzureRmADGroupMember
   -MemberObjectId <Guid[]>
   -TargetGroupDisplayName <String>
   [-PassThru]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-AzureRmADGroupMember
   -MemberObjectId <Guid[]>
   -TargetGroupObject <PSADGroup>
   [-PassThru]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-AzureRmADGroupMember
   -MemberUserPrincipalName <String[]>
   -TargetGroupDisplayName <String>
   [-PassThru]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-AzureRmADGroupMember
   -MemberUserPrincipalName <String[]>
   -TargetGroupObject <PSADGroup>
   [-PassThru]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-AzureRmADGroupMember
   -MemberUserPrincipalName <String[]>
   -TargetGroupObjectId <Guid>
   [-PassThru]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Agrega un usuario a un grupo de AD existente.

Ejemplos

Ejemplo 1: Agregar un usuario a un grupo por identificador de objeto

PS C:\> Add-AzureRmADGroupMember -MemberObjectId D9076BBC-D62C-4105-9C78-A7F5BC4A3405 -TargetGroupObjectId 85F89C90-780E-4AA6-9F4F-6F268D322EEE

Agrega el usuario con el identificador de objeto "D9076BBC-D62C-4105-9C78-A7F5BC4A3405" al grupo con el identificador de objeto '85F89C90-780E-4AA6-9F4F-6F268D322EEE'.

Ejemplo 2: Adición de un usuario a un grupo mediante canalización

PS C:\> Get-AzureRmADGroup -ObjectId 85F89C90-780E-4AA6-9F4F-6F268D322EEE | Add-AzureRmADGroupMember -MemberObjectId D9076BBC-D62C-4105-9C78-A7F5BC4A3405

Obtiene el grupo con el identificador de objeto '85F89C90-780E-4AA6-9F4F-6F268D322EEE' y lo canaliza al cmdlet Add-AzureRmADGroupMember para agregar el usuario a ese grupo.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-MemberObjectId

Identificador de objeto del miembro.

Tipo:Guid[]
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:False
Accept wildcard characters:False

-MemberUserPrincipalName

UpN de los miembros que se van a agregar al grupo.

Tipo:String[]
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Si se especifica esto, se devolverá true si el comando se realizó correctamente.

Tipo:SwitchParameter
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetGroupDisplayName

Nombre para mostrar del grupo al que se van a agregar los miembros.

Tipo:String
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:False
Accept wildcard characters:False

-TargetGroupObject

Representación de objeto del grupo al que se van a agregar los miembros.

Tipo:PSADGroup
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-TargetGroupObjectId

Identificador de objeto del grupo al que se van a agregar los miembros.

Tipo:Guid
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

PSADGroup

Parámetros: TargetGroupObject (ByValue)

Salidas

Boolean