共用方式為

Get-EligibleDistributionGroupForMigration

模組:
Exchange PowerShell

此指令小程式僅能在雲端服務中運作。

使用 Get-EligibleDistributionGroupForMigration 指令碼來辨識可升級為 Microsoft 365 群組 的分發群組。 你無法將啟用郵件的安全群組升級為 Microsoft 365 群組。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

語法

Identity 

Get-EligibleDistributionGroupForMigration
    [[-Identity] <DistributionGroupIdParameter>]
    [-OrganizationalUnit <OrganizationalUnitIdParameter>]
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

ManagedBy 

Get-EligibleDistributionGroupForMigration
    [-ManagedBy <GeneralRecipientIdParameter>]
    [-OrganizationalUnit <OrganizationalUnitIdParameter>]
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

Description

您必須已獲指派權限，才能執行此指令程式。 雖然這篇文章列出了 cmdlet 的所有參數，但如果某些參數未包含在你分配的權限中，你可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

Get-EligibleDistributionGroupForMigration -ResultSize unlimited

此範例回傳所有可升級為 Microsoft 365 群組的發行群組摘要清單。

參數

-Identity

適用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地郵箱安全外掛

Identity 參數會依據指定分發群組的電子郵件地址來篩選結果。 若指定的電子郵件地址未回傳結果，該群組無法升級為 Microsoft 365 群組。

你不能用這個參數搭配 ManagedBy 參數。

注意：Identity 參數的值$null或不存在的值，會回傳 所有 物件，就像你執行 Get- 指令時沒有 Identity 參數一樣。 請確認 Identity 參數的值清單是否準確，且不包含不存在的 $null 值。

參數屬性

類型:DistributionGroupIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Identity
Position:1
必要:False
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-ManagedBy

適用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地郵箱安全外掛

ManagedBy 參數會過濾分配群組管理者 (ManagedBy 屬性) 的結果。 你可以使用任何唯一能識別分發群組管理器的值。 例如：

  • 名稱
  • 別名
  • 辨別名稱 (DN)
  • 辨別名稱 (DN)
  • 標準 DN
  • GUID

資料庫名稱

參數屬性

類型:GeneralRecipientIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

ManagedBy
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-OrganizationalUnit

適用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地郵箱安全外掛

OrganizationalUnit 參數會根據物件在 Active Directory 中的位置來過濾結果。 系統只會傳回存在於指定位置的物件。 此參數的有效輸入是由 Get-OrganizationalUnit 指令碼返回 (OU) 或領域中的組織單位。 您可以使用唯一識別 OU 或網域的任何值。 例如：

  • 名稱
  • 名稱
  • 辨別名稱 (DN)
  • GUID

參數屬性

類型:OrganizationalUnitIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ResultSize

適用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內建本地郵箱安全外掛

ResultSize 參數會指定傳回的結果筆數上限。 若要傳回符合查詢的所有要求，請使用 unlimited 作為此參數的值。 預設值為 1000。

參數屬性

類型:Unlimited
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。