Partager via

Move-CMObject

  • Référence
Module:
ConfigurationManager

Déplacez un objet Configuration Manager dans un autre dossier.

Syntaxe

Move-CMObject
    -FolderPath <String>
    -InputObject <IResultObject[]>
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Move-CMObject
    -FolderPath <String>
    -ObjectId <String[]>
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

L’applet de commande Move-CMObject déplace un objet Configuration Manager dans un autre dossier. Spécifiez l’objet à déplacer et le dossier de destination. Étant donné qu’un objet existe dans un seul dossier, l’applet de commande ne spécifie pas le dossier actif.

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 : Déplacer une application par objet

Cet exemple obtient d’abord un objet d’application par son nom. Il déplace ensuite l’objet vers le dossier TestFolder.

$app = Get-CMApplication -Name "Teams"
Move-CMObject -FolderPath "XYZ:\Application\TestFolder" -InputObject $app

Exemple 2 : Déplacer une séquence de tâches par ID

Cet exemple montre comment déplacer la séquence de tâches avec l’ID de package XYZ00550 vers le dossier Développement .

Move-CMObject -FolderPath "XYZ:\TaskSequence\Development" -ObjectId "XYZ00550"

Paramètres

-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

-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

-FolderPath

Spécifie un chemin d’accès au dossier de destination, au format suivant : <site code>:\<object type>\folder\subfolder\subfolder.

  • <site code>: code de site Configuration Manager.
  • <object type>: un des mots clés suivants pour le type d’objet à déplacer :
    • Application
    • Image de démarrage
    • ConfigurationBaseline
    • ConfigurationItem
    • DeviceCollection
    • Driver
    • DriverPackage
    • OperatingSystemImage
    • OperatingSystemInstaller
    • Package
    • Query
    • TaskSequence
    • UserCollection
    • UserStateMigration

Par exemple, un dossier nommé LOB Apps pour une application sur le site CM1 a le chemin de fichier suivant : CM1:\Application\LOB Apps.

Pour déplacer un objet vers le dossier racine, ne spécifiez pas de dossier. Par exemple : CM1:\Application.

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

-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

-InputObject

Spécifiez un tableau d’objets Configuration Manager à déplacer. Si vous spécifiez un tableau, utilisez le même type d’objet. Faites correspondre le type d’objet avec le mot clé utilisé avec le paramètre -FolderPath .

Utilisez l’une des applets de commande suivantes pour obtenir ces objets :

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

-ObjectId

Spécifie un tableau d’ID d’objet à déplacer. Si vous spécifiez un tableau, utilisez le même type d’objet. Faites correspondre le type d’objet avec le mot clé utilisé avec le paramètre -FolderPath .

Par exemple : XYZ00550.

Type:String[]
Alias:InstanceKey
Position:Named
Valeur par défaut:None
Obligatoire:True
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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Sorties

System.Object