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 コマンドレットは、Configuration Manager で移行ジョブを作成します。

注:

PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。

例 1: 移行ジョブを作成する

PS XYZ:\> $CategoryObjects = Get-CMInitialModifiableSecuredCategory
PS XYZ:\> $MigrationEntity = Get-CMMigrationEntity
PS XYZ:\> New-CMMigrationJob -Name "123" -ObjectMigrationJobType -SecurityScope $CategoryObjects -MigrationObject $MigrationEntity

最初のコマンドでは、Get-CMInitialModifiableSecuredCategory コマンドレットを使用し、結果を $CategoryObjects 変数に格納します。

2 番目のコマンドでは、Get-CMMigrationEntity コマンドレットを使用し、結果を $MigrationEntity 変数に格納します。

最後のコマンドは、移行ジョブを作成します。

パラメーター

-CollectionLimitingMapping

コレクションを制限するキーと値のペアリングを指定します。 コレクションの制限により、コレクションに必要なコレクション メンバーが追加されないようにします。

型:Hashtable
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-CollectionMigrationJobType

ジョブがコレクション、オブジェクト、または以前に移行したオブジェクトを移行することを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ContentObjectsSiteCodeMapping

新しいサイトのコンテンツ オブジェクトをマップするキーと値のペアを指定します。

型:Hashtable
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Description

移行ジョブの説明を指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EnableProgramAfterAdvertisementMigrated

移行後に、提供情報に関連付けられているプログラムを有効にするかどうかを示します。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MigrateObjectWithSpecifiedCollection

関連付けられているオブジェクトをコレクションに移行することを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MigrationCollection

入力オブジェクトの配列を指定します。

型:IResultObject[]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MigrationJobSchedule

移行ジョブをスケジュールする日付時刻を D.HH:MM:SS 形式で指定します。

型:DateTime
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MigrationObject

入力オブジェクトの配列を指定します。

型:IResultObject[]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

Configuration Manager で移行ジョブの名前を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ObjectMigrationJobType

ジョブの種類がオブジェクト移行ジョブであることを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ObjectModifiedAfterMigrationJobType

新しい移行ジョブに、前回の移行以降に変更されたオブジェクトのみが含まれていることを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-OverwriteAllObject

コピー先データベース内のオブジェクトを上書きするかどうかを示します。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SaveCollectionInfoPath

コレクション情報のパスを指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SaveObjectInfoPath

オブジェクト情報のパスを指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SecurityScope

セキュリティ スコープ オブジェクトの配列を指定します。 セキュリティ スコープ オブジェクトを取得するには、 Get-CMSecurityScope コマンドレットを使用します。 コマンドレットは、指定したセキュリティ スコープを、移行先階層に移行されたデータに適用します。

型:IResultObject[]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SiteCodeReplacementMapping

移行されたコレクションを移行先のサイトにマップするキーと値のペアを指定します。

型:Hashtable
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-TransferOrganizationalFolderStructure

空のコレクションを移行するかどうかを示します。 Configuration Manager は、空のコレクションを組織のフォルダーに変換します。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-UtcTime

UTC 時刻を使用するかどうかを示します。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

None

出力

IResultObject