New-EntraAdministrativeUnit

New-EntraAdministrativeUnit

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

L’applet New-EntraAdministrativeUnit de commande crée une unité administrative dans Microsoft Entra ID. Spécifiez le DisplayName paramètre pour créer une unité administrative.

Dans les scénarios délégués, l’utilisateur connecté doit recevoir un rôle de Microsoft Entra pris en charge ou un rôle personnalisé qui inclut 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é

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
New-EntraAdministrativeUnit -DisplayName 'TestAU'

DeletedDateTime Id                                   Description DisplayName Visibility
--------------- --                                   ----------- ----------- ----------
                bbbbbbbb-1111-2222-3333-cccccccccccc             TestAU

Cet exemple montre comment créer une unité administrative.

• -DisplayName spécifie le nom complet de l’objet Unité administrative.

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
New-EntraAdministrativeUnit -DisplayName 'Pacific Administrative Unit' -Description 'Administrative Unit for Pacific region'

DeletedDateTime Id                                   Description DisplayName IsMemberManagementRestricted Visibility
--------------- --                                   ----------- ----------- ---------------------------- ----------
                bbbbbbbb-1111-2222-3333-cccccccccccc Pacific Administrative Unit     test111     False

Cet exemple montre comment créer une unité administrative.

• -DisplayName spécifie le nom complet de l’objet Unité administrative.
• -Description spécifie une description de l’objet Unité administrative.

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$displayName = 'Seattle District Technical Schools'
$description = 'Seattle district technical schools administration'
$membershipRule = '(user.country -eq "United States")'

New-EntraAdministrativeUnit `
    -DisplayName $displayName `
    -Description $description `
    -MembershipType 'Dynamic' `
    -MembershipRule $membershipRule `
    -MembershipRuleProcessingState 'On' `
    -Visibility 'HiddenMembership'

DeletedDateTime Id                                   Description                                       DisplayName                        Visibility
--------------- --                                   -----------                                       -----------                        ----------
                bbbbbbbb-1111-2222-3333-cccccccccccc Seattle district technical schools administration Seattle District Technical Schools HiddenMembership

Cet exemple montre comment créer une unité administrative avec des informations de configuration détaillées.

• -DisplayName spécifie le nom complet de l’objet Unité administrative.
• -Description spécifie une description de l’objet Unité administrative.
• -MembershipRule spécifie la règle d’appartenance dynamique appliquée à l’unité administrative.
• -MembershipType spécifie le type d’appartenance de l’unité administrative. Les valeurs possibles sont : dynamiques et affectées. Si elle n’est pas définie, la valeur par défaut est Null et le type d’appartenance est attribué par défaut.
• -MembershipRuleProcessingState contrôle les paramètres si la règle d’appartenance dynamique est active. Définissez cette On option pour l’activer ou Paused arrêter les mises à jour.
• -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.

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.