New-EntraAdministrativeUnit

New-EntraAdministrativeUnit

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

El New-EntraAdministrativeUnit cmdlet crea una unidad administrativa en Microsoft Entra ID. Especifique DisplayName el parámetro para crear una unidad administrativa.

En escenarios delegados, al usuario que ha iniciado sesión se le debe asignar un rol de Microsoft Entra compatible o un rol personalizado que incluya el microsoft.directory/administrativeUnits/allProperties/allTasks permiso. Se admiten los siguientes roles con privilegios mínimos para esta operación:

• Administrador de roles con privilegios

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

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

En este ejemplo se muestra cómo crear una unidad administrativa.

• -DisplayName parameter especifica el nombre para mostrar del objeto Unidad administrativa.

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

En este ejemplo se muestra cómo crear una unidad administrativa.

• -DisplayName parameter especifica el nombre para mostrar del objeto Unidad administrativa.
• -Description parameter especifica una descripción para el objeto Unidad administrativa.

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

En este ejemplo se muestra cómo crear una unidad administrativa con información detallada de configuración.

• -DisplayName parameter especifica el nombre para mostrar del objeto Unidad administrativa.
• -Description parameter especifica una descripción para el objeto Unidad administrativa.
• -MembershipRule parameter especifica la regla de pertenencia dinámica aplicada a la unidad administrativa.
• -MembershipType parameter especifica el tipo de pertenencia de la unidad administrativa. Los valores posibles son: dinámicos y asignados. Si no se establece, el valor predeterminado es NULL y el tipo de pertenencia se asigna de forma predeterminada.
• -MembershipRuleProcessingState los controles de parámetros si la regla de pertenencia dinámica está activa. Establézcalo en On para habilitarlo o Paused detener las actualizaciones.
• -Visibility el parámetro especifica la visibilidad de la unidad administrativa. El valor predeterminado es public si no se establece. Establézcalo en HiddenMembership para ocultar la pertenencia de miembros que no son miembros.

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.