Jump to content


First looks at Distribution point content migration

Recommended Posts


Microsoft released another Technical Preview release, this time 2207, and it has a new feature, Distribution point content migration. According to the official blog post this will come in handy when you need to migrate your distribution point content from one dp to another, in particular because of the first 2 points listed below.



There are multiple scenarios where the content of one distribution point needs to be migrated to another distribution point.

  1. Cloud distribution points (CDP) hosted on Azure classic services are getting deprecated by mid of 2024. You need to migrate CDP content to another distribution point.
  2. Migration of cloud migration gateway v1 (CMGv1) hosted with *.cloudapp.net domain is also getting deprecated, hence you may need to migrate CMGv1 content to another distribution point.
  3. You may need to migrate local distribution point content to other local distribution point or CMG.


    As I don't have either (1) or (2) I will test scenario (3).

    Step 1. Satisfy the prerequisites

    One of the prerequisites is that the user performing the migration has the "Copy to Distribution Point" permission enabled under the Distribution Point permissions. As my user account is a Full Administrator, that requirement is already met.

    security role.PNG

    The other requirements are listed below.

    • If you want to deprecate the source distribution point, make sure that the source and destination distribution points have the same boundary group.
    • The destination distribution point should be installed already and able to receive the content.

    Step 2. Migrate a distribution point using Powershell

    As the current solution does not work in the Console, we need to use Powershell to do the migration. On the Configuration Manager server, open a Powershell cmd prompt via the console,

    connect via powershell.png

    and try the following

    Start-CMDistributionPointMigration -SourceDistributionPointName <FQDN for source distribution point> -DestinationDistributionPointName <FQDN for destination distribution point>

    for example...

    Start-CMDistributionPointMigration -SourceDistributionPointName cm01.windowsnoob.lab.local -DestinationDistributionPointName webserver.windowsnoob.lab.local

    as shown here...

    powershell connected via configmgr.png

    The fact that it didn't error was a good start.

    Step 3. Monitor the migration using Powershell

    As the ability to monitor this via the console is not yet available, you'll need to once again monitor things using Powershell. The command this time is

    Get-CMDistributionPointMigrationStatus -SourceDistributionPointName <FQDN for source distribution point> -DestinationDistributionPointName <FQDN for destination distribution point> 

    Let's give it a try.

    Get-CMDistributionPointMigrationStatus -SourceDistributionPointName cm01.windowsnoob.lab.local -DestinationDistributionPointName webserver.windowsnoob.lab.local

    The result should tell you if it's in progress, completed and so on.

    in progress.png


    Step 4. Monitor the content being migrated

    The docs incorrectly listed the cmdlet as Get-CMDistributionPointContentMigrationStatus but that doesn't work, see below.



    Here is a screenshot of the docs... (as of 2022/07/10), I've informed them of the error, so I'm sure it'll be fixed soon


    Using the power of the TAB key, I figured out the correct command and here it is:





    I think that the status (4) means that it's still in progress but I've asked the Microsoft Product Group for comment. As you can see below the source DP lists this packageID as a large package so it will take more time to complete.


    and sure enough, after more minutes in transit, the status changes from 4 to Success


    So there you have it, content migration from one distribution point to another using Powershell built into ConfigMgr works very nicely indeed, is that cool or what ?

    Related reading



    Share this post

    Link to post
    Share on other sites

    Join the conversation

    You can post now and register later. If you have an account, sign in now to post with your account.

    Reply to this topic...

    ×   Pasted as rich text.   Paste as plain text instead

      Only 75 emoji are allowed.

    ×   Your link has been automatically embedded.   Display as a link instead

    ×   Your previous content has been restored.   Clear editor

    ×   You cannot paste images directly. Upload or insert images from URL.


    • Create New...

    Important Information

    We have placed cookies on your device to help make this website better. You can adjust your cookie settings, otherwise we'll assume you're okay to continue.