Amazon S3 を PowerShell ドライブとして使用する

5.0.288 AWS.Tools.S3 以降に適用されます。S3 ドライブプロバイダーとそのコマンドレットは、Windows PowerShell 5.1 および PowerShell 7+ (Windows、Linux、macOS) で動作する AWS.Tools.S3モジュールに付属しています。

S3 PowerShell ドライブを使用すると、Amazon S3 ストレージをドライブとしてマウントし、ローカルディスクと同じように操作できます。ドライブをマウントすると、プロバイダーはバケットとプレフィックスをフォルダとして、オブジェクトをファイルとして表示します。一般的なナビゲーションコマンドは、、、、Set-LocationGet-ChildItemGet-Content、 などSet-Content、S3 に対して直接機能しますRemove-Item。

このトピックでは、S3 ドライブの認証情報、リージョン、および安全動作に加えて、インストール、マウント、ナビゲーション、コンテンツの転送、アンマウントについて説明します。

前提条件

モジュールをインポートすると、 という名前の PowerShell プロバイダーが登録されますAWS.S3。利用可能なことを確認できます。

Get-PSProvider AWS.S3

ドライブのマウント

Mount-S3PSDrive を使用してドライブを作成します。-Name パラメータはすべてのパスのドライブ名になります (たとえば、 は のようなパス-Name S3を提供しますS3:/amzn-s3-demo-bucket/reports/index.txt)。

# Mount an S3: drive using a named profile and Region
Mount-S3PSDrive -Name S3 -ProfileName my-profile -Region us-east-1
# List buckets
Get-ChildItem S3:/

サンプル出力:

   Type     LastModified              Size Name
   ----     ------------              ---- ----
   Bucket   2026-06-02 09:14:03            amzn-s3-demo-app-logs
   Bucket   2026-01-08 16:47:51            amzn-s3-demo-reports

Set-AWSCredential および でセッションのデフォルトを既に設定している場合はSet-DefaultAWSRegion、他のパラメータなしでマウントできます。

Set-AWSCredential -ProfileName my-profile
Set-DefaultAWSRegion us-west-2
Mount-S3PSDrive -Name S3

Mount-S3PSDrive は、PowerShell 組み込み の薄いラッパーですNew-PSDrive。必要に応じて、ドライブを直接作成し、同じ認証情報とリージョンパラメータを渡すことができます。

New-PSDrive -Name S3 -PSProvider AWS.S3 -Root '' -Scope Global -ProfileName my-profile -Region us-east-1

デフォルトでは、出力はMount-S3PSDrive生成されません。PSDriveInfo オブジェクトを戻す-PassThru場合は、 を追加します。

認証情報とリージョンの解決方法

S3 ドライブは、S3 コマンドレットとまったく同じリージョンを認証して選択します。最初に明示的なパラメータ、次にセッションのデフォルトが Set-AWSCredentialと で設定されSet-DefaultAWSRegion、次に SDK のデフォルトチェーンのプロファイル、環境、インスタンスメタデータソースが設定されます。完全な解決順序については、AWS 認証情報の使用「」および「」を参照してくださいの AWS リージョンを指定する AWS Tools for PowerShell。

リージョンを指定しない場合、ドライブは にフォールバックしますus-east-1。マウントするリージョンは開始リージョンにすぎません。1 つのドライブがリージョン間でバケットに到達できます (「」を参照1 つのドライブからリージョン間でバケットにアクセスする)。

不正なプロファイル、欠落しているバケット、またはプレフィックスが で失敗しますMount-S3PSDrive。一部のアクセス許可エラーは、オブジェクトにアクセスするまで表示されない場合があります。

ローカルドライブのように Amazon S3 を操作する

ドライブをマウントしたら、一般的な PowerShell ドライブコマンドで移動します。S3 には実際のフォルダはありませんが、プロバイダーはプレフィックスをフォルダとして表示するため、同じ方法で移動できます。

# Change into a bucket, then a prefix
Set-Location S3:/amzn-s3-demo-reports/2026
# List the current location
Get-ChildItem

サンプル出力:

   Type     LastModified              Size Name
   ----     ------------              ---- ----
   Folder                                  q1
   Folder                                  q2
   Object   2026-03-31 18:02:11      48210 summary.txt

# List a path without changing location
Get-ChildItem S3:/amzn-s3-demo-bucket/reports/2026

タブ補完はバケット、プレフィックス、オブジェクトに対して機能するため、フルネームを入力せずにパスを完了できます。

Get-ChildItem は、、Name、Type、および LastModifiedプロパティを公開するオブジェクトとしてSize各項目を返します。これらのプロパティにより、 は Where-Objectや などのコマンドに直接パイプできますSort-Object。 Typeは Bucket、Folder、または のいずれかですObject。フォルダとバケットのサイズはありません。

# List the 10 largest objects with the prefix "2026"
Get-ChildItem S3:/amzn-s3-demo-app-logs/2026 -Recurse |
    Where-Object Type -eq 'Object' |
    Sort-Object Size -Descending |
    Select-Object -First 10 Name, Size, LastModified

その他のナビゲーションコマンドもドライブで機能します。

# Retrieve the single item at an exact path (no children)
Get-Item S3:/amzn-s3-demo-bucket/reports/index.txt
# Test whether a path exists and whether it is a folder or an object
Test-Path S3:/amzn-s3-demo-bucket/reports                              # -> True
Test-Path S3:/amzn-s3-demo-bucket/reports -PathType Container          # -> True (a prefix)
Test-Path S3:/amzn-s3-demo-bucket/reports/index.txt -PathType Leaf     # -> True (an object)

では-Recurse、項目の Nameはプレフィックスに対するキーであり ( を含めることができるため/)、同じリーフ名は異なるプレフィックスの下に表示されます。リストされた項目を明確 (パイプ処理など) に識別する必要がある場合は、 PSPath ではなく を使用しますName。

# Read each listed object by explicit PSPath
Get-ChildItem S3:/amzn-s3-demo-bucket/prefix | ForEach-Object {
    Get-Content -LiteralPath $_.PSPath -AsByteStream -Raw
}

Get-Content -LiteralPath 'S3:/amzn-s3-demo-bucket/data[2026].csv' -Raw

S3 からオブジェクトを読み取る

Get-Content は オブジェクトをダウンロードします。デフォルトでは、テキスト行を行単位で返します。オブジェクト全体を単一の文字列として返-Rawすには、 を追加します。Get-Content と は、-Encodingテキストと-AsByteStreamバイナリコンテンツの両方Set-Contentをサポートしています。

# Read an object line by line
Get-Content S3:/amzn-s3-demo-reports/2026/summary.txt
# Read the whole object as one string
Get-Content S3:/amzn-s3-demo-reports/2026/summary.txt -Raw

テキスト以外のオブジェクトの場合は、 -AsByteStream を使用して raw バイトを取得します。S3 パスでは、S3 プロバイダーが パラメータを指定するため、PowerShell 7+ と Windows PowerShell 5.1 の両方で機能します。ローカルファイルのみがエディションによって異なります (「」を参照ローカルファイルのバイトの読み取りはエディションによって異なります)。テキストデコードを制御するには、標準の PowerShell エンコード名 (UTF8、UTF8BOM、Unicode、 ASCIIなど) -Encodingのいずれかで を追加します。デフォルトは、 Get-Contentと の両方で BOM を使用しない UTF-8 ですSet-Content。

# Read raw bytes
Get-Content S3:/amzn-s3-demo-bucket/images/logo.png -AsByteStream -Raw
# Decode as a specific text encoding
Get-Content S3:/amzn-s3-demo-bucket/data/report.csv -Encoding UTF8

Get-Content は、S3 最小 5 MiB から最大 5 GiB までのマルチパートダウンロードパートサイズをバイト単位で設定-PartSizeすることも受け入れます。アップロードパーツのサイズを設定する -PartSizeにミラーリングされます (Set-Content「」を参照非常に大きなオブジェクトをアップロードする)。

$bytes = [byte[]]((Get-Content S3:/amzn-s3-demo-bucket/images/logo.png -AsByteStream -Raw) | ForEach-Object { $_ })

S3 へのオブジェクトの書き込み

Set-Content はオブジェクトをアップロード (および上書き) します。

# Write text
Set-Content S3:/amzn-s3-demo-reports/2026/notes.txt -Value 'Draft complete'
# Write several lines
Set-Content S3:/amzn-s3-demo-bucket/notes/list.txt -Value @('alpha', 'beta', 'gamma')
# Write raw bytes
Set-Content S3:/amzn-s3-demo-bucket/images/logo.png -AsByteStream -Value $bytes

アップロードには次のオプションがあります。

Ctrl+C を使用すると、いつでもアップロードをキャンセルできます。 アップロードが完了するまで何もコミットされないため、キャンセルしても、半分書き込まれたオブジェクトが古いオブジェクトの代わりに残りません。

非常に大きなオブジェクトをアップロードする

ドライブを介したすべてのアップロードはマルチパートアップロードであり、S3 はマルチパートアップロードを 10,000 パートに制限します。デフォルトのパートサイズは 5 MiB で、1 つのオブジェクトは約 48 GiB で上限に達し、上限を超えたアップロードではパートが不足して失敗します。より大きなものをアップロードするには、少なくとも -PartSizeになるように を上げますobject size / 10,000。

# Upload a ~200 GiB object with 64 MiB parts (200 GiB / 10,000 = 21 MiB, so 64 MiB is plenty)

# PowerShell 7+
Get-Content ./huge.bin -AsByteStream -ReadCount 8MB |
    Set-Content S3:/amzn-s3-demo-bucket/archive/huge.bin -AsByteStream -PartSize 64MB

# Windows PowerShell 5.1 (local read uses -Encoding Byte; the S3 write keeps -AsByteStream -PartSize)
Get-Content ./huge.bin -Encoding Byte -ReadCount 8MB |
    Set-Content S3:/amzn-s3-demo-bucket/archive/huge.bin -AsByteStream -PartSize 64MB

-PartSize および -StorageClassは S3 送信先パラメータです。パイプラインにバインドされた送信先オブジェクトではなく、明示的な S3 送信先パス (前の例のように) で使用します。

-PartSize は、S3 最小 5 MiB から最大 5 GiB までの値を受け入れます。最大 5 GiB では、10,000 個のパートが S3 がサポートする最大のオブジェクト (5 TiB) をカバーします。

S3 とローカルディスク間でオブジェクトをコピーする

を使用した S3 内のコピーCopy-Itemはサポートされていません (「」を参照サポートされているオペレーションとサポートされていないオペレーション)。ローカルディスクと S3 の間でデータを移動するには、 Get-Contentと を通じてコンテンツをパイプしますSet-Content。

バイナリデータの場合は、バイトを正確に読み書きします。S3 パスは両方の PowerShell エディション-AsByteStreamで を使用します。「」で説明されているように、ローカル側のみが異なりますローカルファイルのバイトの読み取りはエディションによって異なります。

# Upload a local file (PowerShell 7+; on Windows PowerShell 5.1 the local read uses -Encoding Byte)
Get-Content ./report.csv -AsByteStream -ReadCount 8MB | Set-Content S3:/amzn-s3-demo-bucket/data/report.csv -AsByteStream

# Download to a local file (on Windows PowerShell 5.1 the local write uses -Encoding Byte)
Get-Content S3:/amzn-s3-demo-bucket/data/report.csv -AsByteStream | Set-Content ./report.csv -AsByteStream

ローカルファイルのバイトの読み取りはエディションによって異なります

ローカルファイルをターゲットにすると、PowerShell の組み込み FileSystem プロバイダーが使用され、そのプロバイダーには -AsByteStream Windows PowerShell 5.1 (PowerShell 6 に到着) に がありません。代わりに -Encoding Byte を使用します。これは 5.1 の制限であり、S3 ドライブが制御するものではなく、S3 パスが両方のエディション-AsByteStreamを引き受けます。

サーバー側の S3-to-S3 コピーの場合は、Copy-S3Object コマンドレットを使用します。

オブジェクトとプレフィックスを削除する

Remove-Item は 1 つのオブジェクトを削除します。プレフィックス (コンテンツを含むフォルダ) を削除するには、 が必要です。これにより-Recurse、その下にあるすべてがバッチで削除されます。

# Delete a single object
Remove-Item S3:/amzn-s3-demo-bucket/notes/todo.txt
# Delete a prefix and everything under it
Remove-Item S3:/amzn-s3-demo-bucket/old-logs -Recurse

Remove-Item プロンプトがターゲットに依存するかどうか:

ネイティブ PowerShell スイッチを使用して、削除をプレビューまたはゲートします。

# Preview without deleting
Remove-Item S3:/amzn-s3-demo-bucket/old-logs -Recurse -WhatIf
# Ask for confirmation
Remove-Item S3:/amzn-s3-demo-bucket/notes/todo.txt -Confirm

バケットライフサイクルオペレーションは範囲外であるため、ドライブを介してバケット全体を削除することはできません。代わりに Remove-S3Bucket を使用します。

ドライブを 1 つのバケットまたはプレフィックスにスコープする

を使用してマウント-Rootし、ドライブをバケットまたはバケット内のプレフィックスに制限します。ドライブのルートはその場所になり、ナビゲーションはその下に限定されます。

# Mount rooted at a bucket: the drive root lists the bucket's top-level entries
Mount-S3PSDrive -Name Data -Root amzn-s3-demo-bucket -ProfileName my-profile -Region us-east-1
Get-ChildItem Data:/                 # top-level keys in amzn-s3-demo-bucket
Get-Content Data:/reports/index.txt  # -> amzn-s3-demo-bucket/reports/index.txt

# Mount rooted at a bucket + prefix
Mount-S3PSDrive -Name Reports -Root amzn-s3-demo-reports/2026 -ProfileName my-profile -Region us-east-1
Get-ChildItem Reports:/              # contents of amzn-s3-demo-reports/2026/

ルートは既に存在している必要があります。存在しないバケットまたはプレフィックスはマウントに失敗します。相対パスはルートを超えることができないため (.. エンジンによってブロックされます）、スコープ付きマウントを使用すると、1 つのプロジェクトのデータだけに焦点を当てたビューが得られます。

1 つのドライブからリージョン間でバケットにアクセスする

単一のマウントされたドライブは、リージョン間でバケットに到達できます。バケットに初めてタッチすると、プロバイダーはそのリージョンを検索し、後続の呼び出しを自動的に適切なエンドポイントにルーティングします。リージョンごとに個別のドライブは必要ありません。

# Mounted in us-east-1, but this bucket is in us-west-2 and commands work without extra configuration
Mount-S3PSDrive -Name S3 -ProfileName my-profile -Region us-east-1
Get-ChildItem S3:/amzn-s3-demo-west-bucket
Get-Content   S3:/amzn-s3-demo-west-bucket/data/report.csv -Raw

デフォルトのストレージクラスを設定する

を使用して、マウント時にドライブ全体のデフォルトストレージクラスを設定します-StorageClass。そのドライブを介したすべてのアップロードは、特定の が独自の でSet-Content上書きしない限り、指定されたクラスを使用します-StorageClass。

# Set all uploads to default to STANDARD_IA
Mount-S3PSDrive -Name Archive -ProfileName my-profile -Region us-east-1 -StorageClass STANDARD_IA
Set-Content Archive:/amzn-s3-demo-bucket/cold/data.txt -Value '...'                        # STANDARD_IA
Set-Content Archive:/amzn-s3-demo-bucket/hot/data.txt  -Value '...' -StorageClass STANDARD # overrides to STANDARD

ドライブのアンマウント

Dismount-S3PSDrive ( のラッパーRemove-PSDrive) を使用してドライブを削除します。PowerShell は現在の場所であるドライブを削除しないため、最初に別の場所に変更します。

Set-Location $HOME           # or C:\ on Windows
Dismount-S3PSDrive -Name S3

サポートされているオペレーションとサポートされていないオペレーション

オブジェクトコンテンツを参照および移動するには、 ドライブを使用します。バケットのライフサイクルとサーバー側のコピーオペレーションは、専用の S3 コマンドレットに保持されます。

サポート対象

サポートされません

サポートされていないコマンドは失敗し、コマンドに名前を付け、「Copy-Item is not supported by the S3 drive。Copy-S3Object を使用するか、Get-Content to Set-Content」をパイプします。*-ItemProperty コマンドは、前の表で説明したように例外です。

コマンドリファレンス

Mount-S3PSDrive と Dismount-S3PSDrive の完全なパラメータリストについては、AWS Tools for PowerShell 「 コマンドレットリファレンス」を参照してください。

S3 パスでは、ドライブは動的パラメータを に追加Get-ContentしSet-Content、それらのコマンドレットの PowerShell ドキュメントではカバーされません。

トラブルシューティング

「使用中のため、ドライブをアンマウントできません。」

S3 ドライブは現在の場所です。を などの別のドライブ上の場所に変更し$HOME、もう一度実行Dismount-S3PSDriveします。

「ルートが見つからなかったか、到達できません」でマウントが失敗します。

のバケットまたはプレフィックスが存在し-Rootません。名前 (およびバケットが認証情報がデフォルトではないリージョンにある場合はリージョン) を確認します。認証情報に障害が発生すると、この「到達できない」メッセージではなく、別のエラーが発生します。ルートのアクセス許可エラーは、オブジェクトにアクセスするまで表示されない可能性があるため、成功したマウントでは、ルートのすべてのパスを読み取ることができるとは限りません。

空でないプレフィックスを削除すると、スクリプトでハングします。

これは、 なしで空でないプレフィックスを削除した場合に発生します-Recurse。PowerShell エンジンは、プレフィックスに子 (ファイルシステムプロバイダーの container-has-children 動作) があるため、確認プロンプトを生成します。非インタラクティブホストはプロンプトに応答できないため、コマンドはブロックします。

を渡-Recurseしてプロンプトを表示せずにプレフィックスの内容を削除するか、インタラクティブに確認して続行します (-Force はドライブの削除パスでは参照されないため、ここでは効果がありません）。

「ドライブの外で先ほど変更したオブジェクトには、古いリストがまだ表示されます。」

リストは、ナビゲーションを高速化するために短時間 (約 1 秒) キャッシュされます。ドライブを通じて行われた変更は、すぐに表示されます。別のツールによって行われた変更は、ショートキャッシュの有効期限が切れた後に表示されます。

「キーにはバックスラッシュが含まれています。」

ドライブはプラットフォームのネイティブパス区切り文字を受け入れるため、ドライブがバックスラッシュを含むキーに対応できるかどうかはオペレーティングシステムによって異なります。