Share via


Add-AzureRmADGroupMember

Fügt einen Benutzer zu einer vorhandenen AD-Gruppe hinzu.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

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

Beschreibung

Fügt einen Benutzer zu einer vorhandenen AD-Gruppe hinzu.

Beispiele

Beispiel 1: Hinzufügen eines Benutzers zu einer Gruppe nach Objekt-ID

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

Fügt den Benutzer mit der Objekt-ID "D9076BBC-D62C-4105-9C78-A7F5BC4A3405" zur Gruppe mit der Objekt-ID "85F89C90-780E-4AA6-9F4F-6F268D322EEEE" hinzu.

Beispiel 2 : Hinzufügen eines Benutzers zu einer Gruppe durch Piping

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

Ruft die Gruppe mit der Objekt-ID "85F89C90-780E-4AA6-9F4F-6F268D322EEEE" ab und gibt sie an das Add-AzureRmADGroupMember-Cmdlet weiter, um den Benutzer dieser Gruppe hinzuzufügen.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MemberObjectId

Die Objekt-ID des Elements.

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

-MemberUserPrincipalName

Der UPN der Mitglieder, die der Gruppe hinzugefügt werden sollen.

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

-PassThru

Wenn der Befehl erfolgreich war, wird "true" zurückgegeben.

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

-TargetGroupDisplayName

Der Anzeigename der Gruppe, zu der die Mitglieder hinzugefügt werden sollen.

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

-TargetGroupObject

Die Objektdarstellung der Gruppe, der die Member hinzugefügt werden sollen.

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

-TargetGroupObjectId

Die Objekt-ID der Gruppe, zu der die Mitglieder hinzugefügt werden sollen.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

PSADGroup

Parameter: TargetGroupObject (ByValue)

Ausgaben

Boolean