在 Microsoft Entra 外部 ID 中重置来宾用户的兑换状态

适用于： 员工租户 外部租户（了解详细信息）

本文介绍了如何在来宾用户兑换 B2B 协作邀请后更新其登录信息。 有时你可能需要更新其登录信息，例如，出现以下情况时：

• 用户需要使用其他电子邮件和标识提供者进行登录
• 用户在主租户中的帐户已被删除或重新创建
• 用户已转移到其他公司，但他们仍然需要对你的资源具有相同的访问权限
• 用户的职责已转移给其他用户

以前，若要管理这些方案，你必须从你的目录中手动删除来宾用户的帐户，然后重新邀请用户。 现在，可以使用 Microsoft Entra 管理中心、PowerShell 或 Microsoft Graph 邀请 API 来重置用户的兑换状态并重新邀请用户，同时还可保留用户的对象 ID、组成员身份和应用分配。 当用户兑换新的邀请时，用户的 UserPrincipalName (UPN) 不会更改，但其登录名将更改为新的电子邮件地址。 然后，用户可以使用新电子邮件地址或者已由你添加到用户对象的 otherMails 属性中的电子邮件地址来登录。

必需的 Microsoft Entra 角色

要重置用户的兑换状态，需要在目录范围内分配以下角色之一：

• 支持管理员（最低特权）
• 用户管理员

使用 Microsoft Entra 管理中心重置兑换状态

1. 至少以用户管理员身份登录到 Microsoft Entra 管理中心。

2. 浏览到“标识”>“用户”>“所有用户”。

3. 在列表中，选择用户的名称以打开其用户配置文件。

4. （可选）用户想要使用其他电子邮件登录时：

   1. 选择“编辑属性”图标。
   2. 滚动到“电子邮件”，并键入新的电子邮件。
   3. 在“其他电子邮件”旁边，选择“添加电子邮件”。 选择“添加”，键入新的电子邮件，然后选择“保存”。
   4. 选择页面底部的“保存”按钮以保存所有更改。

5. 在“概述”选项卡上的“我的源”下，选择“B2B 协作”磁贴中的“重置兑换状态”链接。

   

6. 在“重置兑换状态”下，选择“重置”。

   

使用 PowerShell 或 Microsoft Graph API 重置兑换状态

重置用于登录的电子邮件地址

用户想要使用其他电子邮件登录时：

1. 请确保将新的电子邮件地址添加到用户对象的 mail 或 otherMails 属性。
2. 将 InvitedUserEmailAddress 属性中的电子邮件地址替换为新的电子邮件地址。
3. 使用以下方法之一重置用户的兑换状态。

使用 PowerShell 重置兑换状态

Install-Module Microsoft.Graph
Connect-MgGraph -Environment China -ClientId 'YOUR_CLIENT_ID' -TenantId 'YOUR_TENANT_ID' -Scopes "User.ReadWrite.All"

$user = Get-MgUser -Filter "startsWith(mail, 'john.doe@fabrikam.net')"
New-MgInvitation `
    -InvitedUserEmailAddress $user.Mail `
    -InviteRedirectUrl "https://myapplications.windowsazure.cn" `
    -ResetRedemption `
    -SendInvitationMessage `
    -InvitedUser $user

使用 Microsoft Graph API 重置兑换状态

要使用 Microsoft Graph 邀请 API，请将 resetRedemption 属性设置为 true，并在 invitedUserEmailAddress 属性中指定新电子邮件地址。

POST https://microsoftgraph.chinacloudapi.cn/v1.0/invitations  
Authorization: Bearer eyJ0eX...  
ContentType: application/json  
{  
   "invitedUserEmailAddress": "<<external email>>",  
   "sendInvitationMessage": true,  
   "invitedUserMessageInfo": {  
      "messageLanguage": "en-US",  
      "ccRecipients": [  
         {  
            "emailAddress": {  
               "name": null,  
               "address": "<<optional additional notification email>>"  
            }  
         } 
      ],  
      "customizedMessageBody": "<<custom message>>"  
},  
"inviteRedirectUrl": "https://myapplications.windowsazure.cn?tenantId=",  
"invitedUser": {  
   "id": "<<ID for the user you want to reset>>"  
}, 
"resetRedemption": true 
}

下一步

• Microsoft Entra B2B 来宾用户的属性