Partager via

New-CMMigrationJob

  • Référence
Module:
ConfigurationManager

Crée un travail de migration dans Configuration Manager.

Syntaxe

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

L’applet de commande New-CMMigrationJob crée un travail de migration dans Configuration Manager.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Créer une tâche de migration

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

La première commande utilise l’applet de commande Get-CMInitialModifiableSecuredCategory et stocke le résultat dans la variable $CategoryObjects.

La deuxième commande utilise l’applet de commande Get-CMMigrationEntity et stocke le résultat dans la variable $MigrationEntity.

La dernière commande crée un travail de migration.

Paramètres

-CollectionLimitingMapping

Spécifie des paires clé-valeur pour limiter une collection. La limitation des regroupements empêche l’ajout de membres de la collection que vous souhaitez dans la collection.

Type:Hashtable
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CollectionMigrationJobType

Indique que le travail migre des collections, des objets ou des objets précédemment migrés.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ContentObjectsSiteCodeMapping

Spécifie les paires clé-valeur qui mappent les objets de contenu dans le nouveau site.

Type:Hashtable
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Description

Spécifie une description du travail de migration.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableProgramAfterAdvertisementMigrated

Indique s’il faut activer les programmes associés à une publication après leur migration.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MigrateObjectWithSpecifiedCollection

Indique que vous migrez les objets associés avec la collection.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MigrationCollection

Spécifie un tableau d’objets d’entrée.

Type:IResultObject[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MigrationJobSchedule

Spécifie une date et heure, au format D.HH :MM :SS, pour planifier la tâche de migration.

Type:DateTime
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MigrationObject

Spécifie un tableau d’objets d’entrée.

Type:IResultObject[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie le nom d’un travail de migration dans Configuration Manager.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ObjectMigrationJobType

Indique que le type de travail est une tâche de migration d’objet.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ObjectModifiedAfterMigrationJobType

Indique que le nouveau travail de migration inclut uniquement les objets qui ont été modifiés depuis la dernière migration.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-OverwriteAllObject

Indique s’il faut remplacer les objets dans la base de données de destination.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SaveCollectionInfoPath

Spécifie un chemin d’accès pour les informations de collection.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SaveObjectInfoPath

Spécifie un chemin d’accès pour les informations sur l’objet.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SecurityScope

Spécifie un tableau d’objets d’étendue de sécurité. Pour obtenir un objet d’étendue de sécurité, utilisez l’applet de commande Get-CMSecurityScope . L’applet de commande applique les étendues de sécurité que vous spécifiez aux données migrées vers la hiérarchie de destination.

Type:IResultObject[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SiteCodeReplacementMapping

Spécifie les paires clé-valeur qui mappent une collection migrée à un site dans la destination.

Type:Hashtable
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TransferOrganizationalFolderStructure

Indique s’il faut migrer une collection vide. Configuration Manager convertit le regroupement vide en dossier organisationnel.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UtcTime

Indique s’il faut utiliser l’heure UTC.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Sorties

IResultObject