New-EntraAdministrativeUnit

New-EntraAdministrativeUnit

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

Polecenie New-EntraAdministrativeUnit cmdlet tworzy jednostkę administracyjną w Microsoft Entra ID. Określ DisplayName parametr, aby utworzyć jednostkę administracyjną.

W scenariuszach delegowanych zalogowany użytkownik musi mieć przypisaną obsługiwaną rolę Microsoft Entra lub rolę niestandardową zawierającą microsoft.directory/administrativeUnits/allProperties/allTasks uprawnienia. Następujące role z najniższymi uprawnieniami są obsługiwane dla tej operacji:

• Administrator ról uprzywilejowanych

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

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

W tym przykładzie pokazano, jak utworzyć jednostkę administracyjną.

• -DisplayName parametr określa nazwę wyświetlaną obiektu jednostki administracyjnej.

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

W tym przykładzie pokazano, jak utworzyć jednostkę administracyjną.

• -DisplayName parametr określa nazwę wyświetlaną obiektu jednostki administracyjnej.
• -Description parametr określa opis obiektu jednostki administracyjnej.

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

W tym przykładzie pokazano, jak utworzyć jednostkę administracyjną ze szczegółowymi informacjami o konfiguracji.

• -DisplayName parametr określa nazwę wyświetlaną obiektu jednostki administracyjnej.
• -Description parametr określa opis obiektu jednostki administracyjnej.
• -MembershipRule parametr określa regułę członkostwa dynamicznego zastosowaną do jednostki administracyjnej.
• -MembershipType parametr określa typ członkostwa jednostki administracyjnej. Możliwe wartości to: dynamiczne i przypisane. Jeśli nie zostanie ustawiona, wartość domyślna ma wartość null, a typ członkostwa jest domyślnie przypisany.
• -MembershipRuleProcessingState parametr określa, czy reguła członkostwa dynamicznego jest aktywna. Ustaw wartość , aby On ją włączyć lub Paused zatrzymać aktualizacje.
• -Visibility parametr określa widoczność jednostki administracyjnej. Wartość domyślna to public , jeśli nie jest ustawiona. Ustaw wartość na , aby HiddenMembership ukryć członkostwo przed członkami niebędącymi członkami.

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.