指定したアーカイブ (zip) ファイルからファイルを抽出します。
構文
Expand-Archive <String> <String>]
Expand-Archive -LiteralPath <String> <String>]
説明
Expand-Archive
コマンドレットは、指定された zip アーカイブ ファイルからファイルを指定された宛先フォルダーに抽出します。
Examples
Example 1: Extract a contents of an archive
この例では、既存のアーカイブ ファイルの内容を、DestinationPath パラメーターで指定されたフォルダーに抽出します。
Expand-Archive -LiteralPath 'C:\Archives\Draft.Zip' -DestinationPath C:\Reference
この例では、ファイル名にワイルドカードとして解釈できる文字が含まれているため、LiteralPathパラメータが使用されます。
Example 2: Extract of an archive in the current folder
この例では、現在のフォルダにある既存のアーカイブ ファイルの内容を、DestinationPathパラメータで指定されたフォルダに抽出します。
Expand-Archive -Path Draftv2.Zip -DestinationPath C:\Reference
パラメータ
コマンドレットを実行する前に確認のためのプロンプトが表示されます。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
ワイルドカード文字を受け付けます。 | False |
デフォルトでは、Expand-Archive
は、現在の場所にZIPファイルと同じ名前のフォルダを作成します。 パラメータでは、別のフォルダへのパスを指定することができます。 対象となるフォルダーが存在しない場合には、そのフォルダーが作成されます。
Type: | String |
Position: | 1 |
Default value: | 現在の場所にあるフォルダ |
パイプラインの入力を受け付けます。 | False |
Accept wildcard characters: | False |
ユーザーの確認を求めずにコマンドを強制的に実行します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
アーカイブファイルへのパスを指定します。 Pathパラメータとは異なり、LiteralPathの値は、入力された通りに使用されます。 ワイルドカード文字はサポートされていません。 パスにエスケープ文字が含まれている場合は、各エスケープ文字をシングルクォーテーションで囲み、PowerShellがエスケープシーケンスと解釈しないようにします。
Type: | String |
Aliases: | PSPath |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
アーカイブから展開されたファイルのリストを出力するようにコマンドレットを呼び出します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
アーカイブファイルのパスを指定します。
Type: | String |
Position: | 0 |
Default value: | None |
パイプラインの入力を受け付けます。 | True |
Accept wildcard characters: | False |
コマンドレットが実行された場合に何が起こるかを示します。 このコマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
String
既存のアーカイブファイルへのパスを含んだ文字列をパイプすることができます。
出力
FileSystemInfo
-PassThru
パラメータが使用されると、コマンドレットはアーカイブから展開されたファイルのリストを出力します。
注意
ZIP ファイルの仕様では、非 ASCII 文字を含むファイル名の標準的なエンコード方法は指定されていません。 Compress-Archive
コマンドレットは UTF-8 エンコーディングを使用します。 他の ZIP アーカイブ ツールは、異なるエンコーディング方式を使用する場合があります。 UTF-8 エンコーディングを使用して保存されていないファイル名のファイルを抽出する場合、Expand-Archive
はアーカイブ内の生の値を使用します。
- Compress-Archive
- Compress-Archive