Skip to content

Commit 61dd3ca

Browse files
committed
Merge branch 'master' of https://github.com/MicrosoftDocs/azure-docs-pr into release-sf-7.1
2 parents 6f8ed19 + 9cb309a commit 61dd3ca

File tree

363 files changed

+6455
-1364
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

363 files changed

+6455
-1364
lines changed

.openpublishing.redirection.json

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -423,12 +423,17 @@
423423
},
424424
{
425425
"source_path": "articles/active-directory/saas-apps/realtimeboard-tutorial.md",
426-
"redirect_url": "/articles/active-directory/saas-apps/miro-tutorial",
426+
"redirect_url": "/azure/active-directory/saas-apps/miro-tutorial",
427427
"redirect_document_id": false
428428
},
429429
{
430430
"source_path": "articles/active-directory/saas-apps/redbrickhealth-tutorial.md",
431-
"redirect_url": "/articles/active-directory/saas-apps/redbrick-health-tutorial",
431+
"redirect_url": "/azure/active-directory/saas-apps/redbrick-health-tutorial",
432+
"redirect_document_id": false
433+
},
434+
{
435+
"source_path": "articles/active-directory/saas-apps/adobe-identity-management-tutorial.md",
436+
"redirect_url": "/azure/active-directory/saas-apps/tutorial-list",
432437
"redirect_document_id": false
433438
},
434439
{
@@ -40082,12 +40087,12 @@
4008240087
},
4008340088
{
4008440089
"source_path": "articles/iot-central/tutorial-add-device-pnp.md",
40085-
"redirect_url": "/azure/iot-central/core/tutorial-connect-pnp-device",
40090+
"redirect_url": "/azure/iot-central/core/quick-create-pnp-device",
4008640091
"redirect_document_id": false
4008740092
},
4008840093
{
4008940094
"source_path": "articles/iot-central/tutorial-define-device-type-pnp.md",
40090-
"redirect_url": "/azure/iot-central/core/howto-set-up-template",
40095+
"redirect_url": "/azure/iot-central/core/quick-create-pnp-device",
4009140096
"redirect_document_id": false
4009240097
},
4009340098
{
@@ -46282,7 +46287,7 @@
4628246287
},
4628346288
{
4628446289
"source_path": "articles/iot-central/quick-create-pnp-device-pnp.md",
46285-
"redirect_url": "/azure/iot-central/core/quick-create-simulated-device/",
46290+
"redirect_url": "/azure/iot-central/core/quick-create-pnp-device/",
4628646291
"redirect_document_id": false
4628746292
},
4628846293
{
@@ -46347,12 +46352,7 @@
4634746352
},
4634846353
{
4634946354
"source_path": "articles/iot-central/core/quick-create-pnp-device-pnp.md",
46350-
"redirect_url": "/azure/iot-central/core/quick-create-simulated-device/",
46351-
"redirect_document_id": false
46352-
},
46353-
{
46354-
"source_path": "articles/iot-central/core/quick-create-pnp-device.md",
46355-
"redirect_url": "/azure/iot-central/core/quick-create-simulated-device/",
46355+
"redirect_url": "/azure/iot-central/core/quick-create-pnp-device/",
4635646356
"redirect_document_id": false
4635746357
},
4635846358
{
@@ -46787,7 +46787,7 @@
4678746787
},
4678846788
{
4678946789
"source_path": "articles/iot-central/preview/quick-create-pnp-device.md",
46790-
"redirect_url": "/azure/iot-central/core/quick-create-simulated-device/",
46790+
"redirect_url": "/azure/iot-central/core/quick-create-pnp-device/",
4679146791
"redirect_document_id": false
4679246792
},
4679346793
{
Lines changed: 100 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,100 @@
1+
---
2+
title: Invite internal users to B2B collaboration - Azure AD
3+
description: If you have internal user accounts for partners, distributors, suppliers, vendors, and other guests, you can change to Azure AD B2B collaboration by inviting them to sign in with their own external credentials or login. Use either PowerShell or the Microsoft Graph invitation API.
4+
5+
services: active-directory
6+
ms.service: active-directory
7+
ms.subservice: B2B
8+
ms.topic: conceptual
9+
ms.date: 04/12/2020
10+
11+
ms.author: mimart
12+
author: msmimart
13+
manager: celestedg
14+
ms.reviewer: mal
15+
16+
ms.collection: M365-identity-device-management
17+
---
18+
19+
# Invite internal users to B2B collaboration
20+
21+
| |
22+
| --- |
23+
| Inviting internal users to use B2B collaboration is a public preview feature of Azure Active Directory. For more information about previews, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/). |
24+
| |
25+
26+
Before the availability of Azure AD B2B collaboration, organizations could collaborate with distributors, suppliers, vendors, and other guest users by setting up internal credentials for them. If you have internal guest users like this, you can invite them to use B2B collaboration so you can take advantage of Azure AD B2B benefits. Your B2B guest users will be able to use their own identities and credentials to sign in, and you won’t need to maintain passwords or manage account lifecycles.
27+
28+
Sending an invitation to an existing internal account lets you retain that user’s object ID, UPN, group memberships, and app assignments. You don’t need to manually delete and re-invite the user or reassign resources. To invite the user, you’ll use the invitation API to pass both the internal user object and the guest user’s email address along with the invitation. When the user accepts the invitation, the B2B service changes the existing internal user object to a B2B user. Going forward, the user must sign in to cloud resources services using their B2B credentials. They can still use their internal credentials to access on premises resources, but you can prevent this by resetting or changing the password on the internal account.
29+
30+
> [!NOTE]
31+
> Invitation is one-way. You can invite internal users to use B2B collaboration, but you can’t remove the B2B credentials once they’re added. To change the user back to an internal-only user, you’ll need to delete the user object and create a new one.
32+
33+
While in public preview, the method described in this article for inviting internal users to B2B collaboration can’t be used in these instances:
34+
35+
- The internal user has already been assigned an Exchange license.
36+
- The user is from a domain that is set up for direct federation in your directory.
37+
- The internal user is a cloud-only account, and their main account isn't in Azure AD.
38+
39+
In these instances, if the internal user must be changed to a B2B user, you should delete the internal account and send the user an invitation for B2B collaboration.
40+
41+
**On-premises synced users**: For user accounts that are synced between on-premises and the cloud, the on-premises directory remains the source of authority after they’re invited to use B2B collaboration. Any changes you make to the on-premises account will sync to the cloud account, including disabling or deleting the account. Therefore, you can’t prevent the user from signing into their on-premises account while retaining their cloud account by simply deleting the on-premises account. Instead, you can set the on-premises account password to a random GUID or other unknown value.
42+
43+
## How to invite internal users to B2B collaboration
44+
45+
You can use PowerShell or the invitation API to send a B2B invitation to the internal user. Make sure the email address you want to use for the invitation is set as the external email address on the internal user object.
46+
47+
- For a cloud-only user, use the email address in the User.OtherMails property for the invitation.
48+
- For an on-premises synced user, you must use the value in the User.Mail property for the invitation.
49+
- The domain in the user’s Mail property must match the account they’re using to sign in. Otherwise, some services such as Teams won't be able to authenticate the user.
50+
51+
By default, the invitation will send the user an email letting them know they’ve been invited, but you can suppress this email and send your own instead.
52+
53+
> [!NOTE]
54+
> To send your own email or other communication, you can use New-AzureADMSInvitation with -SendInvitationMessage:$false to invite users silently, and then send your own email message to the converted user. See [Azure AD B2B collaboration API and customization](customize-invitation-api.md).
55+
56+
## Use PowerShell to send a B2B invitation
57+
58+
Use the following command to invite the user to B2B collaboration:
59+
60+
```powershell
61+
Uninstall-Module AzureADPreview
62+
Install-Module AzureADPreview
63+
$ADGraphUser = Get-AzureADUser -searchstring "<<external email>>"
64+
$msGraphUser = New-Object Microsoft.Open.MSGraph.Model.User -ArgumentList $ADGraphUser.ObjectId
65+
New-AzureADMSInvitation -InvitedUserEmailAddress <<external email>> -SendInvitationMessage $True -InviteRedirectUrl "http://myapps.microsoft.com" -InvitedUser $msGraphUser
66+
```
67+
68+
## Use the invitation API to send a B2B invitation
69+
70+
The sample below illustrates how to call the invitation API to invite an internal user as a B2B user.
71+
72+
```json
73+
POST https://graph.microsoft.com/v1.0/invitations
74+
Authorization: Bearer eyJ0eX...
75+
ContentType: application/json
76+
{
77+
    "invitedUserEmailAddress": "<<external email>>"",
78+
    "sendInvitationMessage": true,
79+
    "invitedUserMessageInfo": {
80+
        "messageLanguage": "en-US",
81+
        "ccRecipients": [
82+
            {
83+
                "emailAddress": {
84+
                    "name": null,
85+
                    "address": "<<optional additional notification email>>""
86+
                }
87+
            }
88+
        ],
89+
        "customizedMessageBody": "<<custom message>>"
90+
    },
91+
    "inviteRedirectUrl": "https://myapps.microsoft.com?tenantId=",
92+
    "invitedUser": {"id": "<<ID for the user you want to convert>>"}
93+
}
94+
```
95+
96+
The response to the API is the same response you get when you invite a new guest user to the directory.
97+
98+
## Next steps
99+
100+
- [B2B collaboration invitation redemption](redemption-experience.md)

articles/active-directory/b2b/toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -63,6 +63,8 @@
6363
href: add-users-administrator.md
6464
- name: Information workers adding B2B users
6565
href: add-users-information-worker.md
66+
- name: Invite internal users to B2B
67+
href: invite-internal-users.md
6668
- name: Google federation
6769
href: google-federation.md
6870
- name: One-time passcode authentication

articles/active-directory/reports-monitoring/concept-activity-logs-azure-monitor.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -95,12 +95,13 @@ Events are batched into approximately five-minute intervals and sent as a single
9595

9696
For example, about 18 events per second ordinarily occur for a large tenant of more than 100,000 users, a rate that equates to 5,400 events every five minutes. Because audit logs are about 2 KB per event, this equates to 10.8 MB of data. Therefore, 43 messages are sent to the event hub in that five-minute interval.
9797

98-
The following table contains estimated costs per month for a basic event hub in West US, depending on the volume of event data. To calculate an accurate estimate of the data volume that you anticipate for your application, use the [Event Hubs pricing calculator](https://azure.microsoft.com/pricing/details/event-hubs/).
98+
The following table contains estimated costs per month for a basic event hub in West US, depending on the volume of event data which can vary from tenant to tenant as per many factors like user sign-in behaviour etc. To calculate an accurate estimate of the data volume that you anticipate for your application, use the [Event Hubs pricing calculator](https://azure.microsoft.com/pricing/details/event-hubs/).
9999

100100
| Log category | Number of users | Events per second | Events per five-minute interval | Volume per interval | Messages per interval | Messages per month | Cost per month (est.) |
101101
|--------------|-----------------|-------------------------|----------------------------------------|---------------------|---------------------------------|------------------------------|----------------------------|
102102
| Audit | 100,000 | 18 | 5,400 | 10.8 MB | 43 | 371,520 | $10.83 |
103103
| Audit | 1,000 | 0.1 | 52 | 104 KB | 1 | 8,640 | $10.80 |
104+
| Sign-ins | 100,000 | 18000 | 5,400,000 | 10.8 GB | 42188 | 364,504,320 | $23.9 |
104105
| Sign-ins | 1,000 | 178 | 53,400 | 106.8&nbsp;MB | 418 | 3,611,520 | $11.06 |
105106

106107
### Azure Monitor logs cost considerations

0 commit comments

Comments
 (0)