Expand-Archive
Extrai arquivos de um arquivo morto especificado (compactado).
Sintaxe
Path (Padrã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 morto 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 morto
Este exemplo extrai o conteúdo de um arquivo de 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 morto na pasta atual
Este exemplo extrai o conteúdo de um arquivo de 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DestinationPath
Por padrão, Expand-Archive cria uma pasta no local atual que é 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 ela não existir.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | A folder in the current ___location |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Force
Use esse parâmetro para substituir arquivos existentes. Por padrão, Expand-Archive não substitui.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-LiteralPath
Especifica o caminho para um arquivo morto. Ao contrário do parâmetro caminho
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | PSPath |
Conjuntos de parâmetros
LiteralPath
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-PassThru
Faz com que o cmdlet gere uma lista dos arquivos expandidos do arquivo morto.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Path
Especifica o caminho para o arquivo morto.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Path
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 morto.
Observações
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 arquivo não armazenados usando a codificação UTF-8, Expand-Archive usa o valor bruto encontrado no arquivo morto. Isso pode resultar em um nome de arquivo diferente do nome de arquivo de origem armazenado no arquivo.
