Export (0) Print
Expand All
Expand Minimize

New-CMMigrationJob

Updated: February 7, 2014

Applies To: System Center 2012 R2 Configuration Manager

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 that 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 scope objects. To obtain a security scope object, use the Get-CMSecurityScope cmdlet. The cmdlet applies the security scopes that you specify 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 executing the command.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Describes what would happen if you executed the command without actually executing the command.


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.

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

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

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft