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
このパラメーターは、Microsoft の内部使用のために予約されています。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-DlIdentities
DlIdentities パラメーターは、Microsoft 365 グループにアップグレードする配布グループの電子メール アドレスを指定します。
複数の値をコンマで区切って指定できます。
Type: | MultiValuedProperty |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-ExecutingUser
このパラメーターは、Microsoft の内部使用のために予約されています。
Type: | RecipientIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-Organization
このパラメーターは、Microsoft の内部使用のために予約されています。
Type: | OrganizationIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |