Microsoft Entra ID でグループ メンバーを一括追加する

コンマ区切り値 (CSV) ファイルを使用して、Microsoft Entra ID のポータルにグループ メンバーを一括インポートすることで、複数のメンバーをグループに追加できます。

CSV テンプレートについて

一括アップロード CSV テンプレートをダウンロードして入力し、Microsoft Entra グループ メンバーを正常に一括追加します。 CSV テンプレートは、次の例のようになります。

アップロード用のスプレッドシートと、各行および列の目的と値を説明する吹き出しを示すスクリーンショット。

CSV テンプレートの構造

ダウンロードされた CSV テンプレートの行は次のとおりです。

  • バージョン番号: バージョン番号を含む最初の行は、アップロード CSV に含める必要があります。
  • 列見出し:列見出しの形式は、<項目名> [PropertyName] <Required または空白> です。 たとえば Member object ID or user principal name [memberObjectIdOrUpn] Required です。 テンプレートの古いバージョンの中には、微妙に異なるものもあります。 グループ メンバーシップの変更については、メンバー オブジェクト ID またはユーザー プリンシパル名を選択できます。
  • 例の行: テンプレートには、各列の許容値の例の行が含まれています。 サンプル行を削除し、独自のエントリに置き換える必要があります。

その他のガイダンス

  • アップロード テンプレートの最初の 2 行は削除または変更しないでください。削除または変更しないと、アップロードを処理できません。
  • 必須の列が最初に示されています。
  • テンプレートに新しい列を追加することはお勧めしません。 その他の列を追加しても無視され、処理されません。
  • できるだけ頻繁に最新バーションの CSV テンプレートをダウンロードすることをお勧めします。
  • ファイルを正常にアップロードするには、少なくとも 2 人のユーザーの UPN またはオブジェクト ID を追加します。

グループ メンバーを一括インポートする

ヒント

この記事の手順は、開始するポータルに応じて若干異なる場合があります。

  1. グループ管理者以上の権限で Microsoft Entra 管理センターにサインインします。

  2. [Microsoft Entra ID] を選びます。

    Note

    グループの所有者も、所有しているグループのメンバーを一括インポートできます。

  3. [グループ]>[すべてのグループ] の順に選択します。

  4. メンバーを追加するグループを開き、 [メンバー] を選択します。

  5. [メンバー] ページで、[一括操作] を選択し、[メンバーのインポート] を選択します。

  6. [グループ メンバーの一括インポート] ページで、 [ダウンロード] を選択して、必要なグループ メンバーのプロパティを含む CSV ファイル テンプレートを取得します。

    [メンバーのインポート] コマンドがグループの [プロファイル] ページにあることを示すスクリーンショット。

  7. CSV ファイルを開き、グループにインポートするグループ メンバーごとに行を追加します。 必要な値は、メンバー オブジェクト IDまたはユーザー プリンシパル名です。 そのうえでファイルを保存します。

    CSV ファイルにインポートするメンバーの名前と ID が含まれることを示すスクリーンショット。

  8. [グループ メンバーの一括インポート] ページの [CSV ファイルをアップロード] で、そのファイルを参照します。 ファイルを選択すると、CSV ファイルの検証が開始されます。

  9. ファイルの内容が検証されると、一括インポート ページに "ファイルが正常にアップロードされました" と表示されます。 エラーが存在する場合は、ジョブを送信する前にそれらを修正する必要があります。

  10. ファイルが検証に合格したら、[送信] を選択して、グループ メンバーをグループにインポートする一括操作を開始してください。

  11. インポート操作が完了すると、一括操作が成功したことを示す通知が表示されます。

インポートの状態を確認する

保留中のすべての一括リクエストのステータスは、「一括操作の結果」ページで確認できます。

[一括操作の結果] ページの [チェックの状態] オプションを示すスクリーンショット。

一括操作に含まれる各行の項目の詳細については、 [成功数][失敗数][要求数合計] の各列の値を選択してください。 障害が発生した場合は、障害の理由がリストされます。

一括インポート サービスの制限

グループ メンバーの一覧をインポートする各一括アクティビティは、最大 1 時間実行できます。 この期間では、最大 40,000 人のメンバーのリストをインポートできます。

次のステップ