|
| 1 | +--- |
| 2 | +author: paasin |
| 3 | +ms.author: paasin |
| 4 | +ms.prod: configuration-manager |
| 5 | +ms.technology: configmgr-core |
| 6 | +ms.topic: include |
| 7 | +ms.date: 07/04/2022 |
| 8 | +ms.localizationpriority: medium |
| 9 | +--- |
| 10 | + |
| 11 | +## <a name="bkmk_dpconmig"></a> Distribution point content migration |
| 12 | +<!--10928371--> |
| 13 | +Distribution point content migration support is now available for migrating content from one distribution point to another distribution point using PowerShell cmdlets. You can also monitor the distribution point migration status using these PowerShell cmdlets. |
| 14 | + |
| 15 | +There are multiple scenarios where the content of one distribution point needs to be migrated to another distribution point. |
| 16 | +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. |
| 17 | +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. |
| 18 | +3) You may need to migrate local distribution point content to other local distribution point or CMG. |
| 19 | + |
| 20 | +#### Prerequisites |
| 21 | + |
| 22 | +1) The user's security role permission should have "Copy to Distribution Point" enabled under Distribution Point. |
| 23 | +2) If you want to deprecate the source distribution point, make sure that the source and destination distribution points have the same boundary group. |
| 24 | +3) The destination distribution point should be installed already and able to receive the content. |
| 25 | + |
| 26 | +> [!NOTE] |
| 27 | +> You can't currently configure this behavior from the Configuration Manager console. For more information on configuring this behavior with PowerShell, see the cmdlet details in the following section. |
| 28 | +
|
| 29 | +### Start-CMDistributionPointMigration |
| 30 | + |
| 31 | +Use this cmdlet to initiate distribution point content migration. You can pass the desired parameters such as SourceDistributionPointName and DestinationDistributionPointName per your distribution point migration scenario. |
| 32 | +You can also pass the LockSourceDistributionPoint parameter to lock the source distribution point. This parameter is used to deprecate the source distribution point scenarios (for example: CDP Migration). If the source distribution point is locked during distribution point migration, you won't be able to distribute the new content to the source distribution point, but the endpoints will be able to download the content that is already available in the source distribution point. |
| 33 | +For deprecation scenarios, you can delete the source distribution point after the distribution content migration is completed. |
| 34 | + |
| 35 | +#### Syntax |
| 36 | + |
| 37 | +```powershell |
| 38 | +Start-CMDistributionPointMigration -SourceDistributionPointName <FQDN for source distribution point> -DestinationDistributionPointName <FQDN for destination distribution point> |
| 39 | +``` |
| 40 | + |
| 41 | +#### Examples |
| 42 | + |
| 43 | +```powershell |
| 44 | +Start-CMDistributionPointMigration -SourceDistributionPointName <FQDN for source distribution point> -DestinationDistributionPointName <FQDN for destination distribution point> -LockSourceDistributionPoint |
| 45 | +
|
| 46 | +Start-CMDistributionPointMigration -SourceDistributionPointName <FQDN for source distribution point> -DestinationDistributionPointName <FQDN for destination distribution point> |
| 47 | +``` |
| 48 | + |
| 49 | +#### Parameters |
| 50 | + |
| 51 | +- **SourceDistributionPointName**: Use this to specify the source distribution point from where content will be migrated. |
| 52 | + |
| 53 | +- **DestinationDistributionPointName**: Use this to specify the destination distribution point where you want the content to be copied. |
| 54 | + |
| 55 | +- **LockSourceDistributionPoint**: Use when you need to initiate distribution point migration with source distribution point locked. |
| 56 | + |
| 57 | + |
| 58 | +### Get-CMDistributionPointMigrationStatus |
| 59 | + |
| 60 | +Use this cmdlet to monitor the distribution point migration status. |
| 61 | + |
| 62 | +#### Syntax |
| 63 | + |
| 64 | +```powershell |
| 65 | +Get-CMDistributionPointMigrationStatus -SourceDistributionPointName <FQDN for source distribution point> -DestinationDistributionPointName <FQDN for destination distribution point> |
| 66 | +``` |
| 67 | + |
| 68 | +### Get-CMDistributionPointContentMigrationStatus |
| 69 | + |
| 70 | +Use this cmdlet to monitor the distribution point content migration status. |
| 71 | + |
| 72 | +#### Syntax |
| 73 | + |
| 74 | +```powershell |
| 75 | +Get-CMDistributionPointContentMigrationStatus -SourceDistributionPointName <FQDN for source distribution point> -DestinationDistributionPointName <FQDN for destination distribution point> |
| 76 | +``` |
| 77 | + |
| 78 | +### Stop-CMDistributionPointMigration |
| 79 | + |
| 80 | +Use this cmdlet to stop the distribution point migration. In case you have mistakenly locked the source distribution point, you can use this cmdlet to unlock the source distribution point. Unlocking the source distribution point will stop the distribution point migration. To restart the migration, use the Start-CMDistributionPointMigration cmdlet. |
| 81 | + |
| 82 | +#### Syntax |
| 83 | + |
| 84 | +```powershell |
| 85 | +Stop-CMDistributionPointMigration -SourceDistributionPointName <FQDN for source distribution point> -DestinationDistributionPointName <FQDN for destination distribution point> |
| 86 | +``` |
| 87 | + |
| 88 | +#### Examples |
| 89 | + |
| 90 | +```powershell |
| 91 | +Stop-CMDistributionPointMigration -SourceDistributionPointName <FQDN for source distribution point> -DestinationDistributionPointName <FQDN for destination distribution point> -LockSourceDistributionPoint |
| 92 | +
|
| 93 | +Stop-CMDistributionPointMigration -SourceDistributionPointName <FQDN for source distribution point> -DestinationDistributionPointName <FQDN for destination distribution point> |
| 94 | +``` |
| 95 | + |
| 96 | +> [!NOTE] |
| 97 | +> You won't be able to perform multiple migrations at a shared time. Migration for one set of source and destination distribution points needs to be completed before starting another. |
| 98 | +
|
| 99 | + |
0 commit comments