New-EntraAdministrativeUnit

New-EntraAdministrativeUnit

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

New-EntraAdministrativeUnit コマンドレットは、Microsoft Entra IDに管理単位を作成します。 管理単位 DisplayName 作成するパラメーターを指定します。

委任されたシナリオでは、サインインしているユーザーに、サポートされているMicrosoft Entra ロールまたはmicrosoft.directory/administrativeUnits/allProperties/allTasksアクセス許可を含むカスタム ロールを割り当てる必要があります。 この操作では、次の最小特権ロールがサポートされています。

• 特権ロール管理者

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

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

この例では、管理単位を作成する方法を示します。

• -DisplayName パラメーターは、管理単位オブジェクトの表示名を指定します。

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

この例では、管理単位を作成する方法を示します。

• -DisplayName パラメーターは、管理単位オブジェクトの表示名を指定します。
• -Description パラメーターは、管理単位オブジェクトの説明を指定します。

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

この例では、詳細な構成情報を含む管理単位を作成する方法を示します。

• -DisplayName パラメーターは、管理単位オブジェクトの表示名を指定します。
• -Description パラメーターは、管理単位オブジェクトの説明を指定します。
• -MembershipRule パラメーターは、管理単位に適用される動的メンバーシップ規則を指定します。
• -MembershipType パラメーターは、管理単位のメンバーシップの種類を指定します。 指定できる値は、動的と割り当てです。 設定しない場合、既定値は null になり、メンバーシップの種類は既定で割り当てられます。
• -MembershipRuleProcessingState パラメーターは、動的メンバーシップ ルールがアクティブかどうかを制御します。 Onに設定して有効にするか、更新プログラムを停止Paused。
• -Visibility パラメーターは、管理単位の可視性を指定します。 設定されていない場合、既定値は public です。 メンバー以外のメンバーからメンバーシップを非表示にするには、 HiddenMembership に設定します。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。