Export-CMCollection

  • Referenz
Modul:
ConfigurationManager

Exportieren einer Sammlung.

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>]

Beschreibung

Verwenden Sie dieses Cmdlet, um ein Auflistungsobjekt in einer Verwalteten Objektformatdatei (.mof) zu speichern.

Anschließend können Sie sie in dieselbe oder eine andere Configuration Manager-Website importieren. Sie können diesen Export-/Importprozess zum Sichern benutzerdefinierter Sammlungen oder für den Entwicklungslebenszyklus verwenden. Beispielsweise entwickeln Sie eine neue Sammlung in einer Labumgebung. Exportieren Sie die Sammlung aus der Testumgebung, und importieren Sie sie dann in die Produktionshierarchie.

Weitere Informationen finden Sie unter Verwalten von Sammlungen in Configuration Manager.

Hinweis

Führen Sie Configuration Manager Cmdlets auf dem Configuration Manager-Websitelaufwerk aus, z. PS XYZ:\>B. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Exportieren einer Auflistung anhand des Namens

Dieser Befehl exportiert die Auflistung testUser in die Datei collection.mof.

Export-CMCollection -Name "testUser" -ExportFilePath "C:\collection.mof"

Beispiel 2: Exportieren aller Sammlungen

In diesem Beispiel wird zunächst das Cmdlet Get-CMCollection verwendet, um alle Sammlungen abzurufen, und diese in der Variablen allColl gespeichert. Anschließend durchläuft er jede Auflistung und exportiert sie in eine separate Datei. Als Dateiname wird der Sammlungsname ($coll.Name) verwendet.

$allColl = Get-CMCollection

foreach ( $coll in $allcoll ) {
  Export-CMCollection -InputObject $coll -ExportFilePath "D:\Export\Collections\$($coll.Name).mof"
}

Parameter

-CollectionId

Geben Sie die ID einer zu exportierenden Sammlung an. Dieser Wert ist die CollectionID-Eigenschaft , z. B XYZ00012. .

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

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

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

-ExportComment

Geben Sie einen optionalen Kommentar für die exportierte Auflistung in der MOF-Datei an.

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

-ExportFilePath

Geben Sie den vollständigen Pfad für die Exportdatei an. Schließen Sie die Dateierweiterung ein .mof.

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

-Force

Führen Sie den Befehl aus, ohne zur Bestätigung zu fragen.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

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

-InputObject

Geben Sie ein zu exportierende Auflistungsobjekt an. Verwenden Sie zum Abrufen dieses Objekts die Cmdlets Get-CMCollection, Get-CMDeviceCollection oder Get-CMUserCollection .

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

-Name

Geben Sie den Namen einer zu exportierenden Auflistung an.

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

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object