Set-EntraAdministrativeUnit

Module:
Microsoft.Entra.DirectoryManagement Module v1.3

Hiermee worden de eigenschappen van een beheereenheid bijgewerkt.

Syntax

Default (Standaard) 

Set-EntraAdministrativeUnit

    -AdministrativeUnitId <String>
    [-Description <String>]
    [-DisplayName <String>]
    [-MembershipType <String>]
    [-MembershipRule <String>]
    [-MembershipRuleProcessingState <String>]
    [-Visibility <String>]
    [<CommonParameters>]

Description

De Set-EntraAdministrativeUnit cmdlet werkt de eigenschappen van een beheereenheid bij in Microsoft Entra ID. Geef AdministrativeUnitId de parameter op om een specifieke beheereenheid bij te werken.

In gedelegeerde scenario's moet aan de aangemelde gebruiker een ondersteunde Microsoft Entra rol of een aangepaste rol met de microsoft.directory/administrativeUnits/allProperties/allTasks machtiging worden toegewezen.

De volgende rollen met minimale bevoegdheden worden ondersteund voor deze bewerking:

  • Bevoorrechte Rollenbeheerder

Voorbeelden

Voorbeeld 1: DisplayName en beschrijving bijwerken

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$administrativeUnit = Get-EntraAdministrativeUnit -Filter "DisplayName eq 'Pacific Administrative Unit'"
Set-EntraAdministrativeUnit -AdministrativeUnitId $administrativeUnit.Id -DisplayName 'Pacific Admin Unit' -Description 'Pacific Admin Unit Description' -MembershipType 'Assigned'

Met deze opdracht wordt DisplayName van specifieke beheereenheid bijgewerkt.

  • -AdministrativeUnitId parameter geeft de id van een beheereenheid.
  • -DisplayName parameter geeft de weergavenaam voor de beheereenheid.
  • -Description parameter geeft de beschrijving voor de beheereenheid.

Parameters

-AdministrativeUnitId

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

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

-Description

Hiermee geeft u een beschrijving voor de beheereenheid.

Parametereigenschappen

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

Parametersets

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

-DisplayName

Hiermee geeft u een weergavenaam voor de beheereenheid.

Parametereigenschappen

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

Parametersets

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

-MembershipRule

Hiermee geeft u de dynamische lidmaatschapsregel die wordt toegepast op de beheereenheid. De mogelijke waarden zijn: dynamic, assigned. Als deze niet is ingesteld, is null de standaardwaarde en het standaardgedrag.assigned Deze parameter is optioneel.

Parametereigenschappen

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

Parametersets

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

-MembershipRuleProcessingState

Hiermee bepaalt u of de dynamische lidmaatschapsregel actief is. Ingesteld om On deze in te schakelen of Paused updates te stoppen. Deze parameter is optioneel.

Parametereigenschappen

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

Parametersets

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

-MembershipType

Hiermee geeft u het lidmaatschapstype van de beheereenheid. Mogelijke waarden zijn: dynamic en assigned. Als dit niet is ingesteld, is nullde standaardwaarde , en het lidmaatschapstype wordt standaard ingesteld assignedop . Deze parameter is optioneel.

Parametereigenschappen

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

Parametersets

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

-Visibility

Hiermee geeft u de zichtbaarheid van de beheereenheid. Wordt standaard op public ingesteld als niet anders ingesteld. Ingesteld op HiddenMembership het verbergen van lidmaatschap van niet-leden. Deze parameter is optioneel.

Parametereigenschappen

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

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
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.