Upgrade-DistributionGroup
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
配布グループをMicrosoft 365 グループにアップグレードするには、Upgrade-DistributionGroup コマンドレットを使用します。 このコマンドレットは配布グループでのみ機能し、メールが有効なセキュリティ グループでは使用できません。
注: このコマンドレットを使用する前に、IncludeUnifiedGroupRecipients パラメーターを使用して作成したメール アドレス ポリシーがないことを確認します。それ以外の場合、コマンドは失敗します。 配布グループをMicrosoft 365 グループにアップグレードした後、メール アドレス ポリシーを削除して再作成します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
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、Exchange Online Protection
このパラメーターは、Microsoft の内部使用のために予約されています。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DlIdentities
適用対象: Exchange Online
DlIdentities パラメーターは、Microsoft 365 グループにアップグレードする配布グループのメール アドレスを指定します。
複数の値をコンマで区切って指定できます。
| 型: | MultiValuedProperty |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ExecutingUser
適用対象: Exchange Online、Exchange Online Protection
このパラメーターは、Microsoft の内部使用のために予約されています。
| 型: | RecipientIdParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Organization
適用対象: Exchange Online、Exchange Online Protection
このパラメーターは、Microsoft の内部使用のために予約されています。
| 型: | OrganizationIdParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |