Set-EntraAdministrativeUnit

Module:
Microsoft.Entra.DirectoryManagement Module v1.3

Met à jour les propriétés d’une unité administrative.

Syntaxe

Default (Par défaut) 

Set-EntraAdministrativeUnit

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

Description

L’applet Set-EntraAdministrativeUnit de commande met à jour les propriétés d’une unité administrative dans Microsoft Entra ID. Spécifiez le AdministrativeUnitId paramètre pour mettre à jour une unité administrative spécifique.

Dans les scénarios délégués, l’utilisateur connecté doit recevoir un rôle Microsoft Entra pris en charge ou un rôle personnalisé avec l’autorisationmicrosoft.directory/administrativeUnits/allProperties/allTasks.

Les rôles les moins privilégiés suivants sont pris en charge pour cette opération :

  • Administrateur de rôle privilégié

Exemples

Exemple 1 : Mettre à jour DisplayName et description

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'

Cette commande met à jour DisplayName d’une unité administrative spécifique.

  • -AdministrativeUnitId spécifie l’ID d’une unité administrative.
  • -DisplayName spécifie le nom complet de l’unité administrative.
  • -Description spécifie la description de l’unité administrative.

Paramètres

-AdministrativeUnitId

Spécifie l’ID d’une unité administrative dans Microsoft Entra ID.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Identifiant d'objet (ObjectId)

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Description

Spécifie une description de l’unité administrative.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DisplayName

Spécifie un nom complet pour l’unité administrative.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-MembershipRule

Spécifie la règle d’appartenance dynamique appliquée à l’unité administrative. Les valeurs possibles sont : dynamic, assigned. S’il n’est pas défini, la valeur par défaut est null et le comportement par défaut est assigned. Ce paramètre est facultatif.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-MembershipRuleProcessingState

Contrôle si la règle d’appartenance dynamique est active. Définissez cette On option pour l’activer ou Paused arrêter les mises à jour. Ce paramètre est facultatif.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-MembershipType

Spécifie le type d’appartenance de l’unité administrative. Les valeurs possibles sont : dynamic et assigned. S’il n’est pas défini, la valeur par défaut est null, et le type d’appartenance est assigneddéfini par défaut sur . Ce paramètre est facultatif.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Visibility

Spécifie la visibilité de l’unité administrative. La valeur par défaut est public si elle n’est pas définie. Définissez cette option pour HiddenMembership masquer l’appartenance à des membres non membres. Ce paramètre est facultatif.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.