Export-CMCollection

  • Référence
Module:
ConfigurationManager

Exporter une collection.

Syntax

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 des regroupements dans Configuration Manager.

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 : 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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-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

-ExportComment

Spécifiez un commentaire facultatif pour la collection exportée dans le fichier MOF.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExportFilePath

Spécifiez le chemin d’accès complet du fichier d’exportation. Incluez l’extension .mofde fichier .

Type:String
Aliases:FileName, FilePath, Path
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Force

Exécutez la commande sans demander de confirmation.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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 objet de collection à exporter. Pour obtenir cet objet, utilisez les applets de commande Get-CMCollection, Get-CMDeviceCollection ou Get-CMUserCollection .

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Spécifiez le nom d’une collection à exporter.

Type:String
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