Expand-Archive

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

Extrai arquivos de um arquivo especificado (zipado).

Syntax

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.

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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:1
Default value:A folder in the current location
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-PassThru

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

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

-Path

Especifica o caminho para o arquivo morto.

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.