New-ADXMigrationComputer

Examples

Example 1: Add a workstation to a complete plan, then review domain-join and SIDHistory phases.

$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=Workstations,DC=new,DC=contoso,DC=com' -SourceAuditReady -SourceTcpipClientSupportReady -ResourceAclScanCompleted -BusinessJustification CAB-1234 {
                New-ADXMigrationComputer -SourceSamAccountName 'PC001$' -DestinationSamAccountName 'PC001$' -OfflineDomainJoin
            }
            $checked = $plan | Test-ADXMigrationPlan -PassThru
            $checked.Phases | Where-Object { $_.Kind -in 'PrepareDestination','SidHistory','ComputerJoin','Validate' } | Format-Table Kind, Item, RequiresMachineExecutor, Description -AutoSize
        

Example 2: Plan a workstation migration that requires machine-side join and local profile migration.

$plan = New-ADXMigrationPlan -SourceDomain old.contoso.com -DestinationDomain new.contoso.com -DestinationOrganizationalUnit 'OU=Workstations,DC=new,DC=contoso,DC=com' -SourceAuditReady -SourceTcpipClientSupportReady -ResourceAclScanCompleted -BusinessJustification CAB-1234 {
                New-ADXMigrationComputer -SourceSamAccountName 'PC002$' -OfflineDomainJoin -MigrateProfile -RequireMachineSideExecutor
            }
            $plan | Test-ADXMigrationPlan -PassThru |
                Select-Object -ExpandProperty Phases |
                Where-Object { $_.RequiresMachineExecutor -or $_.Kind -in 'ComputerJoin','Profile' } |
                Format-Table Kind, Item, RequiresMachineExecutor, Description -AutoSize
        

Example 3: Track a server whose destination computer object already exists and preview the remaining phases.

$plan = New-ADXMigrationPlan -SourceDomain old.contoso.com -DestinationDomain new.contoso.com -DestinationOrganizationalUnit 'OU=Servers,DC=new,DC=contoso,DC=com' -ResourceAclScanCompleted -BusinessJustification CAB-1234 {
                New-ADXMigrationComputer -SourceSamAccountName 'SRV-FS01$' -SkipDestinationPreparation -NoSidHistory -RequireMachineSideExecutor
                New-ADXMigrationResource -Path '\\SRV-FS01\Data' -ReAclMode AddDestinationBeforeRemoveSource
            }
            if ($plan | Test-ADXMigrationPlan) {
                $plan | Invoke-ADXMigrationPlan
            }