Upgrade-DistributionGroup

  • リファレンス
モジュール:
ExchangePowerShell
適用対象:
Exchange Online, Exchange Online Protection

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

配布グループを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