Merge pull request #234540 from whhender/add-weblink-reference

Add weblink reference

Author: JamesJBarnett

articles/purview/asset-insights.md

@@ -35,9 +35,10 @@ For more information to create and complete a scan, see [the manage data sources
 
 In Microsoft Purview Data Estate Insights, you can get an overview of the assets that have been scanned into the Data Map and view key gaps that can be closed by governance stakeholders, for better governance of the data estate.
 
-1. Navigate to your Microsoft Purview account in the Azure portal.
+1. Open the Microsoft Purview governance portal by:
 
-1. On the **Overview** page, in the **Get Started** section, select the **Open Microsoft Purview governance portal** tile.
+   - Browsing directly to [https://web.purview.azure.com](https://web.purview.azure.com) and selecting your Microsoft Purview account.
+   - Opening the [Azure portal](https://portal.azure.com), searching for and selecting the Microsoft Purview account. Selecting the [**the Microsoft Purview governance portal**](https://web.purview.azure.com/) button.
 
    :::image type="content" source="./media/asset-insights/portal-access.png" alt-text="Screenshot of Microsoft Purview account in Azure portal with the Microsoft Purview governance portal button highlighted.":::
 

articles/purview/catalog-firewall.md

@@ -46,7 +46,7 @@ To configure Microsoft Purview firewall follow these steps:
   - Public network access is set to _All networks_ on your Microsoft Purview account's Managed Event Hubs, if it's used. 
 
   > [!NOTE]
-  > Even though the network access is enabled through public internet, to gain access to Microsoft Purview governance portal, users must be first authenticated and authorized. 
+  > Even though the network access is enabled through public internet, to gain access to Microsoft Purview governance portal, [users must be first authenticated and authorized](catalog-permissions.md). 
 
 - **Disabled for ingestion only (Preview)**
 

articles/purview/catalog-lineage-user-guide.md

@@ -79,9 +79,10 @@ Lineage in Microsoft Purview includes datasets and processes. Datasets are also
 
 To access lineage information for an asset in Microsoft Purview, follow the steps:
 
-1. In the Azure portal, go to the [Microsoft Purview accounts page](https://aka.ms/purviewportal).
+1. Open the Microsoft Purview governance portal by:
 
-1. Select your Microsoft Purview account from the list, and then select **Open Microsoft Purview governance portal** from the **Overview** page.
+   - Browsing directly to [https://web.purview.azure.com](https://web.purview.azure.com) and selecting your Microsoft Purview account.
+   - Opening the [Azure portal](https://portal.azure.com), searching for and selecting the Microsoft Purview account. Selecting the [**the Microsoft Purview governance portal**](https://web.purview.azure.com/) button.
 
 1. On the Microsoft Purview governance portal **Home** page, search for a dataset name or the process name such as ADF Copy or Data Flow activity. And then press Enter.
 

articles/purview/catalog-managed-vnet.md

@@ -126,11 +126,14 @@ Before deploying a Managed VNet and Managed VNet Runtime for a Microsoft Purview
 > [!NOTE]
 > The following guide shows how to register and scan an Azure Data Lake Storage Gen 2 using Managed VNet Runtime. 
 
-1. Go to the [Azure portal](https://portal.azure.com), and navigate to the **Microsoft Purview accounts** page and select your _Purview account_.
+1. Open the Microsoft Purview governance portal by:
+
+   - Browsing directly to [https://web.purview.azure.com](https://web.purview.azure.com) and selecting your Microsoft Purview account.
+   - Opening the [Azure portal](https://portal.azure.com), searching for and selecting the Microsoft Purview account. Selecting the [**the Microsoft Purview governance portal**](https://web.purview.azure.com/) button.
 
    :::image type="content" source="media/catalog-managed-vnet/purview-managed-azure-portal.png" alt-text="Screenshot that shows the Microsoft Purview account":::
 
-2. **Open Microsoft Purview governance portal** and navigate to the **Data Map --> Integration runtimes**.
+2. Navigate to the **Data Map --> Integration runtimes**.
 
    :::image type="content" source="media/catalog-managed-vnet/purview-managed-vnet.png" alt-text="Screenshot that shows Microsoft Purview Data Map menus":::
 

articles/purview/catalog-permissions.md

@@ -17,6 +17,16 @@ The Microsoft Purview governance portal uses **Collections** in the Microsoft Pu
 > [!IMPORTANT]
 > This article refers to permissions required for the Microsoft Purview governance portal, and applications like the Microsoft Purview Data Map, Data Catalog, Data Estate Insights, etc. If you are looking for permissions information for the Microsoft Purview compliance center, follow [the article for permissions in the Microsoft Purview compliance portal](/microsoft-365/compliance/microsoft-365-compliance-center-permissions).
 
+## Permissions to access the Microsoft Purview governance portal
+
+There are two main ways to access the Microsoft Purview governance portal, and you'll need specific permissions for either:
+
+- To access your Microsoft Purview governance portal directly at [https://web.purview.azure.com](https://web.purview.azure.com), you'll need at least a [reader role](#roles) on a collection in your Microsoft Purview Data Map.
+- To access your Microsoft Purview governance portal through the [Azure portal](https://portal.azure.com) by searching for your Microsoft Purview account, opening it, and selecting **Open Microsoft Purview governance portal**, you'll need at least a **Reader** role under **Access Control (IAM)**.
+
+> [!NOTE]
+> If you created your account using a service principal, to be able to access the Microsoft Purview governance portal you will need to [grant a user collection admin permissions on the root collection](#administrator-change).
+
 ## Collections
 
 A collection is a tool that the Microsoft Purview Data Map uses to group assets, sources, and other artifacts into a hierarchy for discoverability and to manage access control. All accesses to the Microsoft Purview governance portal's resources are managed from collections in the Microsoft Purview Data Map.
@@ -82,14 +92,7 @@ You can assign roles to users, security groups, and service principals from your
 After creating a Microsoft Purview (formerly Azure Purview) account, the first thing to do is create collections and assign users to roles within those collections.
 
 > [!NOTE]
-> If you created your account using a service principal, to be able to access the Microsoft Purview governance portal and assign permissions to users, you will need to grant a user collection admin permissions on the root collection.
-> You can use [this Azure CLI command](/cli/azure/purview/account#az-purview-account-add-root-collection-admin):
->
->   ```azurecli
->   az purview account add-root-collection-admin --account-name [Microsoft Purview Account Name] --resource-group [Resource Group Name] --object-id [User Object Id]
->   ```
->
-> The object-id is optional. For more information and an example, see the [CLI command reference page](/cli/azure/purview/account#az-purview-account-add-root-collection-admin).
+> If you created your account using a service principal, to be able to access the Microsoft Purview governance portal and assign permissions to users, you will need to [grant a user collection admin permissions on the root collection](#administrator-change).
 
 ### Create collections
 
@@ -122,7 +125,7 @@ For full instructions, see our [how-to guide for adding role assignments](how-to
 
 ## Administrator change
 
-There may be a time when your [root collection admin](#roles) needs to change. By default, the user who creates the account is automatically assigned collection admin to the root collection. To update the root collection admin, there are four options:
+There may be a time when your [root collection admin](#roles) needs to change, or an admin needs to be added after an account is created by an application. By default, the user who creates the account is automatically assigned collection admin to the root collection. To update the root collection admin, there are four options:
 
 - You can manage root collection administrators in the [Azure portal](https://portal.azure.com/):
     1. Sign in to the Azure portal and search for your Microsoft Purview account.

articles/purview/create-microsoft-purview-portal.md

@@ -75,11 +75,10 @@ For more information about the governance capabilities of Microsoft Purview, for
 
 After your account is created, you'll use the Microsoft Purview governance portal to access and manage it. There are two ways to open the Microsoft Purview governance portal:
 
-* Open your Microsoft Purview account in the [Azure portal](https://portal.azure.com). Select the "Open Microsoft Purview governance portal" tile on the overview page.
+- You can browse directly to [https://web.purview.azure.com](https://web.purview.azure.com), select your Microsoft Purview account name, and sign in to your workspace.
+- Alternatively, open your Microsoft Purview account in the [Azure portal](https://portal.azure.com). Select the **Open Microsoft Purview governance portal** tile on the overview page.
     :::image type="content" source="media/create-catalog-portal/open-purview-studio.png" alt-text="Screenshot showing the Microsoft Purview account overview page, with the Microsoft Purview governance portal tile highlighted.":::
 
-* Alternatively, you can browse to [https://web.purview.azure.com](https://web.purview.azure.com), select your Microsoft Purview account name, and sign in to your workspace.
-
 ## Next steps
 
 In this quickstart, you learned how to create a Microsoft Purview (formerly Azure Purview) account, and how to access it.

articles/purview/how-to-create-and-manage-collections.md

@@ -24,7 +24,10 @@ Collections in the Microsoft Purview Data Map can be used to organize assets and
 
 ### Check permissions
 
-In order to create and manage collections in the Microsoft Purview Data Map, you'll need to be a **Collection Admin** within the Microsoft Purview governance portal. We can check these permissions in the [Microsoft Purview governance portal](https://web.purview.azure.com/resource/). You can find Studio in the overview page of the account in the [Azure portal](https://portal.azure.com).
+In order to create and manage collections in the Microsoft Purview Data Map, you'll need to be a **Collection Admin** within the Microsoft Purview governance portal. We can check these permissions in the [Microsoft Purview governance portal](https://web.purview.azure.com/resource/). You can find the Microsoft Purview governance portal by:
+
+- Browsing directly to [https://web.purview.azure.com](https://web.purview.azure.com) and selecting your Microsoft Purview account.
+- Opening the [Azure portal](https://portal.azure.com), searching for and selecting the Microsoft Purview account. Selecting the [**the Microsoft Purview governance portal**](https://web.purview.azure.com/) button.
 
 1. Select Data Map > Collections from the left pane to open collection management page.
 

articles/purview/how-to-monitor-data-map-population.md

@@ -15,7 +15,12 @@ In Microsoft Purview, you can scan various types of data sources and view the sc
 
 ## Monitor scan runs
 
-1. Go to your Microsoft Purview account -> open **Microsoft Purview governance portal** -> **Data map** -> **Monitoring**. You need to have **Data source admin** role on any collection to access this page. And you'll see the scan runs that belong to the collections on which you have data source admin privilege.
+1. Open the the Microsoft Purview governance portal by:
+
+    - Browsing directly to [https://web.purview.azure.com](https://web.purview.azure.com) and selecting your Microsoft Purview account.
+    - Opening the [Azure portal](https://portal.azure.com), searching for and selecting the Microsoft Purview account. Selecting the [**the Microsoft Purview governance portal**](https://web.purview.azure.com/) button.
+
+1. Open your Microsoft Purview account and select **Data map** -> **Monitoring**. You need to have **Data source admin** role on any collection to access this page. And you'll see the scan runs that belong to the collections on which you have data source admin privilege.
 
 1. The high-level KPIs show total scan runs within a period. The time period is defaulted at last 30 days, you can also choose to select last seven days. Based on the time filter selected, you can see the distribution of successful, failed, canceled, and in progress scan runs by week or by the day in the graph.
 

articles/purview/how-to-receive-share.md

@@ -76,7 +76,12 @@ This registration is only needed the first time when sharing or receiving data i
 
 ## Receive share
 
-1. You can view your share invitations in any Microsoft Purview account. In the [Azure portal](https://portal.azure.com), search for and select the Microsoft Purview account you want to use to receive the share. Open [the Microsoft Purview governance portal](https://web.purview.azure.com/). Select the **Data Map** icon from the left navigation. Then select **Share invites**. If you received an email invitation, you can also select the **View share invite** link in the email to select a Microsoft Purview account.
+1. You can view your share invitations in any Microsoft Purview account. Open the Microsoft Purview governance portal by:
+
+    * Browsing directly to [https://web.purview.azure.com](https://web.purview.azure.com) and selecting your Microsoft Purview account.
+    * Opening the [Azure portal](https://portal.azure.com), searching for and selecting the Microsoft Purview account. Select the [**the Microsoft Purview governance portal**](https://web.purview.azure.com/) button.
+
+1. Select the **Data Map** icon from the left navigation. Then select **Share invites**. If you received an email invitation, you can also select the **View share invite** link in the email to select a Microsoft Purview account.
 
     If you're a guest user of a tenant, you'll be asked to verify your email address for the tenant before viewing share invitation for the first time. [You can see our guide below for steps.](#guest-user-verification) Once verified, it's valid for 12 months.
 

articles/purview/how-to-view-self-service-data-access-policy.md

@@ -34,7 +34,7 @@ If you need to add or request permissions, follow the [Microsoft Purview permiss
 
 ## Steps to view self-service data access policies
 
-1. Open the Azure portal and launch the [Microsoft Purview governance portal](https://web.purview.azure.com/resource/). The Microsoft Purview governance portal can be launched as shown below or by using the [url directly](https://web.purview.azure.com/resource/).
+1. Launch the [Microsoft Purview governance portal](https://web.purview.azure.com/resource/). The Microsoft Purview governance portal can be launched as shown below or by using the [url directly](https://web.purview.azure.com/resource/).
 
     :::image type="content" source="./media/how-to-view-self-service-data-access-policy/Purview-Studio-launch-pic-1.png" alt-text="Screenshot showing a Microsoft Purview account open in the Azure portal, with the Microsoft Purview governance portal button highlighted.":::