Move-CMObject

  • Référence
Module:
ConfigurationManager

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

Syntax

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 Configuration Manager applets de commande à 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
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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[]
Aliases:InstanceKey
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Sorties

System.Object