Expand-Archive

モジュール:

Microsoft.PowerShell.Archive

指定した ZIP アーカイブ ファイルからファイルを抽出します。

構文

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

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

説明

Expand-Archive コマンドレットは、指定した zip 形式のアーカイブ ファイルから指定したコピー先フォルダーにファイルを抽出します。 アーカイブ ファイルを使用すると、配布と保存を容易にするために、複数のファイルを 1 つの zip 形式のファイルにパッケージ化し、必要に応じて圧縮できます。

Expand-Archive コマンドレットは、System.IO.Compression.ZipArchive API を使用してファイルを圧縮します。 この API では、最大ファイル サイズが 2 GB に制限されます。 .NET API は、PKWARE Inc. の公式 ZIP ファイル形式仕様に準拠したファイルで動作します。詳細については、「 System.IO.Compression.ZipArchiveを参照してください。

例

例 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

コマンドレットの実行前に確認を求めるメッセージが表示されます。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DestinationPath

既定では、 Expand-Archive は ZIP ファイルと同じ名前のフォルダーを現在の場所に作成します。 このパラメーターを使用すると、別のフォルダーへのパスを指定できます。 ターゲット フォルダーが存在しない場合は作成されます。

型:	String
配置:	1
規定値:	A folder in the current location
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Force

既存のファイルを上書きするには、このパラメーターを使用します。 既定では、 Expand-Archive は上書きされません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-LiteralPath

アーカイブ ファイルへのパスを指定します。 Path パラメーターとは異なり、LiteralPath の値は、型指定されたとおりに使用されます。 ワイルドカード文字はサポートされていません。 パスにエスケープ文字が含まれている場合は、各エスケープ文字を単一引用符で囲んで、文字をエスケープ シーケンスとして解釈しないように PowerShell に指示します。

型:	String
Aliases:	PSPath
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-PassThru

コマンドレットがアーカイブから展開されたファイルの一覧を出力します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Path

アーカイブ ファイルへのパスを指定します。

型:	String
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 コマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

String

既存のアーカイブ ファイルへのパスを含む文字列をパイプ処理できます。

出力

None

既定では、このコマンドレットは出力を返しません。

FileSystemInfo

PassThru パラメーターを使用すると、このコマンドレットはアーカイブから展開されたファイルの一覧を返します。

メモ

Compress-Archive コマンドレットは UTF-8 エンコードを使用します。 他の ZIP アーカイブ ツールでは、別のエンコード スキームを使用できます。 UTF-8 エンコードを使用して保存されていないファイル名を含むファイルを抽出する場合、 Expand-Archive はアーカイブ内の生の値を使用します。 これにより、アーカイブに格納されているソース ファイル名とは異なるファイル名が生成される可能性があります。

関連リンク

• Compress-Archive