Upgrade-DistributionGroup

モジュール:
Exchange PowerShell

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

Upgrade-DistributionGroup コマンドレットを使用して、配布グループを Microsoft 365 グループ にアップグレードします。 このコマンドレットは配布グループでのみ機能し、メールが有効なセキュリティ グループでは使用できません。

注: このコマンドレットを使用する前に、IncludeUnifiedGroupRecipients パラメーターを使用して作成した電子メール アドレス ポリシーがないことを確認してください。さもなければ、コマンドは失敗します。 配布グループを Microsoft 365 グループにアップグレードした後、電子メール アドレス ポリシーを削除して再作成します。

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

構文

Default (既定) 

Upgrade-DistributionGroup
    [-DlIdentities] <MultiValuedProperty>
    [-ActionType <String>]
    [-ExecutingUser <RecipientIdParameter>]
    [-Organization <OrganizationIdParameter>]
    [<CommonParameters>]

説明

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

例

例 1

Upgrade-DistributionGroup -DlIdentities hr@contoso.com,finance@contoso.com

この例では、指定した配布グループを Microsoft 365 グループにアップグレードします。

パラメーター

-ActionType

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

このパラメーターは、Microsoft の内部使用のために予約されています。

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

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

パラメーター セット

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

-DlIdentities

適用対象: Exchange Online

DlIdentities パラメーターは、Microsoft 365 グループにアップグレードする配布グループの電子メール アドレスを指定します。

複数の値をコンマで区切って指定できます。

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

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

パラメーター セット

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

-ExecutingUser

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

このパラメーターは、Microsoft の内部使用のために予約されています。

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

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

パラメーター セット

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

-Organization

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

このパラメーターは、Microsoft の内部使用のために予約されています。

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

型:OrganizationIdParameter
規定値: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」を参照してください。