Expand-Archive
Extrai arquivos de um arquivo especificado (zipado).
Sintaxe
Path (Predefinição)
Expand-Archive
[-Path] <String>
[[-DestinationPath] <String>]
[-Force]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
LiteralPath
Expand-Archive
[[-DestinationPath] <String>]
-LiteralPath <String>
[-Force]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Expand-Archive 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 morto 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 confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | A folder in the current location |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Force
Use esse parâmetro para substituir arquivos existentes. Por padrão, Expand-Archive não substitui.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | PSPath |
Conjuntos de parâmetros
LiteralPath
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-PassThru
Faz com que o cmdlet produza uma lista dos arquivos expandidos do arquivo.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Path
Especifica o caminho para o arquivo morto.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
Path
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
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 cmdlet Compress-Archive 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.
