Amazon S3를 PowerShell 드라이브로 사용

적용 대상: AWS.Tools.S3 5.0.288 이상. S3 드라이브 공급자와 해당 cmdlet은 Windows PowerShell 5.1 및 PowerShell 7 이상(Windows, Linux, macOS)에서 실행되는 AWS.Tools.S3 모듈에 제공됩니다.

S3 PowerShell 드라이브를 사용하면 Amazon S3 스토리지를 드라이브로 탑재하고 로컬 디스크와 동일한 방식으로 사용할 수 있습니다. 드라이브를 탑재한 후 공급자는 버킷과 접두사를 폴더로, 객체를 파일로 표시합니다. 일반적인 탐색 명령은 , , Get-ChildItem, Get-ContentSet-Content, Set-Location등 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. 를 사용하여 탑재하는 리전은 시작 리전일 뿐입니다. 단일 드라이브가 리전 간 버킷에 도달할 수 있습니다( 참조한 드라이브에서 리전 간 버킷에 액세스).

에서 잘못된 프로필 또는 누락된 버킷 또는 접두사가 실패합니다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, TypeSize, 및 LastModified 속성을 노출하는 객체로 반환합니다. 이러한 속성을 사용하면 리스팅이 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를 사용하여 원시 바이트를 가져옵니다. 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 최소 5MiB와 최대 5GiB 사이에서 -PartSize 설정할 수 있습니다. 업로드 파트 크기를 Set-Content설정하는 -PartSize에 미러링됩니다( 참조매우 큰 객체 업로드).

$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개 파트로 제한합니다. 단일 객체를 약 48MiB이고 캡을 지난 업로드는 파트가 부족하여 실패합니다. 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 최소 5MiB에서 최대 5GiB 사이의 값을 허용합니다. 최대 5GiB에서 10,000개의 파트가 S3가 지원하는 가장 큰 객체(5TiB)를 포함합니다.

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 공급자를 사용하며, 해당 공급자는 Windows PowerShell 5.1(PowerShell 6에 도착함)-AsByteStream에가 없습니다. 대신 -Encoding Byte 사용하세요. 이는 S3 드라이브가 제어하는 것이 아니라 5.1 제한 사항입니다. S3 경로는 두 에디션 -AsByteStream 모두에 적용됩니다.

서버 측 S3-to-S3 복사본의 경우 Copy-S3Object cmdlet을 사용합니다.

객체 및 접두사 삭제

Remove-Item는 단일 객체를 삭제합니다. 접두사(콘텐츠가 있는 폴더)를 삭제하려면가 필요합니다. 그러면 접두사 아래에 -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을 사용합니다.

하나의 버킷 또는 접두사로 드라이브 범위 지정

를와 함께 탑재-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/

루트가 이미 있어야 합니다. 존재하지 않는 버킷 또는 접두사는 탑재에 실패합니다. 상대 경로가 루트 위로 오를 수 없으므로(.. 엔진에 의해 차단됨) 범위가 지정된 마운트를 사용하면 정확히 하나의 프로젝트 데이터를 집중적으로 볼 수 있습니다.

한 드라이브에서 리전 간 버킷에 액세스

탑재된 단일 드라이브는 여러 리전의 버킷에 도달할 수 있습니다. 버킷을 처음 터치하면 공급자는 해당 리전을 조회하고 후속 호출을 올바른 엔드포인트로 자동으로 라우팅합니다. 각 리전마다 별도의 드라이브가 필요하지 않습니다.

# 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 cmdlet과 함께 유지됩니다.

지원됨

지원되지 않음

지원되지 않는 명령은 명령의 이름을 지정하고 대체 명령을 가리키는 메시지와 함께 실패합니다. 예를 들어 "Copy-Item은 S3 드라이브에서 지원되지 않습니다. Copy-S3Object를 사용하거나 Get-Content를 Set-Content로 파이프합니다.” 위 표에 설명된 대로 *-ItemProperty 명령은 예외입니다.

명령 참조

Mount-S3PSDrive 및 Dismount-S3PSDrive의 전체 파라미터 목록은 AWS Tools for PowerShell Cmdlet 참조를 참조하세요.

S3 경로에서 드라이브는 해당 cmdlet에 대한 PowerShell 설명서Get-ContentSet-Content에서 다루지 않는 및에 동적 파라미터도 추가합니다.

문제 해결

“드라이브가 사용 중이므로 마운트를 해제할 수 없습니다.”

S3 드라이브가 현재 위치입니다. 와 같은 다른 드라이브의 위치로 변경$HOME한 다음 Dismount-S3PSDrive 다시 실행합니다.

"루트를 찾을 수 없거나 연결할 수 없습니다"와 함께 탑재가 실패합니다.

의 버킷 또는 접두사가 존재하지 -Root 않습니다. 이름(및 버킷이 자격 증명의 기본값이 아닌 버킷에 있는 경우 리전)을 확인합니다. 자격 증명 실패는이 "연결할 수 없음" 메시지가 아닌 다른 오류를 생성합니다. 객체에 액세스할 때까지 루트에 대한 권한 오류가 나타나지 않을 수 있습니다. 따라서 성공적으로 마운트를 한다고 해서 루트 아래의 모든 경로를 읽을 수 있는 것은 아닙니다.

비어 있지 않은 접두사를 삭제하면 스크립트에서 중단됩니다.

이는를 사용하지 않고 비어 있지 않은 접두사를 삭제할 때 발생합니다-Recurse. 접두사에 하위 항목(파일 시스템 공급자의 container-has-children 동작)이 있기 때문에 PowerShell 엔진은 확인 프롬프트를 표시합니다. 비대화형 호스트는 프롬프트에 응답할 수 없으므로 명령이 차단됩니다.

를 전달-Recurse하여 프롬프트 없이 접두사의 콘텐츠를 삭제하거나 대화식으로 확인하여 계속 진행합니다. (-Force는 드라이브의 삭제 경로에서 참조하지 않으므로 여기서는 아무런 효과가 없습니다.)

“드라이브 외부에서 방금 변경한 객체는 여전히 이전 목록을 표시합니다.”

목록은 탐색 속도를 높이기 위해 잠시(약 1초) 캐시됩니다. 드라이브를 통해 변경한 내용은 즉시 표시됩니다. 다른 도구에서 변경한 내용은 짧은 캐시가 만료된 후에 나타납니다.

“키에는 백슬래시가 포함되어 있습니다.”

드라이브는 플랫폼의 기본 경로 구분자를 허용하므로 드라이브가 백슬래시가 포함된 키를 처리할 수 있는지 여부는 운영 체제에 따라 달라집니다.