New-CMMigrationJob

New-CMMigrationJob

Creates a migration job in System Center 2012 Configuration Manager.

Syntax

Parameter Set: NewMigrationJobByCollectionMigrateObject
New-CMMigrationJob -CollectionMigrationJobType -MigrateObjectWithSpecifiedCollection -MigrationCollection <IResultObject[]> -MigrationObject <IResultObject[]> -Name <String> -SecurityScope <IResultObject[]> [-CollectionLimitingMapping <Hashtable> ] [-ContentObjectsSiteCodeMapping <Hashtable> ] [-Description <String> ] [-EnableProgramAfterAdvertisementMigrated <Boolean> ] [-MigrationJobSchedule <DateTime> ] [-OverwriteAllObject <Boolean> ] [-SaveCollectionInfoPath <String> ] [-SaveObjectInfoPath <String> ] [-SiteCodeReplacementMapping <Hashtable> ] [-TransferOrganizationalFolderStructure <Boolean> ] [-UtcTime <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: NewMigrationJobByCollectionNotMigrateObject
New-CMMigrationJob -CollectionMigrationJobType -MigrationCollection <IResultObject[]> -Name <String> -SecurityScope <IResultObject[]> [-CollectionLimitingMapping <Hashtable> ] [-Description <String> ] [-EnableProgramAfterAdvertisementMigrated <Boolean> ] [-MigrationJobSchedule <DateTime> ] [-OverwriteAllObject <Boolean> ] [-SaveCollectionInfoPath <String> ] [-SaveObjectInfoPath <String> ] [-SiteCodeReplacementMapping <Hashtable> ] [-TransferOrganizationalFolderStructure <Boolean> ] [-UtcTime <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: NewMigrationJobByObject
New-CMMigrationJob -MigrationObject <IResultObject[]> -Name <String> -ObjectMigrationJobType -SecurityScope <IResultObject[]> [-ContentObjectsSiteCodeMapping <Hashtable> ] [-Description <String> ] [-MigrationJobSchedule <DateTime> ] [-OverwriteAllObject <Boolean> ] [-SaveObjectInfoPath <String> ] [-SiteCodeReplacementMapping <Hashtable> ] [-TransferOrganizationalFolderStructure <Boolean> ] [-UtcTime <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: NewMigrationJobByObjectModified
New-CMMigrationJob -MigrationObject <IResultObject[]> -Name <String> -ObjectModifiedAfterMigrationJobType -SecurityScope <IResultObject[]> [-ContentObjectsSiteCodeMapping <Hashtable> ] [-Description <String> ] [-MigrationJobSchedule <DateTime> ] [-OverwriteAllObject <Boolean> ] [-SaveObjectInfoPath <String> ] [-SiteCodeReplacementMapping <Hashtable> ] [-TransferOrganizationalFolderStructure <Boolean> ] [-UtcTime <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The New-CMMigrationJob cmdlet creates a migration job in Microsoft System Center 2012 Configuration Manager.

Parameters

-CollectionLimitingMapping<Hashtable>

Specifies key-value pairings to limit a collection. Collection limiting prevents the addition of collection members you do want in the collection.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

-CollectionMigrationJobType

Indicates whether the job migrates collections, objects, or previously migrated objects.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

-ContentObjectsSiteCodeMapping<Hashtable>

Specifies key-value pairs that map content objects in the new site.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

-Description<String>

Specifies a description for the migration job.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

-EnableProgramAfterAdvertisementMigrated<Boolean>

Indicates whether to enable programs associated with an advertisement after they have migrated.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

-MigrateObjectWithSpecifiedCollection

Indicates that you migrate associated objects with the collection.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

-MigrationCollection<IResultObject[]>

Specifies an array of input objects.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

-MigrationJobSchedule<DateTime>

Specifies a date time, in D.HH:MM:SS format, to schedule the migration job.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

-MigrationObject<IResultObject[]>

Specifies an array of input objects.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

-Name<String>

Specifies the name of a migration job in Configuration Manager.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

-ObjectMigrationJobType

Indicates that the job type is an object migration job.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

-ObjectModifiedAfterMigrationJobType

Indicates that the new migration job only includes objects that were modified since the last migration.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

-OverwriteAllObject<Boolean>

Indicates whether to overwrite objects in the destination database.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

-SaveCollectionInfoPath<String>

Specifies a path for the collection information.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

-SaveObjectInfoPath<String>

Specifies a path for the object information.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

-SecurityScope<IResultObject[]>

Specifies an array of security scopes to apply to data migrated to the destination hierarchy.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

-SiteCodeReplacementMapping<Hashtable>

Specifies key-value pairs that map a migrated collection to a site in the destination.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

-TransferOrganizationalFolderStructure<Boolean>

Indicates whether to migrate an empty collection. Configuration Manager converts the empty collection to an organizational folder.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

-UtcTime<Boolean>

Indicates whether to use UTC time.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

-Confirm

Prompts you for confirmation before running the cmdlet.

Required?	false
Position?	named
Default Value	false
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Required?	false
Position?	named
Default Value	false
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Create a migration job

This example creates a migration job.

The first command creates mappings of site codes and stores the result in the $Group variable.

The second command uses the Get-CMInitModifiableSecuredCategory cmdlet and stores the result in the $CategoryObjects variable.

The third command uses the Get-CMMigrationEntity cmdlet and stores the result in the $MigrationEntity variable.

The fourth command uses the New-CMMigrationJob cmdlet to create a migration job.

PS C:\> $Group = @{
"122" = "123"
"234" = "123"
}
PS C:\> $CategoryObjects = Get-CMInitModifiableSecuredCategory
PS C:\> $MigrationEntity = Get-CMMigrationEntity
PS C:\> New-CMMigrationJob -Name "123" -ObjectMigrationJobType -ContentObjectsSiteCodeMapping $Group -SecurityScope $CategoryObjects -MigrationObject $MigrationEntity

Related topics

Get-CMInitModifiableSecuredCategory

Get-CMMigrationEntity