Get-EligibleDistributionGroupForMigration

モジュール:

ExchangePowerShell

適用対象:

Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

このコマンドレットは、クラウドベースのサービスでのみ機能します。

Get-EligibleDistributionGroupForMigration コマンドレットを使用して、Microsoft 365 グループにアップグレードできる配布グループを特定します。 メールが有効なセキュリティ グループをMicrosoft 365 グループにアップグレードすることはできません。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

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

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

説明

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

Get-EligibleDistributionGroupForMigration -ResultSize unlimited

次の使用例は、Microsoft 365 グループにアップグレードできるすべての配布グループの概要リストを返します。

パラメーター

-Identity

Identity パラメーターは、指定された配布グループのメール アドレスで結果をフィルター処理します。 指定したメール アドレスの結果が返されない場合、グループを Microsoft 365 グループにアップグレードすることはできません。

このパラメーターは ManagedBy パラメーターと併用できません。

Type:	DistributionGroupIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ManagedBy

ManagedBy パラメーターは、配布グループのマネージャー (ManagedBy のプロパティ) で結果をフィルター処理します。 配布グループのマネージャーを一意に識別する任意の値を使用できます。 例:

• 名前
• Alias
• 識別名 (DN)
• 正規 DN
• 電子メール アドレス
• GUID

データベース名

Type:	GeneralRecipientIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-OrganizationalUnit

OrganizationalUnit パラメーターは、Active Directory 内のオブジェクトの場所に基づいて結果をフィルタリングします。 指定された場所に存在するオブジェクトのみが返されます。 このパラメーターの有効な入力値は、Get-OrganizationalUnit コマンドレットによって返される組織単位 (OU) またはドメインです。 OU またはドメインを一意に識別する、任意の値を使用できます。 以下に例を示します。

• 名前
• 識別名 (DN)
• 識別名 (DN)
• GUID

Type:	OrganizationalUnitIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ResultSize

ResultSize パラメーターは、返される結果の最大数を指定します。 クエリに一致するすべてのリクエストを返す場合は、このパラメーターの値に unlimited を使用します。 既定値は 1,000 です。

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection