Set-EntraAdministrativeUnit

Modul:
Microsoft.Entra.DirectoryManagement Module v1.3

Aktualisiert die Eigenschaften einer verwaltungstechnischen Einheit.

Syntax

Default (Standard) 

Set-EntraAdministrativeUnit

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

Beschreibung

Das Set-EntraAdministrativeUnit Cmdlet aktualisiert die Eigenschaften einer administrativen Einheit in Microsoft Entra ID. Geben Sie AdministrativeUnitId den Parameter an, um eine bestimmte administrative Einheit zu aktualisieren.

In delegierten Szenarien muss dem angemeldeten Benutzer eine unterstützte Microsoft Entra Rolle oder eine benutzerdefinierte Rolle mit der microsoft.directory/administrativeUnits/allProperties/allTasks Berechtigung zugewiesen werden.

Für diesen Vorgang werden die folgenden Rollen mit den geringsten Rechten unterstützt:

  • Administrator für privilegierte Rollen

Beispiele

Beispiel 1: Aktualisieren von DisplayName und Beschreibung

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'

Mit diesem Befehl wird der Anzeigename einer bestimmten administrativen Einheit aktualisiert.

  • -AdministrativeUnitId der Parameter gibt die ID einer administrativen Einheit an.
  • -DisplayName der Parameter gibt den Anzeigenamen für die administrative Einheit an.
  • -Description der Parameter gibt die Beschreibung für die administrative Einheit an.

Parameter

-AdministrativeUnitId

Gibt die ID einer administrativen Einheit in Microsoft Entra ID an.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Objekt-ID

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Description

Gibt eine Beschreibung für die Administrative Einheit an.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DisplayName

Gibt einen Anzeigenamen für die administrative Einheit an.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-MembershipRule

Gibt die dynamische Mitgliedschaftsregel an, die auf die administrative Einheit angewendet wird. Die möglichen Werte sind: dynamic, assigned. Wenn nicht festgelegt, ist null der Standardwert und das Standardverhalten .assigned Dieser Parameter ist optional.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-MembershipRuleProcessingState

Steuert, ob die Dynamische Mitgliedschaftsregel aktiv ist. Legen Sie diese Einstellung fest, On um updates zu aktivieren oder Paused zu beenden. Dieser Parameter ist optional.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-MembershipType

Gibt den Mitgliedschaftstyp der administrativen Einheit an. Mögliche Werte sind: dynamic und assigned. Wenn nicht festgelegt, lautet nullder Standardwert , und der Mitgliedschaftstyp ist standardmäßig auf assigned. Dieser Parameter ist optional.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Visibility

Gibt die Sichtbarkeit der administrativen Einheit an. Wenn nicht festgelegt, wird public standardmäßig festgelegt. Legen Sie diesen Fest, HiddenMembership um die Mitgliedschaft von Nicht-Mitgliedern auszublenden. Dieser Parameter ist optional.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.