New-ADXMigrationPlan

Examples

Example 1: Create a migration plan from DSL items and include SIDHistory due-diligence evidence.

$plan = New-ADXMigrationPlan -SourceDomain old.contoso.com -DestinationDomain new.contoso.com -SourceDomainController old-pdc.old.contoso.com -DestinationDomainController new-dc01.new.contoso.com -DestinationOrganizationalUnit 'OU=Migrated,DC=new,DC=contoso,DC=com' -SourceAuditReady -SourceTcpipClientSupportReady -ResourceAclScanCompleted -BusinessJustification CAB-1234 {
                New-ADXMigrationUser -SourceSamAccountName alice -CredentialStrategy ResetRandom -MigrateMembership
                New-ADXMigrationComputer -SourceSamAccountName 'PC001$' -OfflineDomainJoin -MigrateProfile
                New-ADXMigrationResource -Path '\\FS1\Finance' -ReAclMode AddDestinationBeforeRemoveSource
            }
            if ($plan | Test-ADXMigrationPlan) {
                $preview = $plan | Invoke-ADXMigrationPlan
                $preview.Phases | Format-Table Kind, Item, Status, Changed, Message -AutoSize
            }
        

Example 2: Inspect blockers and planned phases before execution.

$checked = $plan | Test-ADXMigrationPlan -PassThru
            $checked.Issues | Format-Table Severity, Code, Target, Message -AutoSize
            $checked.Phases | Format-Table Kind, Item, IsMutating, RequiresMachineExecutor, Description -AutoSize
        

Example 3: Create a plan where a temporary password is referenced by secret ID rather than stored in the plan.

$plan = New-ADXMigrationPlan -SourceDomain old.contoso.com -DestinationDomain new.contoso.com -DestinationOrganizationalUnit 'OU=Migrated,DC=new,DC=contoso,DC=com' -BusinessJustification CAB-1234 {
                New-ADXMigrationUser -SourceSamAccountName bob -CredentialStrategy SetTemporary -CredentialSecretReference 'vault://migration/CAB-1234/bob-temp' -ForceCredentialChangeAtNextLogon
            }
            $plan | Test-ADXMigrationPlan -PassThru | Select-Object -ExpandProperty Phases | Where-Object { $_.Kind -in 'PrepareDestination','CredentialStrategy','SidHistory' } | Format-Table Kind, Item, Description -AutoSize
        

Example 4: Plan a migration without SIDHistory for a principal that no longer needs old-resource continuity.

$plan = New-ADXMigrationPlan -SourceDomain old.contoso.com -DestinationDomain new.contoso.com -DestinationOrganizationalUnit 'OU=Migrated,DC=new,DC=contoso,DC=com' {
                New-ADXMigrationUser -SourceSamAccountName retired.contractor -NoSidHistory -CredentialStrategy Manual
                New-ADXMigrationResource -Path '\\FS1\Archive' -ReAclMode ReportOnly
            }
            $plan | Test-ADXMigrationPlan -PassThru | Select-Object -ExpandProperty Phases | Format-Table Kind, Item, Description -AutoSize