適用対象: ワークフォース テナント
外部テナント (詳細)
Microsoft Entra B2B コラボレーションを使用して外部パートナーと協力する場合は、複数のゲスト ユーザーを組織に同時に招待できます。 このチュートリアルでは、Microsoft Entra 管理センターを使用して外部ユーザーに一括招待を送信する方法について説明します。 具体的には、次の手順を実行します。
- 一括招待ユーザーを使用して、ユーザー情報と招待設定を含むコンマ区切り値 (.csv) ファイルを準備する
- .csv ファイルを Microsoft Entra ID にアップロードする
- ユーザーがディレクトリに追加されたことを確認する
前提条件
- Microsoft Entra ID をお持ちでない場合は、開始する前に 無料アカウント を作成してください。
- 招待状の送信先となる、複数のテスト用の電子メール アカウントが必要です。 このアカウントは、組織外にある必要があります。 gmail.com や outlook.com のアドレスなどのソーシャル アカウントを含む任意の種類のアカウントを使用できます。
ゲスト ユーザーを一括招待する
Microsoft Entra 管理センターに、少なくともユーザー管理者としてサインインします。
Entra ID>Users に移動します。
一括操作>一括招待を選択します。
[ ユーザーの一括招待 ] ページで、[ ダウンロード ] を選択して、招待プロパティを含む 有効な .csv テンプレート を取得します。
この .csv テンプレートを開いて、ゲスト ユーザーごとに 1 行追加します。 必要な値は次のとおりです。
招待を送りたいユーザーのメール アドレス - 招待を送信するユーザー。
リダイレクト URL - 招待を受け入れた後、招待されたユーザーが転送される URL。 ユーザーを [マイ アプリ] ページに転送する場合、この値を https://myapps.microsoft.com または https://myapplications.microsoft.com に変更する必要があります。
注意
カスタマイズされた招待メッセージでは、メッセージが正常に解析されないため、コンマを使用しないでください。
ファイルを保存します。
[ ユーザーの一括招待 ] ページの [ CSV ファイルのアップロード] で、ファイルを参照します。 ファイルを選択すると、.csv ファイルの検証が開始されます。
ファイルの内容が検証されると、 アップロードされたファイルが正常に 表示されます。 エラーが存在する場合は、ジョブを送信する前にそれらを修正する必要があります。
ファイルが検証に合格したら、[ 送信] を選択して、招待を追加する Azure 一括操作を開始します。
ジョブの状態を表示するには、[ ここをクリック] を選択して各操作の状態を表示します。 または、[アクティビティ] セクションで [一括操作の結果] を選択することもできます。 一括操作内の各行項目の詳細については、 #Success、 # Failure、または Total Requests 列の値を選択します。 障害が発生した場合は、障害の理由がリストされます。
ジョブが完了すると、一括操作が成功したことを示す通知が表示されます。
CSV テンプレートについて
Microsoft Entra ゲスト ユーザーを一括で招待するのに役立つテンプレートが用意されています。 次の例のような一括アップロード CSV テンプレートをダウンロードし、入力します。
CSV テンプレートの構造
ダウンロードした CSV テンプレート内の行は次のとおりです。
- バージョン番号: バージョン番号を含む最初の行をアップロード CSV に含める必要があります。
-
列見出し: 列見出しの形式は <Item name> [PropertyName] <Required または blank> です。 たとえば、「
Email address to invite [inviteeEmail] Required
」のように入力します。 テンプレートの古いバージョンの中には、微妙に異なるものもあります。 - [例] 行: テンプレートには、各列のサンプル値の行が含まれています。 サンプル行を削除し、独自のエントリに置き換えてください。
追加ガイダンス
- アップロード テンプレートの最初の 2 行を削除または変更することはできません。アップロードを処理することができなくなります。
- 必須の列が最初に示されています。
- テンプレートに新しい列を追加することはお勧めしません。 列を追加しても無視され、処理されません。
- できるだけ頻繁に最新バーションの CSV テンプレートをダウンロードすることをお勧めします。
ディレクトリのゲスト ユーザーを確認する
追加したゲスト ユーザーがディレクトリに存在することを Microsoft Entra 管理センターまたは PowerShell で確認します。
Microsoft Entra管理センターでゲスト ユーザーを表示する
- Microsoft Entra 管理センターに、少なくともユーザー管理者としてサインインします。
- Entra ID>Users に移動します。
- [ 表示] で [ ゲスト ユーザーのみ ] を選択し、追加したユーザーが一覧表示されていることを確認します。
PowerShell を使用してゲスト ユーザーを表示する
PowerShell でゲスト ユーザーを表示するには、 Microsoft.Graph.Users
PowerShell モジュールが必要です。 次に、Connect-MgGraph
コマンドを使用して、管理者アカウントでサインインし、必要なスコープを承認します。
Connect-MgGraph -Scopes "User.Read.All"
次のコマンドを実行します。
Get-MgUser -Filter "UserType eq 'Guest'"
招待したユーザーが、 emailaddress #EXT#@domain の形式でユーザー プリンシパル名 (UPN) と共に表示されます。 たとえば、 lstokes_fabrikam.com#EXT#@contoso.onmicrosoft.com、contoso.onmicrosoft.com は招待を送信した組織です。
リソースをクリーンアップする
必要がなくなったら、[ユーザー] ページの Microsoft Entra 管理センターのディレクトリにあるテスト ユーザー アカウントを削除するには、ゲスト ユーザーの横にあるチェック ボックスをオンにし、[削除] を選択 します。
または、次の PowerShell コマンドを実行してユーザー アカウントを削除することもできます。
Remove-MgUser -UserId "<UPN>"
例: Remove-MgUser -UserId "lstokes_fabrikam.com#EXT#@contoso.onmicrosoft.com"