在 Microsoft Entra ID 將靜態群組變更為組動態成員資格群組

發行項
10/22/2024

在 Microsoft Entra ID (Microsoft Entra 的一部分) 中，您可以將群組的成員資格從靜態變更為動態 (反之亦然)。 Microsoft Entra ID 會在系統中保留相同的群組名稱和識別碼，因此群組的所有現有參考仍然有效。如果您改為建立新群組，則必須更新這些參考。建立組動態成員資格群組可免除新增及移除使用者的管理負擔。本文說明如何使用入口網站或 PowerShell Cmdlet，將現有群組從靜態轉換為組動態成員資格群組。在 Microsoft Entra 中，單一租用戶最多可以有 15,000 個動態成員資格群組。

警告

將現有的靜態群組變更為動態群組時，系統將從群組中移除所有現有的成員，然後再處理成員資格規則，以新增成員。如果群組用來控制對應用程式或資源的存取，則在完全處理成員資格規則之前，原始成員可能會喪失存取權。

建議您先測試新的成員資格規則，以確保群組中的新成員資格如預期般運作。如果您在測試期間遇到錯誤，請參閱解決群組授權問題。

變更群組的成員資格類型

您可使用至少已指派群組系統管理員角色的帳戶執行下列步驟。

至少以群組系統管理員的身分登入 Microsoft Entra 系統管理中心。
選取 [Microsoft Entra ID]。
群組。
從 [所有群組] 清單中，開啟您想要變更的群組。
選取屬性。
在群組的 [屬性] 頁面上，依據您所需的成員資格類型，選取 [已指派] (靜態)、[動態使用者] 或 [動態裝置] 作為 [成員資格類型]。針對組動態成員資格群組，您可以使用規則建立器來選取簡易規則的選項，或自行寫入成員資格規則。

下列步驟是針對某個使用者群組將群組從靜態變更為組動態成員資格群組的範例。

在所選群組的 [屬性] 上，選取 [動態使用者]作為成員資格類型，然後在說明組動態成員資格群組變更的對話方塊中，選取 [是] 以繼續。
選取 [新增動態查詢]，然後提供規則。
建立規則之後，在頁面底部選取 [新增查詢]。
在群組的 [屬性] 頁面上，選取 [儲存] 以儲存變更。群組的 [成員資格類型] 會立即在群組清單中更新。

提示

如果您輸入的成員資格規則不正確，群組轉換可能會失敗。入口網站右上角將會顯示通知，當中包含系統為什麼無法接受該規則的解釋。請仔細閱讀，以了解您可以如何調整規則來讓規則變成有效。有關規則語法的範例以及成員資格規則支援的屬性、運算子和值的範例，請參閱 Microsoft Entra ID 中管理組動態成員資格群組規則。

變更群組的成員資格類型 (PowerShell)

注意

若要變更動態群組屬性，您必須使用 Microsoft Graph PowerShell 模組中的 Cmdlet。如需詳細資訊，請參閱安裝 Microsoft Graph PowerShell SDK。

以下是在現有群組上切換成員資格管理的函式範例。在此範例中，需小心以正確操作 GroupTypes 屬性，並保留任何與組動態成員資格群組無關的任何值。

#The moniker for dynamic membership groups as used in the GroupTypes property of a group object
$dynamicGroupTypeString = "DynamicMembership"

function ConvertDynamicGroupToStatic
{
    Param([string]$groupId)

    #existing group types
    [System.Collections.ArrayList]$groupTypes = (Get-MgGroup -GroupId $groupId).GroupTypes

    if($groupTypes -eq $null -or !$groupTypes.Contains($dynamicGroupTypeString))
    {
        throw "This group is already a static group. Aborting conversion.";
    }


    #remove the type for dynamic membership groups, but keep the other type values
    $groupTypes.Remove($dynamicGroupTypeString)

    #modify the group properties to make it a static group: i) change GroupTypes to remove the dynamic type, ii) pause execution of the current rule
    Update-MgGroup -GroupId $groupId -GroupTypes $groupTypes.ToArray() -MembershipRuleProcessingState "Paused"
}

function ConvertStaticGroupToDynamic
{
    Param([string]$groupId, [string]$dynamicMembershipRule)

    #existing group types
    [System.Collections.ArrayList]$groupTypes = (Get-MgGroup -GroupId $groupId).GroupTypes

    if($groupTypes -ne $null -and $groupTypes.Contains($dynamicGroupTypeString))
    {
        throw "This group is already a dynamic group. Aborting conversion.";
    }
    #add the dynamic group type to existing types
    $groupTypes.Add($dynamicGroupTypeString)

    #modify the group properties to make it a static group: i) change GroupTypes to add the dynamic type, ii) start execution of the rule, iii) set the rule
    Update-MgGroup -GroupId $groupId -GroupTypes $groupTypes.ToArray() -MembershipRuleProcessingState "On" -MembershipRule $dynamicMembershipRule
}

若要讓群組變成靜態的：

ConvertDynamicGroupToStatic "a58913b2-eee4-44f9-beb2-e381c375058f"

若要讓群組變成動態的：

ConvertStaticGroupToDynamic "a58913b2-eee4-44f9-beb2-e381c375058f" "user.displayName -startsWith ""Peter"""

下一步

這些文章提供有關 Microsoft Entra ID 中群組的其他資訊。

共用方式為

在 Microsoft Entra ID 將靜態群組變更為組動態成員資格群組

變更群組的成員資格類型

變更群組的成員資格類型 (PowerShell)

下一步

意見反應

其他資源