Condividi tramite

Export-CMCollection

  • Riferimento
Modulo:
ConfigurationManager

Esportare una raccolta.

Sintassi

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

Descrizione

Utilizzare questo cmdlet per salvare un oggetto raccolta in un file di formato oggetto gestito (.mof).

È quindi possibile importarlo nello stesso sito o in un altro sito di Configuration Manager. È possibile usare questo processo di esportazione/importazione per eseguire il backup di raccolte personalizzate o per il ciclo di vita dello sviluppo. Ad esempio, si sviluppa una nuova raccolta in un ambiente lab. Esportare la raccolta dall'ambiente di test e quindi importarla nella gerarchia di produzione.

Per altre informazioni, vedere Come gestire le raccolte in Configuration Manager.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Esportare una raccolta per nome

Questo comando esporta la raccolta denominata testUser nel file denominato collection.mof.

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

Esempio 2: Esportare tutte le raccolte

Questo esempio usa innanzitutto il cmdlet Get-CMCollection per ottenere tutte le raccolte e le archivia nella variabile allColl . Viene quindi eseguito un ciclo in ogni raccolta ed esportato in un file separato. Usa il nome della raccolta ($coll.Name) come nome file.

$allColl = Get-CMCollection

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

Parametri

-CollectionId

Specificare l'ID di una raccolta da esportare. Questo valore è la proprietà CollectionID , ad esempio XYZ00012.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ExportComment

Specificare un commento facoltativo per la raccolta esportata nel file MOF.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ExportFilePath

Specificare il percorso completo per il file di esportazione. Includere l'estensione .mofdel file .

Tipo:String
Alias:FileName, FilePath, Path
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Eseguire il comando senza richiedere conferma.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specificare un oggetto raccolta da esportare. Per ottenere questo oggetto, usare i cmdlet Get-CMCollection, Get-CMDeviceCollection o Get-CMUserCollection .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specificare il nome di una raccolta da esportare.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object