Expand-Archive

  • 参考
模块:
Microsoft.PowerShell.Archive

从指定的存档（压缩）文件中提取文件。

语法

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

说明

Expand-Archive cmdlet 将文件从指定的压缩存档文件提取到指定的目标文件夹。 存档文件允许将多个文件打包，还可选择性地将其压缩为单个压缩文件以便分发和存储。

示例

示例 1：提取存档的内容

此示例将现有存档文件的内容提取到由 DestinationPath 参数指定的文件夹中。

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

此示例中使用了 LiteralPath 参数，因为文件名包含可能会被解释为通配符的字符。

示例 2：提取当前文件夹中存档的内容

此示例将当前文件夹中某个现有存档文件的内容提取到由 DestinationPath 参数指定的文件夹中。

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

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-DestinationPath

默认情况下，Expand-Archive 会在当前位置创建一个与 ZIP 文件同名的文件夹。 此参数允许指定其他文件夹的路径。 如果目标文件夹不存在，则会创建目标文件夹。

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

-Force

使用此参数覆盖现有文件。 默认情况下，Expand-Archive 不会覆盖。

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

-LiteralPath

指定存档文件的路径。 与 Path 参数不同，LiteralPath 的值严格按照所键入的形式使用。 不支持通配符。 如果路径包括转义符，用单引号将每个转义符括起来，以指示 PowerShell 不要将任何字符解释为转义序列。

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

-PassThru

使 cmdlet 输出从存档展开的文件列表。

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

-Path

指定存档文件的路径。

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

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

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

输入

String

可以通过管道传递包含现有存档文件路径的字符串。

输出

None

默认情况下，此 cmdlet 不返回任何输出。

FileSystemInfo

使用 PassThru 参数时，此 cmdlet 返回从存档展开的文件列表。

备注

Compress-Archive cmdlet 使用 UTF-8 编码。 其他 ZIP 存档工具可能使用不同的编码方案。 如果文件名不是使用 UTF-8 编码存储的，则提取该文件时，Expand-Archive 将使用存档中找到的原始值。 这可能会导致文件名与存档中存储的源文件名不同。