New-CMMigrationJob

在 Configuration Manager 中建立遷移工作。

Syntax

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>]

Description

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

會指定要限制集合的索引鍵-值配對。 集合限制可防止加入集合中所需的集合成員。

Type:Hashtable
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CollectionMigrationJobType

會指出工作會遷移集合、物件或先前遷移的物件。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

執行 Cmdlet 之前提示您確認。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-ContentObjectsSiteCodeMapping

指定將內容物件對應至新網站的索引鍵-值對。

Type:Hashtable
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Description

指定遷移工作的描述。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

此參數會將萬用字元視為常值字元值。 您無法將它與 ForceWildcardHandling合併。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-EnableProgramAfterAdvertisementMigrated

會指出是否要在遷移之後,啟用與廣告相關聯的程式。

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

這個參數會處理萬用字元,而且可能會造成未預期的行為 (不建議) 。 您無法將它與 DisableWildcardHandling合併。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MigrateObjectWithSpecifiedCollection

表示您將關聯的物件與集合進行遷移。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MigrationCollection

會指定輸入物件的陣列。

Type:IResultObject[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MigrationJobSchedule

會指定日期時間,以 d. HH: MM: SS 格式,以排程遷移工作。

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MigrationObject

會指定輸入物件的陣列。

Type:IResultObject[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ObjectMigrationJobType

表示工作類型為「物件遷移」工作。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ObjectModifiedAfterMigrationJobType

表示新的遷移工作僅包含自上次遷移後修改的物件。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-OverwriteAllObject

會指出是否要覆寫目的資料庫中的物件。

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SaveCollectionInfoPath

會指定集合資訊的路徑。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SaveObjectInfoPath

會指定物件資訊的路徑。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SecurityScope

指定安全性範圍物件的陣列。 若要取得安全性範圍物件,請使用 CMSecurityScope Cmdlet。 Cmdlet 會將您指定的安全性範圍套用到遷移至目的地階層的資料。

Type:IResultObject[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SiteCodeReplacementMapping

指定將遷移的集合對應至目的地中之網站的索引鍵/值組。

Type:Hashtable
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-TransferOrganizationalFolderStructure

會指出是否要遷移空白集合。 Configuration Manager 會將空集合轉換為組織資料夾。

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UtcTime

會指出是否使用 UTC 時間。

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 不會執行 Cmdlet。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-名稱

在 Configuration Manager 中指定遷移工作的名稱。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

輸入

輸出

IResultObject