Export-CMPackage

  • Referência
Módulo:
ConfigurationManager

Exportar um pacote legado.

Sintaxe

Export-CMPackage
      [-Comment <String>]
      -FileName <String>
      [-Force]
      -InputObject <IResultObject>
      [-WithContent <Boolean>]
      [-WithDependence <Boolean>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Export-CMPackage
      [-Comment <String>]
      -FileName <String>
      [-Force]
      -Id <String>
      [-WithContent <Boolean>]
      [-WithDependence <Boolean>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Export-CMPackage
      [-Comment <String>]
      -FileName <String>
      [-Force]
      -Name <String>
      [-WithContent <Boolean>]
      [-WithDependence <Boolean>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Utilize este cmdlet para exportar um pacote legado do Configuration Manager. Pode utilizar o cmdlet Import-CMPackage para importar um pacote legado para outro site.

O ramo atual do Configuration Manager continua a suportar pacotes e programas que foram utilizados no Configuration Manager 2007. Para obter mais informações, veja Pacotes e programas no Configuration Manager.

Importante

Este cmdlet não suporta o PowerShell 7. Requer o .NET Framework em vez do .NET Core que é utilizado com a versão 7 do PowerShell.

A partir da versão 2103, se tentar utilizar este cmdlet numa sessão do PowerShell versão 7, este falha com o seguinte erro: This cmdlet only supports the ".NET Framework" runtime.

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 pacote com um ID

Este comando exporta um pacote que tem o ID ST120001 para um caminho de rede.

Export-CMPackage -Id "ST120001" -FileName "\\Deploy01\ExportPackages\ST120001.zip"

Exemplo 2: Exportar um pacote com uma variável

O primeiro comando obtém o pacote que tem o ID ST120001 e, em seguida, armazena-o na variável $DeplObj. O segundo comando exporta o pacote para o caminho de rede com a variável .

$DeplObj = Get-CMPackage -Id "ST120001"
Export-CMPackage - "ST120001" -FileName "\\Deploy01\ExportPackages\ST120001.zip" -InputObject $DeplObj

Parâmetros

-Comment

Especifique um comentário de administrador opcional. Este comentário é apresentado no Assistente de Importação de Pacotes.

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

-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

-FileName

Especifique o caminho de rede do pacote. O caminho tem de especificar o ficheiro, incluindo a .zip extensão.

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

-Force

Execute o comando sem pedir confirmação.

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

Especifique o ID do pacote a exportar. Este valor é o ID do pacote padrão, por exemplo XYZ00123.

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

-InputObject

Especifique um objeto de pacote a exportar. Para obter este objeto, utilize o cmdlet Get-CMPackage .

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

-Name

Especifique o nome de um pacote a exportar.

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

-WithContent

Defina este parâmetro como $true para exportar todo o conteúdo do pacote e das dependências.

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

-WithDependence

Defina este parâmetro como $true para exportar todas as dependências do pacote.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object