Compartilhar via

Expand-Archive

  • Referência
Módulo:
Microsoft.PowerShell.Archive

Extrai arquivos de um arquivo ZIP especificado.

Sintaxe

Expand-Archive
      [-Path] <String>
      [[-DestinationPath] <String>]
      [-Force]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Expand-Archive
      -LiteralPath <String>
      [[-DestinationPath] <String>]
      [-Force]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O Expand-Archive cmdlet extrai arquivos de um arquivo compactado especificado para uma pasta de destino especificada. Um arquivo compactado permite que vários arquivos sejam empacotados e, opcionalmente, compactados em um único arquivo compactado para facilitar a distribuição e o armazenamento.

O Expand-Archive cmdlet usa a API System.IO.Compression.ZipArchive para compactar arquivos. A API limita o tamanho máximo do arquivo a 2 GB. A API do .NET funciona com arquivos que estão em conformidade com a especificação oficial do formato de arquivo ZIP da PKWARE Inc. Para obter mais informações, consulte System.IO.Compression.ZipArchive.

Exemplos

Exemplo 1: Extrair o conteúdo de um arquivo

Este exemplo extrai o conteúdo de um arquivo morto existente na pasta especificada pelo parâmetro DestinationPath .

Expand-Archive -LiteralPath 'C:\Archives\Draft[v1].zip' -DestinationPath C:\Reference

Neste exemplo, o parâmetro LiteralPath é usado porque o nome do arquivo contém caracteres que podem ser interpretados como curingas.

Exemplo 2: Extrair o conteúdo de um arquivo na pasta atual

Este exemplo extrai o conteúdo de um arquivo morto existente na pasta atual para a pasta especificada pelo parâmetro DestinationPath .

Expand-Archive -Path Draftv2.zip -DestinationPath C:\Reference

Parâmetros

-Confirm

Solicita sua 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

-DestinationPath

Por padrão, Expand-Archive cria uma pasta no local atual com o mesmo nome do arquivo ZIP. O parâmetro permite que você especifique o caminho para uma pasta diferente. A pasta de destino será criada se não existir.

Tipo:String
Cargo:1
Valor padrão:A folder in the current location
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

Use esse parâmetro para substituir os arquivos existentes. Por padrão, Expand-Archive não substitui.

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

-LiteralPath

Especifica o caminho para um arquivo morto. Ao contrário do parâmetro Path , o valor de LiteralPath é usado exatamente como é digitado. Não há suporte para caracteres curinga. Se o caminho incluir caracteres de escape, coloque cada caractere de escape entre aspas simples, para instruir o PowerShell a não interpretar nenhum caractere como sequências de escape.

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

-PassThru

Faz com que o cmdlet gere uma lista dos arquivos expandidos do arquivo morto.

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

-Path

Especifica o caminho para o arquivo morto.

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

-WhatIf

Mostra 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

String

Você pode canalizar uma cadeia de caracteres que contém um caminho para um arquivo existente.

Saídas

None

Por padrão, esse cmdlet não retorna nenhuma saída.

FileSystemInfo

Quando você usa o parâmetro PassThru , esse cmdlet retorna uma lista de arquivos que foram expandidos do arquivo morto.

Observações

O Compress-Archive cmdlet usa a codificação UTF-8. Outras ferramentas de arquivo ZIP podem usar um esquema de codificação diferente. Ao extrair arquivos com nomes de arquivos não armazenados usando codificação UTF-8, Expand-Archive usa o valor bruto encontrado no arquivo. Isso pode resultar em um nome de arquivo diferente do nome de arquivo de origem armazenado no arquivo.