Microsoft Entra PowerShell を使用してゲストアカウントを管理する

Microsoft Entra IDのゲストアカウントを使用すると、外部ユーザーは、組織の完全なメンバーにならずに、ファイル、チーム、サイトなどの特定のリソースにアクセスできます。通常、これらのアカウントは、組織のリソースへの一時的なアクセスが必要なパートナー、請負業者、またはクライアントとの共同作業に使用されます。

ゲストアカウントを効果的に管理することは、組織のデータのセキュリティと整合性を維持するために重要です。管理者は、ゲストアカウントに、目的のタスクを実行するために必要なアクセス許可とアクセス権のみが付与されるようにする必要があります。これらのアカウントを定期的に確認および監査することは、削除する必要がある非アクティブまたは期限切れのアカウントを特定するためにも重要です。この演習は、潜在的なセキュリティリスクを軽減するだけでなく、組織のリソースを効率的に使用できるようにします。ゲストアカウントを適切に管理することで、外部コラボレーション用のセキュリティで保護された生産性の高い環境を提供できます。

前提条件

Microsoft Entra PowerShell でゲストユーザーを管理するには、次のものが必要です。

Microsoft Entra ユーザーアカウント。アカウントをまだお持ちでない場合は、無料でアカウントを作成できます。
次のいずれかのロール:
Microsoft Entra PowerShell モジュールがインストールされています。 Microsoft Entra PowerShell モジュールのインストールガイドに従って、モジュールをインストールします。

ゲストユーザーアカウントを招待する

Microsoft Entra PowerShell を使用して、ゲストユーザーを組織に招待できます。このプロセスにより、外部ユーザーは完全なメンバーにならずに、組織内の特定のリソースにアクセスできます。 1 人のゲストユーザーを招待することも、一度に複数のゲストユーザーを一括招待することもできます。

1 つのゲストユーザーアカウントを招待する

少なくともゲスト招待者ロールを持つ 1 人のゲストユーザーを組織に招待する。

# Connect to Microsoft Entra
Connect-Entra -Scopes 'User.Invite.All'

#Invite the guest user
New-EntraInvitation `
    -InvitedUserEmailAddress 'guestUser@contoso.com' `
    -InviteRedirectUrl 'https://contoso.com' `
    -SendInvitationMessage $true `
    -InvitedUserDisplayName 'Guest User'

このスクリプトは、電子メールアドレスが guestUser@contoso.comゲストユーザーに招待を送信し、承諾時に https://contoso.com するように指示します。次の出力は、招待されたゲストユーザーの詳細を示しています。

Id                                   InviteRedeemUrl
--                                   ---------------                                           
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb https://login.microsoftonline.com/redeem?rd=https%3a%2f%2finvitation…

ゲストユーザーアカウントを一括招待する

ゲストユーザーを組織に一括招待するには:

CSV ファイルを準備する

Microsoft Excelで、招待されたユーザー名と電子メールアドレスの一覧を含む CSV ファイルを作成します。 [名前] 列見出しと [電子メール] 列見出しを必ず含めます。

たとえば、次の形式のワークシートを作成します。

名前 Email

リード・スミス rsmith@contoso.com

ヘイデンクック hcook@fabricam.com

Isabel Garcia igarcia@contoso.com

名前	Email
リード・スミス	rsmith@contoso.com
ヘイデンクック	hcook@fabricam.com
Isabel Garcia	igarcia@contoso.com

C:\BulkInvite\Invitations.csvまたは任意の場所としてファイルを保存します。

Excelがない場合は、メモ帳などの任意のテキストエディターで CSV ファイルを作成できます。各値はカンマで、各行は改行で区切ってください。

少なくともゲスト招待者ロールを持つMicrosoft Entraに接続します。

Connect-Entra -Scopes 'User.Invite.All'

# Import the CSV file containing the invitations.
$invitations = Import-Csv -Path "c:\bulkinvite\invitations.csv"

# Define the message to be sent to the invited users.
$messageBody = "Hello. You are invited to the Contoso organization."

# Iterate over each invitation in the CSV file.
foreach ($invitation in $invitations) {
    # Define the invitation parameters
    $invitationParams = @{
        InvitedUserEmailAddress = $invitation.Email  # Ensure this matches your CSV column name
        InviteRedirectUrl       = "https://contoso.com"
        SendInvitationMessage   = $true
        InvitedUserMessageInfo  = @{
            CustomizedMessageBody = $messageBody
        }
    }

    # Create a new invitation using the defined parameters
    New-EntraInvitation @invitationParams
}

このスクリプトは、CSV ファイルから招待の一覧をインポートします。招待されたユーザーのカスタムメッセージを定義し、各招待を反復処理して、メールアドレスを使用して各ユーザーに招待を送信します。

次の出力は、招待されたゲストユーザーの詳細を示しています。

Id                                   InviteRedeemUrl
--                                   ---------------                                                      
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb https://login.microsoftonline.com/redeem?rd=https%3a%2f%2finvitation…
bbbbbbbb-1111-2222-3333-cccccccccccc https://login.microsoftonline.com/redeem?rd=https%3a%2f%2finvitation…

ゲストユーザーアカウントの表示とエクスポート

ゲストユーザーを表示およびエクスポートするには:

少なくともゲスト招待者ロールを持つMicrosoft Entraに接続します。

Connect-Entra -Scopes 'User.Read.All'
 

# Retrieve all guest user accounts.
Get-EntraUser -Filter "userType eq 'Guest'" -All -Property "displayName", "mail", "createdDateTime", "AccountEnabled" | Select-Object "displayName", "mail", "createdDateTime", "AccountEnabled"

スクリプトは、表示名、電子メールアドレス、作成日を使用して、Microsoft Entra IDからすべてのゲストユーザーアカウントを取得し、それらのゲストユーザーの一覧を表示します。

DisplayName   Id   Mail                               createdDateTime      AccountEnabled
-----------   --   ----                               ---------------      --------------
externaluser1      externaluser1@externaldomain1.com  13/09/2024 18:37:33  True
externaluser2      externaluser2@externaldomain2.com  15/02/2024 15:05:31  True

ゲストユーザーのスポンサープランを管理する

Microsoft Entra IDでは、ゲストスポンサープランを使用すると、特定のユーザーまたはグループをゲストユーザーのスポンサーとして指定し、ゲストユーザーのアクセスとアクセス許可を管理できます。この機能は、外部ユーザーのアクセスを制御および監視する組織に役立ちます。

ゲストユーザースポンサープランを管理するには、ゲストユーザーに対するスポンサーの割り当て、表示、および削除を行います。これらのアクションを実行するには、少なくともユーザー管理者ロールが必要です。

次の例は、Microsoft Entra IDでゲストユーザーにスポンサーを割り当てる方法を示しています。 New-EntraUserSponsor コマンドレットを使用して、指定したゲストユーザーにスポンサーを割り当てることができます。

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

$sponsor = Get-EntraUser -UserId 'SponsorEmail@contoso.com'
Set-EntraUserSponsor -UserId 'guestuser@contoso.com' -Type User -SponsorIds $sponsor.Id

次の使用例は、Microsoft Entra IDのゲストユーザーにスポンサーを割り当てます。 UserId パラメーターはゲストユーザーを指定し、SponsorId パラメーターはスポンサーを指定します。

ゲストユーザーのスポンサーを表示する

次の例は、Microsoft Entra IDでゲストユーザーのスポンサーを表示する方法を示しています。 Get-EntraUserSponsor コマンドレットを使用して、指定したゲストユーザーのスポンサーを取得できます。

Connect-Entra -Scopes 'User.Read.All'

Get-EntraUserSponsor -UserId 'guestuser@contoso.com' -All | Select-Object Id, DisplayName, '@odata.type', CreatedDateTime | Format-Table -AutoSize

この例では、Microsoft Entra IDのゲストユーザーのスポンサーを取得します。 UserId パラメーターは、ゲストユーザーを指定します。

id                                   displayName          @odata.type           createdDateTime
--                                   -----------      -----------           ---------------
aaaaaaaa-1111-2222-3333-bbbbbbbbbbbb GuestUser Sponsor 1  #microsoft.graph.user 5/6/2025 11:29:26 PM
bbbbbbbb-1111-2222-3333-bbbbbbbbbbbb GuestUser Sponsor 2  #microsoft.graph.user 5/6/2025 11:29:27 PM

次の例は、Microsoft Entra IDのゲストユーザーからスポンサーを削除する方法を示しています。 Remove-EntraUserSponsor コマンドレットを使用して、指定したゲストユーザーからスポンサーを削除できます。

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

$sponsor = Get-EntraUserSponsor -UserId 'SawyerM@contoso.com' | Where-Object { $_.displayName -eq 'Adele Vance (Fabrikam)' }
Remove-EntraUserSponsor -UserId 'SawyerM@Contoso.com' -SponsorId $sponsor.Id

この例では、Microsoft Entra IDのゲストユーザーからスポンサーを削除します。 UserId パラメーターはゲストユーザーを指定し、SponsorId パラメーターは削除するスポンサーを指定します。

ゲストユーザーの招待受諾状態をリセットする

Microsoft Entra IDでは、ユーザーが招待を再び引き換えることを許可する場合に、ゲストユーザーの引き換え状態をリセットする必要があります。この機能は、ユーザーが引き換えプロセスを完了しない場合、または何らかの理由で状態をリセットする必要がある場合に役立ちます。次の例では、ゲストユーザーに新しい招待を送信して、引き換えの状態をリセットする方法を示します。

最初にゲストユーザーを特定し、新しい招待を送信します。これにより、ゲストユーザーをもう一度招待することで引き換えの状態がリセットされます。

Connect-Entra -Scopes 'User.Invite.All'

$user = Get-EntraUser -Filter "startsWith(mail, 'johndoe@gmail.com')"
New-EntraInvitation `
    -InvitedUserEmailAddress $user.Mail `
    -InviteRedirectUrl "https://myapps.contoso.com" `
    -ResetRedemption `
    -SendInvitationMessage `
    -InvitedUser $user

ゲストユーザーアカウントを無効にする

次の例は、Microsoft Entra IDでゲストユーザーアカウントを無効にする方法を示しています。 1 つのゲストアカウントを無効にすることも、要件に基づいてすべてのゲストアカウントを無効にすることもできます。

1 つのゲストユーザーアカウントを無効にする

1 つのゲストユーザーアカウントを無効にするには:

少なくともユーザー管理者ロールを使用してMicrosoft Entraに接続します。

Connect-Entra -Scopes 'User.ReadWrite.All'
  
# Disable the guest user account.
Get-EntraUser -Filter "userType eq 'Guest' and mail eq 'guestUser@contoso.com'" | Set-EntraUser -AccountEnabled $false

すべてのゲストユーザーアカウントを無効にする

次のコマンドレットを実行して、すべてのゲストユーザーアカウントを無効にします。

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

# Disable the guest user account
Get-EntraUser | Where-Object { $_.UserType -eq 'Guest' } | Set-EntraUser -AccountEnabled $false

期限切れのゲストユーザーアカウントを表示およびエクスポートする

期限切れのゲストユーザーアカウントを表示およびエクスポートするには:

前の例を展開してゲストユーザーを取得し、それぞれに有効期限があるかどうかを確認します。この例では、作成後 90 日後にゲストアカウントの有効期限が切れると想定しています。

$report = @() 
$now = Get-Date  
# Retrieve all guest users.
$guestUsers = Get-EntraUser -Filter "userType eq 'Guest'" -All

foreach ($guest in $guestUsers) {
    # Calculate the expiration date based on the creation date
    $guestExpirationDate = $guest.CreatedDateTime.AddDays(90)

    # Check if the account is expired
    if ($guestExpirationDate -lt $now) {
        # Add expired guest account details to the report
        $report += [PSCustomObject]@{
            Id          = $guest.Id
            Name        = $guest.DisplayName
            Mail        = $guest.Mail
            Expiration  = $guestExpirationDate
            CreatedDate = $guest.CreatedDateTime
        }
    }
}

レポートを CSV ファイルにエクスポートします。

   $report | Export-Csv -Path "ExpiredGuestAccounts.csv" -NoTypeInformation

期限切れのゲストユーザーアカウントを削除する

少なくともユーザー管理者ロールを使用してMicrosoft Entraに接続します。

この例では、作成後 90 日後にゲストアカウントの有効期限が切れると想定しています。

Note

このスクリプトは、アカウントの有効期限が切れているすべてのゲストユーザーを削除します。このアクションは元に戻すことができないので、注意して使用する必要があります。ユーザーアカウントを削除する前に、必ずバックアップまたは復旧計画を用意してください。

Connect-Entra -Scopes "User.ReadWrite.All"

$age = (Get-Date).AddDays(-90).ToString("yyyy-MM-ddTHH:mm:ssZ") 
Get-EntraUser -Filter "userType eq 'Guest' and createdDateTime le $age" -All | Remove-EntraUser

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-07-01

Microsoft Entra PowerShell を使用してゲスト アカウントを管理する

前提条件

ゲスト ユーザー アカウントを招待する

1 つのゲスト ユーザー アカウントを招待する

ゲスト ユーザー アカウントを一括招待する

ゲスト ユーザー アカウントの表示とエクスポート

ゲスト ユーザー のスポンサー プランを管理する

ゲスト ユーザーにスポンサーを割り当てる

ゲスト ユーザーのスポンサーを表示する

ゲスト ユーザーからスポンサーを削除する

ゲスト ユーザーの招待受諾状態をリセットする

ゲスト ユーザー アカウントを無効にする

1 つのゲスト ユーザー アカウントを無効にする

すべてのゲスト ユーザー アカウントを無効にする

期限切れのゲスト ユーザー アカウントを表示およびエクスポートする

期限切れのゲスト ユーザー アカウントを削除する