Microsoft Entra B2B 协作代码和 PowerShell 示例

PowerShell 示例

可通过已存储在 .csv 文件中的电子邮件地址批量邀请外部用户加入组织。

  1. 准备 .csv 文件

    创建新的 .csv 文件并将其命名为 invitations.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 -Environment China -ClientId 'YOUR_CLIENT_ID' -TenantId 'YOUR_TENANT_ID' -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 的其他功能包括:

  • 电子邮件中的自定义文本
  • 包括受邀用户的显示名称
  • 将邮件发送给抄送人或完全禁止电子邮件

代码示例

此代码示例演示如何调用邀请 API 和获取兑换 URL。 使用兑换 URL 发送自定义邀请电子邮件。 可使用 HTTP 客户端撰写电子邮件,以便自定义其外观并通过 Microsoft Graph API 发送。

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