New-ADXMigrationResource

Namespace ADPlayground.PowerShell

Outputs

ADPlayground.Migrations.Core.AdMigrationResourceItem

Creates a typed resource item for an AD migration plan.

Examples

Authored help example

Example 1: Add a resource re-ACL dependency to a user migration plan and review the planned ACL phase.


$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-ADXMigrationResource -Path '\\FS1\Finance' -ReAclMode AddDestinationBeforeRemoveSource
            }
            $plan | Test-ADXMigrationPlan -PassThru | Select-Object -ExpandProperty Phases | Where-Object Kind -eq ResourceReAcl | Format-Table Kind, Item, IsMutating, Description -AutoSize

Example 2: Record resource dependencies in report-only mode before deciding whether SIDHistory is still needed.


$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-ADXMigrationUser -SourceSamAccountName dave -NoSidHistory -CredentialStrategy Manual
                New-ADXMigrationResource -Path '\\FS1\Archive' -ReAclMode ReportOnly
            }
            $checked = $plan | Test-ADXMigrationPlan -PassThru
            $checked.Issues | Format-Table Severity, Code, Target, Message -AutoSize
            $checked.Phases | Format-Table Kind, Item, Description -AutoSize

Common Parameters

This command supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.

For more information, see about_CommonParameters.

Syntax

New-ADXMigrationResource -Path <string> [-NoRollbackEvidenceRequirement] [-ReAclMode <AddDestinationBeforeRemoveSource>] [<CommonParameters>]

Parameters

Path string requiredposition: namedpipeline: false: Filesystem, share, or directory path to process.
NoRollbackEvidenceRequirement SwitchParameter optionalposition: namedpipeline: false: Allows resource re-ACL without requiring rollback evidence in the plan.
ReAclMode AdMigrationResourceReAclMode optionalposition: namedpipeline: falsevalues: 3: Resource re-ACL mode. Possible values: None, AddDestinationBeforeRemoveSource, ReplaceSourceWithDestination, ReportOnly; Possible values: AddDestinationBeforeRemoveSource, ReplaceSourceWithDestination, ReportOnly

Outputs

ADPlayground.Migrations.Core.AdMigrationResourceItem