Export-CMCollection

  • Referencia
Módulo:
ConfigurationManager

Exportar una colección.

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

Use este cmdlet para guardar un objeto de colección en un archivo de formato de objeto administrado (.mof).

A continuación, puede importarlo al mismo sitio o a otro Configuration Manager. Puede usar este proceso de exportación e importación para realizar copias de seguridad de colecciones personalizadas o para el ciclo de vida de desarrollo. Por ejemplo, desarrolla una nueva colección en un entorno de laboratorio. Exporte la colección desde el entorno de prueba y, a continuación, impórtelo en la jerarquía de producción.

Para obtener más información, consulte Administración de colecciones en Configuration Manager.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio Configuration Manager, por ejemploPS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Exportación de una colección por nombre

Este comando exporta la colección denominada testUser al archivo denominado collection.mof.

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

Ejemplo 2: Exportación de todas las colecciones

En este ejemplo se usa primero el cmdlet Get-CMCollection para obtener todas las colecciones y se almacenan en la variable allColl . A continuación, recorre en bucle cada colección y la exporta a un archivo independiente. Usa el nombre de la colección ($coll.Name) como nombre de archivo.

$allColl = Get-CMCollection

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

Parámetros

-CollectionId

Especifique el identificador de una colección que se va a exportar. Este valor es la propiedad CollectionID , por ejemplo, XYZ00012.

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

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

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

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

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

-ExportComment

Especifique un comentario opcional para la colección exportada en el archivo MOF.

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

-ExportFilePath

Especifique la ruta de acceso completa para el archivo de exportación. Incluya la extensión de .mofarchivo .

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

-Force

Ejecute el comando sin pedir confirmación.

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

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

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

-InputObject

Especifique un objeto de colección que se va a exportar. Para obtener este objeto, use los cmdlets Get-CMCollection, Get-CMDeviceCollection o Get-CMUserCollection .

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

-Name

Especifique el nombre de una colección que se va a exportar.

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

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object