Add-EntraGroupMember

Modul:
Microsoft.Entra.Groups Module v1.3

Lägg till en medlem i en säkerhets- eller Microsoft 365 grupp.

Syntax

Default (Standard) 

Add-EntraGroupMember

    -GroupId <String>
    -MemberId <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Cmdleten Add-EntraGroupMember lägger till en medlem i en säkerhets- eller Microsoft 365 grupp.

New-EntraGroupMember och Add-EntraGroupMembership är alias för Add-EntraGroupMember.

I delegerade scenarier behöver den inloggade användaren en Microsoft Entra roll som stöds eller en anpassad roll med behörigheten microsoft.directory/groups/members/update . De minsta roller som krävs för den här åtgärden, exklusive rolltilldelningsbara grupper, är:

  • Gruppägare
  • Katalogförfattare
  • Gruppadministratör
  • Användaradministratör

Exempel

Exempel 1: Lägga till en medlem i en grupp

Connect-Entra -Scopes 'GroupMember.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'Contoso Marketing Group'"
$user = Get-EntraUser -UserId 'SawyerM@contoso.com'
Add-EntraGroupMember -GroupId $group.Id -MemberId $user.Id

Det här exemplet visar hur du lägger till en medlem i en grupp.

  • -GroupId – Anger den unika identifieraren (objekt-ID) för den grupp som du vill lägga till en medlem i.
  • -MemberId – Anger den unika identifieraren (objekt-ID) för medlemmen som ska läggas till i gruppen. Du kan lägga till användare, säkerhetsgrupper, Microsoft 365 grupper, enheter, tjänstens huvudnamn och organisationskontakter i säkerhetsgrupper. Endast användare kan läggas till i Microsoft 365 grupper.

Exempel 2: Lägga till medlemmar baserat på sökresultat i en grupp

Connect-Entra -Scopes 'GroupMember.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'Sales and Marketing'"
Get-EntraUser -Filter "startsWith(displayName,'Updated User')" |
    Add-EntraGroupMember -GroupId $group.Id

Det här exemplet visar hur du lägger till medlemmar baserat på ett sökresultat i en grupp.

  • -GroupId – Anger den unika identifieraren (objekt-ID) för den grupp som du vill lägga till en medlem i.

Exempel 3: Synkronisera användare från en grupp till en annan

Connect-Entra -Scopes 'GroupMember.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'Sales and Marketing'"
Get-EntraGroupMember -GroupId "source-group-id" |
    Add-EntraGroupMember -GroupId $group.Id

Det här exemplet visar hur du synkroniserar gruppmedlemmar från källmålgruppen till en ny grupp.

  • -GroupId – Anger den unika identifieraren (objekt-ID) för den grupp som du vill lägga till en medlem i.

Parametrar

-GroupId

Anger ID för en grupp i Microsoft Entra ID.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Objekt-ID

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-MemberId

Anger den unika identifieraren (objekt-ID) för medlemmen som ska läggas till i gruppen. Du kan lägga till användare, säkerhetsgrupper, Microsoft 365 grupper, enheter, tjänstens huvudnamn och organisationskontakter i säkerhetsgrupper. Endast användare kan läggas till i Microsoft 365 grupper.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:RefObjectId

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.