クイックスタート: PowerShell を使用してゲストユーザーを追加する

[アーティクル]
10/25/2023

Microsoft Entra B2B コラボレーションで外部パートナーを自社のアプリとサービスに招待できる方法は多数あります。前のクイックスタートでは、Microsoft Entra 管理センターでゲストユーザーを直接追加する方法を説明しました。ゲストユーザーは、PowerShell を使用して、一度に 1 人づつ、または一括で追加することもできます。このクイックスタートでは、New-MgInvitation コマンドを使って、1 人のゲストユーザーを Microsoft Entra テナントに追加します。

Azure サブスクリプションがない場合は、開始する前に無料アカウントを作成してください。

前提条件

このクイックスタートのシナリオを完了するための要件を次に示します。

テナントディレクトリにユーザーを作成できるロール。少なくともゲスト招待元ロール、ユーザー管理者などが必要です。
Microsoft Graph ID サインインモジュール (Microsoft.Graph.Identity.SignIns) と Microsoft Graph ユーザーモジュール (Microsoft.Graph.Users) をインストールします。 #Requires ステートメントを使用して、必要な PowerShell モジュールが満たされない限り、スクリプトが実行されないようにできます。

#Requires -Modules Microsoft.Graph.Identity.SignIns, Microsoft.Graph.Users

テスト用のメールアカウントを取得します。招待状の送信先となるテスト用の電子メールアカウントが必要です。このアカウントは、組織外にある必要があります。 gmail.com や outlook.com のアドレスなどのソーシャルアカウントを含む任意の種類のアカウントを使用できます。

次のコマンドを実行してテナントドメインに接続します。

Connect-MgGraph -Scopes 'User.ReadWrite.All'

メッセージが表示されたら、資格情報を入力します。

招待状を送信する

テスト用の電子メールアカウントに招待状を送信するには、次の PowerShell コマンドを実行します ("John Doe" と john@contoso.com をテスト用の電子メールアカウント名と電子メールアドレスに置き換えます)。
```
New-MgInvitation -InvitedUserDisplayName "John Doe" -InvitedUserEmailAddress John@contoso.com -InviteRedirectUrl "https://myapplications.microsoft.com" -SendInvitationMessage:$true
```
このコマンドは、指定した電子メールアドレスに招待状を送信します。出力をチェックします。出力は次の例のようになります。

ユーザーがディレクトリ内に存在することを確認する

招待されたユーザーが Microsoft Entra に追加されたことを確認するには、次のコマンドを実行します (john@contoso.com を招待した電子メールで置き換えます)。
```
Get-MgUser -Filter "Mail eq 'John@contoso.com'"
```
出力をチェックして、招待したユーザーが表示されていることを確認します。emailaddress#EXT#@domain 形式のユーザープリンシパル名 (UPN) になっています。たとえば、john_contoso.com#EXT#@fabrikam.onmicrosoft.com では、fabrikam.onmicrosoft.com が招待状を送信した組織になります。

リソースをクリーンアップする

不要になったら、ディレクトリ内のテスト用のユーザーアカウントを削除できます。ユーザーアカウントを削除するには、次のコマンドを使用します。

 Remove-MgUser -UserId '<String>'

次に例を示します。

Remove-MgUser -UserId 'john_contoso.com#EXT#@fabrikam.onmicrosoft.com'

Remove-MgUser -UserId '00aa00aa-bb11-cc22-dd33-44ee44ee44ee'

次のステップ

このクイックスタートでは、PowerShell を使用して、1 人のゲストユーザーを招待してディレクトリに追加しました。 Microsoft Entra 管理センターを使ってゲストユーザーを招待することもできます。さらに、PowerShell を使用して、ゲストユーザーを一括で招待することもできます。

クイック スタート: PowerShell を使用してゲスト ユーザーを追加する