Microsoft Entra B2B 共同作業程式碼與 PowerShell 範例

PowerShell 範例

您可以從儲存在 .csv 檔案中的電子郵件地址大量邀請外部使用者至組織。

  1. 準備 .csv 檔案

    建立新 .csv 檔案並將邀請命名為 .csv。 在此範例中,檔案會儲存在 C:\data 中,並且包含下列資訊:

    名稱 InvitedUserEmailAddress
    Gmail B2B 受邀者 b2binvitee@gmail.com
    Outlook B2B 受邀者 b2binvitee@outlook.com
  2. 下載最新的 Microsoft Graph PowerShell

    若要使用新的 Cmdlet,您必須安裝更新的 Microsoft Graph PowerShell 模組。 如需詳細資訊,請參閱 安裝 Microsoft Graph PowerShell SDK

  3. 登入您的租用戶

    Connect-MgGraph -Scopes "User.Invite.All"
    
  4. 執行 PowerShell Cmdlet

    $invitations = import-csv C:\data\invitations.csv
    $messageInfo = New-Object Microsoft.Open.MSGraph.Model.InvitedUserMessageInfo
    $messageInfo.customizedMessageBody = "Hey there! Check this out. I created an invitation through PowerShell"
    foreach ($email in $invitations) {
       New-MgInvitation -InviteRedirectUrl "https://wingtiptoysonline-dev-ed.my.woodgrove.com" `
          -InvitedUserDisplayName $email.Name -InvitedUserEmailAddress $email.InvitedUserEmailAddress `
          -InvitedUserMessageInfo $messageInfo -SendInvitationMessage:$true
    }
    

此 Cmdlet 會傳送邀請給 invitations.csv 中的電子郵件地址。 此 Cmdlet 的其他功能包括:

  • 自訂電子郵件訊息中的文字
  • 包括受邀使用者的顯示名稱
  • 傳送訊息給 CC 或完全隱藏電子郵件訊息

程式碼範例

程式碼範例說明如何呼叫邀請 API 以及取得兌換 URL。 使用兌換 URL 傳送自訂邀請電子郵件。 由於您可使用 HTTP 用戶端撰寫電子郵件,因此您可自訂外觀並透過 Microsoft Graph API 傳送。

POST https://graph.microsoft.com/v1.0/invitations
Content-type: application/json
{
  "invitedUserEmailAddress": "david@fabrikam.com",
  "invitedUserDisplayName": "David",
  "inviteRedirectUrl": "https://myapp.contoso.com",
  "sendInvitationMessage": true
}

下一步