Export-CMCollection
Exporter une collection.
Syntaxe
Export-CMCollection
[-ExportComment <String>]
-ExportFilePath <String>
[-Force]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Export-CMCollection
-CollectionId <String>
[-ExportComment <String>]
-ExportFilePath <String>
[-Force]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Export-CMCollection
[-ExportComment <String>]
-ExportFilePath <String>
[-Force]
-InputObject <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Utilisez cette applet de commande pour enregistrer un objet de collection dans un fichier de format d’objet managé (.mof
).
Vous pouvez ensuite l’importer dans le même site Configuration Manager ou dans un autre site. Vous pouvez utiliser ce processus d’exportation/importation pour sauvegarder des collections personnalisées ou pour le cycle de vie du développement. Par exemple, vous développez une nouvelle collection dans un environnement lab. Exportez la collection à partir de l’environnement de test, puis importez-la dans la hiérarchie de production.
Pour plus d’informations, consultez Guide pratique pour gérer les regroupements 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 : Exporter une collection par nom
Cette commande exporte la collection nommée testUser vers le fichier nommé collection.mof.
Export-CMCollection -Name "testUser" -ExportFilePath "C:\collection.mof"
Exemple 2 : Exporter toutes les collections
Cet exemple utilise d’abord l’applet de commande Get-CMCollection pour obtenir toutes les collections et les stocke dans la variable allColl . Il effectue ensuite une boucle dans chaque collection et l’exporte vers un fichier distinct. Il utilise le nom de la collection ($coll.Name
) comme nom de fichier.
$allColl = Get-CMCollection
foreach ( $coll in $allcoll ) {
Export-CMCollection -InputObject $coll -ExportFilePath "D:\Export\Collections\$($coll.Name).mof"
}
Paramètres
-CollectionId
Spécifiez l’ID d’une collection à exporter. Cette valeur est la propriété CollectionID, par exemple . XYZ00012
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 |
-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 |
-ExportComment
Spécifiez un commentaire facultatif pour la collection exportée dans le fichier MOF.
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 |
-ExportFilePath
Spécifiez le chemin d’accès complet du fichier d’exportation. Incluez l’extension .mof
de fichier .
Type: | String |
Alias: | FileName, FilePath, Path |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Force
Exécutez la commande sans demander de confirmation.
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 |
-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 objet de collection à exporter. Pour obtenir cet objet, utilisez les applets de commande Get-CMCollection, Get-CMDeviceCollection ou Get-CMUserCollection .
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 |
-Name
Spécifiez le nom d’une collection à exporter.
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 |
-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