Get-EligibleDistributionGroupForMigration

モジュール:
Exchange PowerShell

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

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

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

構文

Identity 

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

ManagedBy 

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

適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

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

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

注意: Identityパラメータの値$nullまたは存在しない値は、IdentityパラメータなしでGet-コマンドを実行したかのように、 すべての オブジェクトを返します。 Identity パラメーターの値のリストが正確であり、存在しない$null値が含まれていないことを確認します。

パラメーターのプロパティ

型:DistributionGroupIdParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Identity
配置:1
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-ManagedBy

適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

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

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

データベース名

パラメーターのプロパティ

型:GeneralRecipientIdParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ManagedBy
配置: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)
  • 識別名 (DN)
  • GUID

パラメーターのプロパティ

型:OrganizationalUnitIdParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ResultSize

適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

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

パラメーターのプロパティ

型:Unlimited
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

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