New-CMMigrationJob
在 Configuration Manager 中创建迁移作业。
语法
New-CMMigrationJob
[-ContentObjectsSiteCodeMapping <Hashtable>]
[-Description <String>]
[-MigrationJobSchedule <DateTime>]
-MigrationObject <IResultObject[]>
-Name <String>
[-ObjectMigrationJobType]
[-OverwriteAllObject <Boolean>]
[-SaveObjectInfoPath <String>]
-SecurityScope <IResultObject[]>
[-SiteCodeReplacementMapping <Hashtable>]
[-TransferOrganizationalFolderStructure <Boolean>]
[-UtcTime <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMMigrationJob
[-CollectionLimitingMapping <Hashtable>]
[-CollectionMigrationJobType]
[-Description <String>]
[-EnableProgramAfterAdvertisementMigrated <Boolean>]
-MigrationCollection <IResultObject[]>
[-MigrationJobSchedule <DateTime>]
-Name <String>
[-OverwriteAllObject <Boolean>]
[-SaveCollectionInfoPath <String>]
[-SaveObjectInfoPath <String>]
-SecurityScope <IResultObject[]>
[-SiteCodeReplacementMapping <Hashtable>]
[-TransferOrganizationalFolderStructure <Boolean>]
[-UtcTime <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMMigrationJob
[-CollectionLimitingMapping <Hashtable>]
[-CollectionMigrationJobType]
[-ContentObjectsSiteCodeMapping <Hashtable>]
[-Description <String>]
[-EnableProgramAfterAdvertisementMigrated <Boolean>]
[-MigrateObjectWithSpecifiedCollection]
-MigrationCollection <IResultObject[]>
[-MigrationJobSchedule <DateTime>]
-MigrationObject <IResultObject[]>
-Name <String>
[-OverwriteAllObject <Boolean>]
[-SaveCollectionInfoPath <String>]
[-SaveObjectInfoPath <String>]
-SecurityScope <IResultObject[]>
[-SiteCodeReplacementMapping <Hashtable>]
[-TransferOrganizationalFolderStructure <Boolean>]
[-UtcTime <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMMigrationJob
[-ContentObjectsSiteCodeMapping <Hashtable>]
[-Description <String>]
[-MigrationJobSchedule <DateTime>]
-MigrationObject <IResultObject[]>
-Name <String>
[-ObjectModifiedAfterMigrationJobType]
[-OverwriteAllObject <Boolean>]
[-SaveObjectInfoPath <String>]
-SecurityScope <IResultObject[]>
[-SiteCodeReplacementMapping <Hashtable>]
[-TransferOrganizationalFolderStructure <Boolean>]
[-UtcTime <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 说明
New-CMMigrationJob cmdlet 在 Configuration Manager 中创建迁移作业。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。
示例
示例 1：创建迁移作业
PS XYZ:\> $CategoryObjects = Get-CMInitialModifiableSecuredCategory
PS XYZ:\> $MigrationEntity = Get-CMMigrationEntity
PS XYZ:\> New-CMMigrationJob -Name "123" -ObjectMigrationJobType -SecurityScope $CategoryObjects -MigrationObject $MigrationEntity第一个命令使用 Get-CMInitialModifiableSecuredCategory cmdlet 并将结果存储在 $CategoryObjects 变量中。
第二个命令使用 Get-CMMigrationEntity cmdlet 并将结果存储在 $MigrationEntity 变量中。
最后一个命令创建迁移作业。
参数
-CollectionLimitingMapping
指定键值配对以限制集合。 集合限制可防止在集合中添加所需的集合成员。
| 类型: | Hashtable |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-CollectionMigrationJobType
指示作业迁移集合、对象或以前迁移的对象。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
| 类型: | SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ContentObjectsSiteCodeMapping
指定映射新网站中内容对象的键值对。
| 类型: | Hashtable |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Description
指定迁移作业的说明。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EnableProgramAfterAdvertisementMigrated
指示在迁移播发后是否启用与播发关联的程序。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-MigrateObjectWithSpecifiedCollection
指示将关联的对象与集合一起迁移。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-MigrationCollection
指定输入对象的数组。
| 类型: | IResultObject[] |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-MigrationJobSchedule
指定用于计划迁移作业的日期时间（D.HH：MM：SS 格式）。
| 类型: | DateTime |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-MigrationObject
指定输入对象的数组。
| 类型: | IResultObject[] |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Name
指定 Configuration Manager 中迁移作业的名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-ObjectMigrationJobType
指示作业类型是对象迁移作业。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-ObjectModifiedAfterMigrationJobType
指示新的迁移作业仅包括自上次迁移以来修改的对象。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-OverwriteAllObject
指示是否覆盖目标数据库中的对象。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SaveCollectionInfoPath
指定集合信息的路径。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SaveObjectInfoPath
指定对象信息的路径。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SecurityScope
指定安全范围对象的数组。 若要获取安全作用域对象，请使用 Get-CMSecurityScope cmdlet。 cmdlet 会将你指定的安全作用域应用于迁移到目标层次结构的数据。
| 类型: | IResultObject[] |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-SiteCodeReplacementMapping
指定将迁移的集合映射到目标中的站点的键值对。
| 类型: | Hashtable |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-TransferOrganizationalFolderStructure
指示是否迁移空集合。 Configuration Manager 将空集合转换为组织文件夹。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-UtcTime
指示是否使用 UTC 时间。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
None
输出
IResultObject