Public Preview refresh tutorials

Author: OWinfreyATL

articles/active-directory/governance/tutorial-offboard-custom-workflow-portal.md

@@ -1,24 +1,24 @@
 ---
-title: 'Execute employee offboarding tasks in real-time on their last day of work with Azure portal (preview)'
+title: 'Execute employee off-boarding tasks in real-time on their last day of work with Azure portal (preview)'
 description: Tutorial for off-boarding users from an organization using Lifecycle workflows with Azure portal (preview).
 services: active-directory
-author: amsliu
+author: owinfreyATL
 manager: amycolannino
 ms.service: active-directory
 ms.workload: identity
 ms.topic: tutorial
 ms.subservice: compliance
-ms.date: 08/18/2022
-ms.author: amsliu
+ms.date: 03/18/2023
+ms.author: owinfrey
 ms.reviewer: krbain
 ms.custom: template-tutorial
 ---
 
-# Execute employee offboarding tasks in real-time on their last day of work with Azure portal (preview)
+# Execute employee off-boarding tasks in real-time on their last day of work with Azure portal (preview)
 
 This tutorial provides a step-by-step guide on how to execute a real-time employee termination with Lifecycle workflows using the Azure portal.
 
-This off-boarding scenario will run a workflow on-demand and accomplish the following tasks:
+This off-boarding scenario runs a workflow on-demand and accomplishes the following tasks:
 
 1. Remove user from all groups
 2. Remove user from all Teams
@@ -33,7 +33,7 @@ The Lifecycle Workflows preview requires Azure AD Premium P2. For more informati
 
 ##  Before you begin
 
-As part of the prerequisites for completing this tutorial, you'll need an account that has group and Teams memberships and that can be deleted during the tutorial. For more comprehensive instructions on how to complete these prerequisite steps, you may refer to  the [Preparing user accounts for Lifecycle workflows tutorial](tutorial-prepare-azure-ad-user-accounts.md).
+As part of the prerequisites for completing this tutorial, you need an account that has group and Teams memberships and that can be deleted during the tutorial. For more comprehensive instructions on how to complete these prerequisite steps, you may refer to  the [Preparing user accounts for Lifecycle workflows tutorial](tutorial-prepare-azure-ad-user-accounts.md).
 
 The leaver scenario can be broken down into the following:
 -	**Prerequisite:** Create a user account that represents an employee leaving your organization
@@ -55,7 +55,7 @@ Use the following steps to create a leaver on-demand workflow that will execute
  6. From the templates, select **Select** under **Real-time employee termination**.
    :::image type="content" source="media/tutorial-lifecycle-workflows/select-template.png" alt-text="Screenshot of selecting template leaver workflow." lightbox="media/tutorial-lifecycle-workflows/select-template.png":::
 
- 7. Next, you'll configure the basic information about the workflow. Select **Next:Review tasks** when you're done with this step. 
+ 7. Next, you configure the basic information about the workflow. Select **Next:Review tasks** when you're done with this step. 
    :::image type="content" source="media/tutorial-lifecycle-workflows/real-time-leaver.png" alt-text="Screenshot of review template tasks." lightbox="media/tutorial-lifecycle-workflows/real-time-leaver.png":::
 
  8. On the following page, you may inspect the tasks if desired but no additional configuration is needed. Select **Next: Select users** when you're finished.
@@ -67,7 +67,7 @@ Use the following steps to create a leaver on-demand workflow that will execute
  10. Next, select on **+Add users** to designate the users to be executed on this workflow.
    :::image type="content" source="media/tutorial-lifecycle-workflows/real-time-add-users.png" alt-text="Screenshot of real time leaver add users." lightbox="media/tutorial-lifecycle-workflows/real-time-add-users.png":::
 
- 11. A panel with the list of available users will pop up on the right side of the screen. Select **Select** when you're done with your selection.
+ 11. A panel with the list of available users pops up on the right side of the screen. Select **Select** when you're done with your selection.
    :::image type="content" source="media/tutorial-lifecycle-workflows/real-time-user-list.png" alt-text="Screenshot of real time leaver template selected users." lightbox="media/tutorial-lifecycle-workflows/real-time-user-list.png":::
 
  12. Select **Next: Review and create** when you're satisfied with your selection.
@@ -77,7 +77,7 @@ Use the following steps to create a leaver on-demand workflow that will execute
    :::image type="content" source="media/tutorial-lifecycle-workflows/real-time-create.png" alt-text="Screenshot of creating real time leaver workflow." lightbox="media/tutorial-lifecycle-workflows/real-time-create.png":::
 
 ## Run the workflow 
-Now that the workflow is created, it will automatically run the workflow every 3 hours. Lifecycle workflows will check every 3 hours for users in the associated execution condition and execute the configured tasks for those users.  However, for the tutorial, we would like to run it immediately. To run a workflow immediately, we can use the on-demand feature.
+Now that the workflow is created, it will automatically run the workflow every 3 hours. Lifecycle workflows check every 3 hours for users in the associated execution condition and execute the configured tasks for those users.  However, for the tutorial, we would like to run it immediately. To run a workflow immediately, we can use the on-demand feature.
 
 >[!NOTE]
 >Be aware that you currently cannot run a workflow on-demand if it is set to disabled.  You need to set the workflow to enabled to use the on-demand feature.
@@ -92,12 +92,12 @@ To run a workflow on-demand, for users using the Azure portal, do the following
 
 ## Check tasks and workflow status
 
-At any time, you may monitor the status of the workflows and the tasks. As a reminder, there are three different data pivots, users runs, and tasks that are currently available in public preview. You may learn more in the how-to guide [Check the status of a workflow (preview)](check-status-workflow.md). In the course of this tutorial, we'll look at the status using the user focused reports.
+At any time, you may monitor the status of the workflows and the tasks. As a reminder, there are three different data pivots, users runs, and tasks that are currently available in public preview. You may learn more in the how-to guide [Check the status of a workflow (preview)](check-status-workflow.md). In the course of this tutorial, we look at the status using the user focused reports.
 
- 1. To begin, select the **Workflow history (Preview)** tab on the left to view the user summary and associated workflow tasks and statuses.  
+ 1. To begin, select the **Workflow history (Preview)** tab to view the user summary and associated workflow tasks and statuses.  
  :::image type="content" source="media/tutorial-lifecycle-workflows/workflow-history-real-time.png" alt-text="Screenshot of real time history overview." lightbox="media/tutorial-lifecycle-workflows/workflow-history-real-time.png":::
 
-1. Once the **Workflow history (Preview)** tab has been selected, you'll land on the workflow history page as shown.
+1. Once the **Workflow history (Preview)** tab has been selected, you land on the workflow history page as shown.
  :::image type="content" source="media/tutorial-lifecycle-workflows/user-summary-real-time.png" alt-text="Screenshot of real time workflow history." lightbox="media/tutorial-lifecycle-workflows/user-summary-real-time.png":::
 
 1. Next, you may select **Total tasks** for the user Jane Smith to view the total number of tasks created and their statuses. In this example, there are three total tasks assigned to the user Jane Smith.  

articles/active-directory/governance/tutorial-onboard-custom-workflow-portal.md

@@ -2,14 +2,14 @@
 title: 'Automate employee onboarding tasks before their first day of work with Azure portal (preview)'
 description: Tutorial for onboarding users to an organization using Lifecycle workflows with Azure portal (preview).
 services: active-directory
-author: amsliu
+author: owinfreyATL
 manager: amycolannino
 ms.service: active-directory
 ms.workload: identity
 ms.topic: tutorial
 ms.subservice: compliance
-ms.date: 08/18/2022
-ms.author: amsliu
+ms.date: 03/18/2023
+ms.author: owinfrey
 ms.reviewer: krbain
 ms.custom: template-tutorial
 ---
@@ -45,7 +45,7 @@ Detailed breakdown of the relevant attributes:
  |employeeHireDate|Used to trigger the workflow|Employee|
  |department|Used to provide the scope for the workflow|Employee|
 
-The prehire scenario can be broken down into the following:
+The pre-hire scenario can be broken down into the following:
   - **Prerequisite:** Create two user accounts, one to represent an employee and one to represent a manager
   - **Prerequisite:** Editing the attributes required for this scenario in the portal
   - **Prerequisite:** Edit the attributes for this scenario using Microsoft Graph Explorer
@@ -54,8 +54,8 @@ The prehire scenario can be broken down into the following:
   - Triggering the workflow
   - Verifying the workflow was successfully executed
 
-## Create a workflow using pre-hire template
-Use the following steps to create a prehire workflow that will generate a TAP and send it via email to the user's manager using the Azure portal.
+## Create a workflow using prehire template
+Use the following steps to create a pre-hire workflow that generates a TAP and send it via email to the user's manager using the Azure portal.
 
  1.  Sign in to Azure portal.
  2.  On the right, select **Azure Active Directory**.
@@ -67,11 +67,11 @@ Use the following steps to create a prehire workflow that will generate a TAP an
  6. From the templates, select **select** under **Onboard pre-hire employee**.
   :::image type="content" source="media/tutorial-lifecycle-workflows/select-template.png" alt-text="Screenshot of selecting workflow template." lightbox="media/tutorial-lifecycle-workflows/select-template.png":::
 
- 7.  Next, you'll configure the basic information about the workflow.  This information includes when the workflow triggers, known as **Days from event**.  So in this case, the workflow triggers two days before the employee's hire date.  On the onboard prehire employee screen, add the following settings and then select **Next: Configure Scope**.
+ 7.  Next, you configure the basic information about the workflow.  This information includes when the workflow triggers, known as **Days from event**.  So in this case, the workflow triggers two days before the employee's hire date.  On the onboard pre-hire employee screen, add the following settings and then select **Next: Configure Scope**.
 
      :::image type="content" source="media/tutorial-lifecycle-workflows/configure-scope.png" alt-text="Screenshot of selecting a configuration scope." lightbox="media/tutorial-lifecycle-workflows/configure-scope.png":::
 
-   8.  Next, you'll configure the scope. The scope determines which users this workflow runs against.  In this case, it is on all users in the Sales department.  On the configure scope screen, under **Rule** add the following settings and then select **Next: Review tasks**. For a full list of supported user properties, see [Supported user properties and query parameters](/graph/api/resources/identitygovernance-rulebasedsubjectset?view=graph-rest-beta&preserve-view=true#supported-user-properties-and-query-parameters).
+   8.  Next, you configure the scope. The scope determines which users this workflow runs against.  In this case, it is on all users in the Sales department.  On the configure scope screen, under **Rule** add the following settings and then select **Next: Review tasks**. For a full list of supported user properties, see [Supported user properties and query parameters](/graph/api/resources/identitygovernance-rulebasedsubjectset?view=graph-rest-beta&preserve-view=true#supported-user-properties-and-query-parameters).
 
        :::image type="content" source="media/tutorial-lifecycle-workflows/review-tasks.png" alt-text="Screenshot of selecting review tasks." lightbox="media/tutorial-lifecycle-workflows/review-tasks.png":::
 
@@ -99,12 +99,12 @@ To run a workflow on-demand, for users using the Azure portal, do the following
 
 ## Check tasks and workflow status
 
-At any time, you may monitor the status of the workflows and the tasks. As a reminder, there are three different data pivots, users runs, and tasks that are currently available in public preview. You may learn more in the how-to guide [Check the status of a workflow (preview)](check-status-workflow.md). In the course of this tutorial, we'll look at the status using the user focused reports.
+At any time, you may monitor the status of the workflows and the tasks. As a reminder, there are three different data pivots, users runs, and tasks that are currently available in public preview. You may learn more in the how-to guide [Check the status of a workflow (preview)](check-status-workflow.md). In the course of this tutorial, we look at the status using the user focused reports.
 
- 1. To begin, select the **Workflow history (Preview)** tab on the left to view the user summary and associated workflow tasks and statuses.  
+ 1. To begin, select the **Workflow history (Preview)** tab to view the user summary and associated workflow tasks and statuses.  
  :::image type="content" source="media/tutorial-lifecycle-workflows/workflow-history.png" alt-text="Screenshot of workflow History status." lightbox="media/tutorial-lifecycle-workflows/workflow-history.png":::
 
-1. Once the **Workflow history (Preview)** tab has been selected, you'll land on the workflow history page as shown.
+1. Once the **Workflow history (Preview)** tab has been selected, you land on the workflow history page as shown.
  :::image type="content" source="media/tutorial-lifecycle-workflows/user-summary.png" alt-text="Screenshot of workflow history overview" lightbox="media/tutorial-lifecycle-workflows/user-summary.png":::
 
 1. Next, you may select **Total tasks** for the user Jane Smith to view the total number of tasks created and their statuses. In this example, there are three total tasks assigned to the user Jane Smith.  

articles/active-directory/governance/tutorial-prepare-azure-ad-user-accounts.md

@@ -2,20 +2,20 @@
 title: 'Tutorial: Preparing user accounts for Lifecycle workflows (preview)'
 description: Tutorial for preparing user accounts for Lifecycle workflows (preview).
 services: active-directory
-author: amsliu
+author: owinfreyATL
 manager: amycolannino
 ms.service: active-directory
 ms.workload: identity
 ms.topic: tutorial
 ms.subservice: compliance
-ms.date: 06/13/2022
-ms.author: amsliu
+ms.date: 03/18/2023
+ms.author: owinfrey
 ms.reviewer: krbain
 ms.custom: template-tutorial
 ---
 # Preparing user accounts for Lifecycle workflows tutorials (Preview)
 
-For the on-boarding and off-boarding tutorials you'll need accounts for which the workflows will be executed, the following section will help you prepare these accounts, if you already have test accounts that meet the following requirements you can proceed directly to the on-boarding and off-boarding tutorials. Two accounts are required for the on-boarding tutorials, one account for the new hire and another account that acts as the manager of the new hire. The new hire account must have the following attributes set:
+For the on-boarding and off-boarding tutorials you need accounts for which the workflows will be executed, the following section helps you prepare these accounts, if you already have test accounts that meet the following requirements you can proceed directly to the on-boarding and off-boarding tutorials. Two accounts are required for the on-boarding tutorials, one account for the new hire and another account that acts as the manager of the new hire. The new hire account must have the following attributes set:
 
 - employeeHireDate must be set to today
 - department must be set to sales
@@ -27,30 +27,30 @@ The off-boarding tutorials only require one account that has group and Teams mem
 
 [!INCLUDE [active-directory-p2-license.md](../../../includes/active-directory-p2-license.md)] 
 - An Azure AD tenant
-- A global administrator account for the Azure AD tenant.  This account will be used to create our users and workflows.
+- A global administrator account for the Azure AD tenant.  This account is used to create our users and workflows.
 
 ## Before you begin
 
-In most cases, users are going to be provisioned to Azure AD either from an on-premises solution (Azure AD Connect, Cloud sync, etc.) or with an HR solution. These users will have the attributes and values populated at the time of creation. Setting up the infrastructure to provision users is outside the scope of this tutorial. For information, see [Tutorial: Basic Active Directory environment](../cloud-sync/tutorial-basic-ad-azure.md) and [Tutorial: Integrate a single forest with a single Azure AD tenant](../cloud-sync/tutorial-single-forest.md)
+In most cases, users are going to be provisioned to Azure AD either from an on-premises solution (Azure AD Connect, Cloud sync, etc.) or with an HR solution. These users have the attributes and values populated at the time of creation. Setting up the infrastructure to provision users is outside the scope of this tutorial. For information, see [Tutorial: Basic Active Directory environment](../cloud-sync/tutorial-basic-ad-azure.md) and [Tutorial: Integrate a single forest with a single Azure AD tenant](../cloud-sync/tutorial-single-forest.md)
 
 ## Create users in Azure AD
 
-We'll use the Graph Explorer to quickly create two users needed to execute the Lifecycle Workflows in the tutorials.  One user will represent our new employee and the second will represent the new employee's manager.
+We use the Graph Explorer to quickly create two users needed to execute the Lifecycle Workflows in the tutorials.  One user represents our new employee and the second represents the new employee's manager.
 
-You'll need to edit the POST and replace the <your tenant name here> portion with the name of your tenant.  For example:   $UPN_manager = "bsimon@<your tenant name here>" to $UPN_manager = "[email protected]".  
+You need to edit the POST and replace the <your tenant name here> portion with the name of your tenant.  For example:   $UPN_manager = "bsimon@<your tenant name here>" to $UPN_manager = "[email protected]".  
 
 >[!NOTE]
 >Be aware that a workflow will not trigger when the employee hire date (Days from event) is prior to the workflow creation date. You must set a employeeHiredate in the future by design.  The dates used in this tutorial are a snapshot in time.  Therefore, you should change the dates accordingly to accommodate for this situation.
 
-First we'll create our employee, Melva Prince.
+First we create our employee, Melva Prince.
 
  1. Now navigate to [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer).
  2. Sign-in to Graph Explorer with the global administrator account for your tenant.
  3. At the top, change **GET** to **POST** and add `https://graph.microsoft.com/v1.0/users/` to the box. 
  4. Copy the code below in to the **Request body** 
  5. Replace `<your tenant here>` in the code below with the value of your Azure AD tenant.
  6. Select **Run query**
- 7. Copy the ID that is returned in the results.  This will be used later to assign a manager.
+ 7. Copy the ID that is returned in the results.  This is used later to assign a manager.
 
    ```HTTP
   {
@@ -69,7 +69,7 @@ First we'll create our employee, Melva Prince.
    ```
  :::image type="content" source="media/tutorial-lifecycle-workflows/graph-post-user.png" alt-text="Screenshot of POST create Melva in graph explorer." lightbox="media/tutorial-lifecycle-workflows/graph-post-user.png":::
 
-Next, we'll create Britta Simon.  This is the account that will be used as our manager.
+Next, we create Britta Simon.  This is the account that will be used as our manager.
 
  1. Still in [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer).
  2. Make sure the top is still set to **POST** and `https://graph.microsoft.com/v1.0/users/` is in the box.