Add-EntraAdministrativeUnitMember

Hiermee voegt u een lid van een beheereenheid toe.

Syntax

Default (Standaard)

Add-EntraAdministrativeUnitMember

    -MemberId <String>
    -AdministrativeUnitId <String>
    [<CommonParameters>]

Description

Met de Add-EntraAdministrativeUnitMember cmdlet wordt een lid van een Microsoft Entra ID beheereenheid toegevoegd.

Beheereenheden maken een gedetailleerder beheer van machtigingen en toegang mogelijk, met name in grote organisaties of waar administratieve verantwoordelijkheden zijn verdeeld over afdelingen of regio's.

Voor gedelegeerde scenario's is het toevoegen van een gebruiker, groep of apparaat aan een beheereenheid vereist:

  • Bevoorrechte Rollenbeheerder

Voorbeelden

Voorbeeld 1: Gebruiker toevoegen als lid van een beheereenheid

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$administrativeUnit = Get-EntraAdministrativeUnit -Filter "DisplayName eq '<administrativeunit-display-name>'"
$user = Get-EntraUser -UserId 'SawyerM@contoso.com'
Add-EntraAdministrativeUnitMember -AdministrativeUnitId $administrativeUnit.Id -MemberId $user.Id

In dit voorbeeld ziet u hoe u een lid van een beheereenheid toevoegt. Gebruik Get-EntraAdministrativeUnit dit om de beheereenheid-id te vinden en Get-EntraUser om de gebruikers-id te vinden.

  • AdministrativeUnitId parameter geeft de id van een beheereenheid.
  • MemberId parameter geeft de id op van de gebruiker of groep die u wilt toevoegen als lid van de beheereenheid.

Voorbeeld 2: Een groep toevoegen aan een beheereenheid

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$administrativeUnit = Get-EntraAdministrativeUnit -Filter "DisplayName eq '<administrativeunit-display-name>'"
$group = Get-EntraGroup -SearchString 'Sales and Marketing'
Add-EntraAdministrativeUnitMember -AdministrativeUnitId $administrativeUnit.Id -MemberId $group.Id

In dit voorbeeld ziet u hoe u een lid van een beheereenheid toevoegt. Gebruik Get-EntraAdministrativeUnit dit om de beheereenheid-id te vinden en Get-EntraGroup om de groeps-id te vinden.

  • AdministrativeUnitId parameter geeft de id van een beheereenheid.
  • MemberId parameter geeft de id op van de gebruiker of groep die u wilt toevoegen als lid van de beheereenheid.

Voorbeeld 3: Een apparaat toevoegen aan een beheereenheid

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$administrativeUnit = Get-EntraAdministrativeUnit -Filter "DisplayName eq '<administrativeunit-display-name>'"
$device = Get-EntraDevice -SearchString 'ContosoDesktop01'
Add-EntraAdministrativeUnitMember -AdministrativeUnitId $administrativeUnit.Id -MemberId $device.Id

In dit voorbeeld ziet u hoe u een lid van een beheereenheid toevoegt. Gebruik Get-EntraAdministrativeUnit dit om de beheereenheid-id te vinden en Get-EntraDevice om de apparaat-id te vinden.

  • AdministrativeUnitId parameter geeft de id van een beheereenheid.
  • MemberId parameter geeft de id op van het apparaat dat u wilt toevoegen als lid van de beheereenheid.

Parameters

-AdministrativeUnitId

Hiermee geeft u de id van een Microsoft Entra ID beheereenheid.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:ObjectId

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-MemberId

Hiermee geeft u de unieke id op van het specifieke Microsoft Entra ID-object dat als eigenaar/manager/lid is.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:RefObjectId

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.