New-ADXMigrationGroup

Examples

Example 1: Add an access group to a complete migration plan and review membership 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=Migrated,DC=new,DC=contoso,DC=com' -SourceAuditReady -SourceTcpipClientSupportReady -ResourceAclScanCompleted -BusinessJustification CAB-1234 {
                New-ADXMigrationGroup -SourceSamAccountName 'APP-Finance-Readers' -DestinationSamAccountName 'APP-Finance-Readers' -CopyAttribute description,mail -MigrateMembers
                New-ADXMigrationResource -Path '\\FS1\Finance' -ReAclMode AddDestinationBeforeRemoveSource
            }
            $checked = $plan | Test-ADXMigrationPlan -PassThru
            $checked.Issues | Format-Table Severity, Code, Target, Message -AutoSize
            $checked.Phases | Where-Object { $_.Kind -in 'PrepareDestination','Membership','SidHistory','ResourceReAcl' } | Format-Table Kind, Item, Description -AutoSize
        

Example 2: Plan a group without SIDHistory after the replacement access path is documented.

$plan = New-ADXMigrationPlan -SourceDomain old.contoso.com -DestinationDomain new.contoso.com -DestinationOrganizationalUnit 'OU=Migrated,DC=new,DC=contoso,DC=com' -ResourceAclScanCompleted -BusinessJustification CAB-1234 {
                New-ADXMigrationGroup -SourceSamAccountName 'APP-Legacy-Archive' -NoSidHistory -CopyAttribute description
                New-ADXMigrationResource -Path '\\FS1\Archive' -ReAclMode ReportOnly
            }
            if ($plan | Test-ADXMigrationPlan) {
                $plan | Invoke-ADXMigrationPlan
            }