Merge pull request #216352 from MicrosoftDocs/main

10/28 AM Publish

Author: huypub

articles/active-directory/external-identities/media/tutorial-bulk-invite/bulk-invite-button.png

@@ -1,13 +1,13 @@
 ---
 
 title: Tutorial for bulk inviting B2B collaboration users - Azure AD
-description: In this tutorial, you learn how to use PowerShell and a CSV file to send bulk invitations to external Azure AD B2B collaboration users. You'll use the Microsoft.Graph.Users PowerShell module.
+description: In this tutorial, you learn how to send bulk invitations using a CSV file to external Azure AD B2B collaboration users. 
 
 services: active-directory
 ms.service: active-directory
 ms.subservice: B2B
 ms.topic: tutorial
-ms.date: 02/16/2022
+ms.date: 10/24/2022
 
 ms.author: mimart
 author: msmimart
@@ -16,64 +16,48 @@ manager: celestedg
 # Customer intent: As a tenant administrator, I want to send B2B invitations to multiple external users at the same time so that I can avoid having to send individual invitations to each user.
 
 ms.collection: M365-identity-device-management
+ms.custom: engagement-fy23
 ---
 
 # Tutorial: Bulk invite Azure AD B2B collaboration users
 
-If you use Azure Active Directory (Azure AD) B2B collaboration to work with external partners, you can invite multiple guest users to your organization at the same time. In this tutorial, you learn how to use the Azure portal to send bulk invitations to external users. Specifically, you'll follow these steps:
+If you use [Azure Active Directory (Azure AD) B2B collaboration](what-is-b2b.md) to work with external partners, you can invite multiple guest users to your organization at the same time. In this tutorial, you learn how to use the Azure portal to send bulk invitations to external users. Specifically, you'll follow these steps:
 
 > [!div class="checklist"]
+>
 > * Use **Bulk invite users** to prepare a comma-separated value (.csv) file with the user information and invitation preferences
 > * Upload the .csv file to Azure AD
 > * Verify the users were added to the directory
 
 If you don’t have Azure Active Directory, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
 
-## Understand the CSV template
-
-Download and fill in the bulk upload CSV template to help you successfully invite Azure AD guest users in bulk. The CSV template you download might look like this example:
-
-![Spreadsheet for upload and call-outs explaining the purpose and values for each row and column](media/tutorial-bulk-invite/understand-template.png)
-
-### CSV template structure
-
-The rows in a downloaded CSV template are as follows:
-
-- **Version number**: The first row containing the version number must be included in the upload CSV.
-- **Column headings**: The format of the column headings is <*Item name*> [PropertyName] <*Required or blank*>. For example, `Email address to invite [inviteeEmail] Required`. Some older versions of the template might have slight variations.
-- **Examples row**: We've included in the template a row of examples of values for each column. You must remove the examples row and replace it with your own entries.
-
-### Additional guidance
-
-- The first two rows of the upload template must not be removed or modified, or the upload can't be processed.
-- The required columns are listed first.
-- We don't recommend adding new columns to the template. Any columns you add are ignored and not processed.
-- We recommend that you download the latest version of the CSV template as often as possible.
 
 ## Prerequisites
 
 You need two or more test email accounts that you can send the invitations to. The accounts must be from outside your organization. You can use any type of account, including social accounts such as gmail.com or outlook.com addresses.
 
+
 ## Invite guest users in bulk
 
 1. Sign in to the Azure portal with an account that is a global administrator in the organization.
 2. In the navigation pane, select **Azure Active Directory**.
 3. Under **Manage**, select **All Users**.
 4. Select **Bulk operations** > **Bulk invite**.
 
-    ![Bulk invite button](media/tutorial-bulk-invite/bulk-invite-button.png)
+    :::image type="content" source="media/tutorial-bulk-invite/bulk-invite-button.png" alt-text="Screenshot of the bulk invite button.":::
 
-4. On the **Bulk invite users** page, select **Download** to get a valid .csv template with invitation properties.
 
-     ![Download the CSV file](media/tutorial-bulk-invite/download-button.png)
+4. On the **Bulk invite users** page, select **Download** to get a [valid .csv template](tutorial-bulk-invite.md#understand-the-csv-template) with invitation properties.
+
+    :::image type="content" source="media/tutorial-bulk-invite/download-button.png" alt-text="Screenshot of the download the csv file button.":::
 
 1. Open the .csv template and add a line for each guest user. Required values are:
 
    * **Email address to invite** - the user who will receive an invitation
 
    * **Redirection url** - the URL to which the invited user is forwarded after accepting the invitation. If you want to forward the user to the My Apps page, you must change this value to https://myapps.microsoft.com or https://myapplications.microsoft.com.
 
-    ![Example of a CSV file with guest users entered](media/tutorial-bulk-invite/bulk-invite-csv.png)
+    :::image type="content" source="media/tutorial-bulk-invite/bulk-invite-csv.png" alt-text="Screenshot of the example csv file with guest users entered.":::
 
    > [!NOTE]
    > Don't use commas in the **Customized invitation message** because they'll prevent the message from being parsed successfully.
@@ -84,10 +68,34 @@ You need two or more test email accounts that you can send the invitations to. T
 9. When your file passes validation, select **Submit** to start the Azure bulk operation that adds the invitations. 
 10. To view the job status, select **Click here to view the status of each operation**. Or, you can select **Bulk operation results** in the **Activity** section. For details about each line item within the bulk operation, select the values under the **# Success**, **# Failure**, or **Total Requests** columns. If failures occurred, the reasons for failure will be listed.
 
-    ![Example of bulk operation results](media/tutorial-bulk-invite/bulk-operation-results.png)
+    :::image type="content" source="media/tutorial-bulk-invite/bulk-operation-results.png" alt-text="Screenshot of the bulk operation results." lightbox="media/tutorial-bulk-invite/bulk-operation-results.png":::
+
 
 11. When the job completes, you'll see a notification that the bulk operation succeeded.
 
+
+## Understand the CSV template
+
+Download and fill in the bulk upload CSV template to help you successfully invite Azure AD guest users in bulk. The CSV template you download might look like this example:
+
+![Spreadsheet for upload and call-outs explaining the purpose and values for each row and column](media/tutorial-bulk-invite/understand-template.png)
+
+### CSV template structure
+
+The rows in a downloaded CSV template are as follows:
+
+- **Version number**: The first row containing the version number must be included in the upload CSV.
+- **Column headings**: The format of the column headings is <*Item name*> [PropertyName] <*Required or blank*>. For example, `Email address to invite [inviteeEmail] Required`. Some older versions of the template might have slight variations.
+- **Examples row**: We've included in the template a row of examples of values for each column. You must remove the examples row and replace it with your own entries.
+
+### Additional guidance
+
+- The first two rows of the upload template must not be removed or modified, or the upload can't be processed.
+- The required columns are listed first.
+- We don't recommend adding new columns to the template. Any columns you add are ignored and not processed.
+- We recommend that you download the latest version of the CSV template as often as possible.
+
+
 ## Verify guest users in the directory
 
 Check to see that the guest users you added exist in the directory either in the Azure portal or by using PowerShell.
@@ -128,7 +136,8 @@ For example: `Remove-MgUser -UserId "lstokes_fabrikam.com#EXT#@contoso.onmicroso
 
 ## Next steps
 
-In this tutorial, you sent bulk invitations to guest users outside of your organization. Next, learn how the invitation redemption process works.
+In this tutorial, you sent bulk invitations to guest users outside of your organization. Next, learn how the invitation redemption process works, and how to enforce multi-factor authentication for guest users.
+
 
-> [!div class="nextstepaction"]
-> [Learn about the Azure AD B2B collaboration invitation redemption process](redemption-experience.md)
+- [Learn about the Azure AD B2B collaboration invitation redemption process](redemption-experience.md)
+- [Enforce multi-factor authentication for B2B guest users](b2b-tutorial-require-mfa.md)

articles/active-directory/external-identities/media/tutorial-bulk-invite/bulk-operation-results.png

@@ -44,7 +44,7 @@ The [back up and restore](../manage-backup.md) feature allows you to keep your a
 :::image type="content" source="./media/migration/configure-custom-backup.png" alt-text="Screenshot that shows how to configure custom backup for an App Service app.":::
 >
 
-The step-by-step instructions in the current documentation for [backup and restore](../manage-backup.md) should be sufficient to allow you to use this feature. You can select a custom backup and use that to restore the app to an App Service in your App Service Environment v3.
+You can select a custom backup and restore it to an App Service in your App Service Environment v3. You must create the App Service you will restore to before restoring the app. You can choose to restore the backup to the production slot, an existing slot, or a newly created slot that you can create during the restoration process.
 
 :::image type="content" source="./media/migration/back-up-restore-sample.png" alt-text="Screenshot that shows how to use backup to restore App Service app in App Service Environment v3.":::