Merge pull request #225993 from whhender/move-between-collections

Move between collections

Author: Stacyrch140

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

@@ -6,7 +6,7 @@ ms.author: viseshag
 ms.service: purview
 ms.subservice: purview-data-map
 ms.topic: how-to
-ms.date: 05/23/2022
+ms.date: 02/01/2023
 ms.custom: template-how-to
 ---
 
@@ -101,11 +101,15 @@ You'll need to be a collection admin in order to delete a collection. If you are
 
    :::image type="content" source="./media/how-to-create-and-manage-collections/delete-collections.png" alt-text="Screenshot of Microsoft Purview governance portal window to delete a collection" border="true":::
 
-2. Select **Confirm** when prompted, **Are you sure you want to delete this collection?**
+1. Select **Confirm** when prompted, **Are you sure you want to delete this collection?**
 
    :::image type="content" source="./media/how-to-create-and-manage-collections/delete-collection-confirmation.png" alt-text="Screenshot of Microsoft Purview governance portal window showing confirmation message to delete a collection" border="true":::
 
-3. Verify deletion of the collection from your Microsoft Purview Data Map.
+1. Verify deletion of the collection from your Microsoft Purview Data Map.
+
+### Move registered sources between collections
+
+You can move registered sources from one collection to another you have access to. For steps, see the [manage data sources article](manage-data-sources.md#move-sources-between-collections).
 
 ## Add roles and restrict access through collections
 

articles/purview/manage-data-sources.md

@@ -6,19 +6,18 @@ ms.author: jingwang
 ms.service: purview
 ms.subservice: purview-data-map
 ms.topic: how-to
-ms.date: 01/25/2023
+ms.date: 02/01/2023
 ---
 
 # Manage data sources in Microsoft Purview
 
-In this article, you learn how to register new data sources, manage collections of data sources, and view sources in Microsoft Purview.
+In this article, you learn how to register new data sources, manage collections of data sources, view sources, and move sources between collections in Microsoft Purview.
 
 ## Register a new source
 
 >[!NOTE]
 > You'll need to be a Data Source Admin and one of the other Purview roles (for example, Data Reader or Data Share Contributor) to register a source and manage it in the Microsoft Purview governance portal. See our [Microsoft Purview Permissions page](catalog-permissions.md) for details on roles and adding permissions.
 
-
 Use the following steps to register a new source:
 
 1. Open [the Microsoft Purview governance portal](https://web.purview.azure.com/resource/), navigate to the **Data Map**, **Sources**, and select **Register**.
@@ -74,6 +73,28 @@ To create a hierarchy of collections, assign higher-level collections as a paren
 >[!TIP] 
 >You can remove sources from a hierarchy by selecting *None* for the parent. Unparented sources are grouped in a dotted box in the map view with no arrows linking them to parents.
 
+## Move sources between collections
+
+After you've registered your source, you can move it to another collection that you have access to.
+
+>[!IMPORTANT]
+> When a source moves to a new collection, its scans move with it, but assets will not appear in the new collection until your next scan.
+
+1. Find your source in the data map and select it.
+
+1. Beside the **Collection Path** list, select the ellipsis (...) button and select **Move**.
+
+   :::image type="content" source="media/manage-data-sources/choose-to-move.png" alt-text="Screenshot of a source, with the ellipsis and move buttons highlighted.":::
+
+1. In the **Move collection** menu that appears, select your collection from the drop-down and then select **Ok**.
+
+   :::image type="content" source="media/manage-data-sources/select-collection.png" alt-text="Screenshot of the Move collection window, showing the drop down selection of collections.":::
+
+1. Your collection has been moved. It can take up to an hour for results to be fully seen across your Microsoft Purview environment. Your scans will move with your resource, but assets will remain in their original collection until your next scan, then they'll move to the new collection.
+
+>[!NOTE]
+>If any of the assets from your source were moved manually to a different collection before the source was migrated, the scan won't take them to the new collection. They will remain in the collection you moved them to.
+
 ## Next steps
 
 Learn how to discover and govern various data sources: