Partilhar 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 morto 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 ficheiro a 2 GB. A API .NET funciona com arquivos que estão em conformidade com a especificação oficial de 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 existente para a 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 existente na pasta atual para a pasta especificada pelo parâmetro DestinationPath .

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

Parâmetros

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DestinationPath

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

Tipo:String
Position:1
Default value:A folder in the current location
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Force

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PassThru

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Path

Especifica o caminho para o arquivo morto.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

Você pode canalizar uma cadeia de caracteres que contém um caminho para um arquivo morto 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.

Notas

O Compress-Archive cmdlet usa 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.