Export-CMConfigurationItem

  • Referência
Módulo:
ConfigurationManager

Guarda um item de configuração do Configuration Manager num ficheiro.

Sintaxe

Export-CMConfigurationItem
      [-Name] <String>
      -Path <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Export-CMConfigurationItem
      [-Id] <Int32>
      -Path <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Export-CMConfigurationItem
      [-InputObject] <IResultObject>
      -Path <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Export-CMConfigurationItem guarda um item de configuração do Configuration Manager num ficheiro de .cab especificado. Pode especificar itens por ID, nome ou através do cmdlet Get-CMConfigurationItem .

Os itens de configuração contêm uma ou mais definições, juntamente com as regras de conformidade. Para obter mais informações sobre itens de configuração, veja Introdução às Definições de Compatibilidade no Configuration Manager.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Exportar um item com um ID

PS XYZ:\>Export-CMConfigurationItem -Id "16777568" -Path "C:\Exports\CI16777568.cab"

Este comando exporta um item de configuração com o identificador com o nome 16777568 para o ficheiro especificado.

Exemplo 2: Exportar um item com um nome

PS XYZ:\>Export-CMConfigurationItem -Name "ConfigItem76" -Path "C:\Exports\CIConfigItem76.cab"

Este comando exporta um item de configuração com o nome ConfigItem76 para o ficheiro especificado.

Exemplo 3: Exportar um item com uma variável

PS XYZ:\> $CIObj=Get-CMConfigurationItem -Id "16777568"
PS XYZ:\> Export-CMConfigurationItem -InputObject $CIObj -Path "C:\Exports\CI16777568.cab"

O primeiro comando obtém um item de configuração com o identificador especificado e armazena-o na variável $CIObj.

O segundo comando exporta o item na variável $CIObj para o ficheiro especificado.

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

Especifica uma matriz de identificadores para um ou mais itens de configuração. Pode utilizar uma lista separada por vírgulas.

Tipo:Int32
Aliases:CIId, CI_ID
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifica um objeto de item de configuração. Para obter um objeto de item de configuração, pode utilizar o cmdlet Get-CMConfigurationItem .

Tipo:IResultObject
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Especifica uma matriz de nomes de itens de configuração. Pode utilizar uma lista separada por vírgulas.

Tipo:String
Aliases:LocalizedDisplayName
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Path

Especifica um caminho de ficheiro completo para um ficheiro de exportação.

Tipo:String
Aliases:FileName, FilePath, ExportFilePath
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object