Utiliser Amazon S3 comme PowerShell lecteur

S'applique à : AWS.Tools.S3 5.0.288 et versions ultérieures. Le fournisseur de lecteur S3 et ses applets de commande sont fournis dans le AWS.Tools.S3 module, qui s'exécute sous Windows PowerShell 5.1 et versions PowerShell ultérieures (Windows, Linux, macOS).

Le PowerShell lecteur S3 vous permet de monter le stockage Amazon S3 en tant que lecteur et de l'utiliser de la même manière que vous travaillez avec un disque local. Une fois que vous avez monté un lecteur, le fournisseur présente les compartiments et les préfixes sous forme de dossiers et les objets sous forme de fichiers. Les commandes de navigation courantes fonctionnent directement avec S3 Set-LocationGet-ChildItem, notammentGet-Content,Set-Content, etRemove-Item.

Cette rubrique couvre l'installation, le montage, la navigation, le transfert de contenu et le démontage, ainsi que les informations d'identification, la région et le comportement de sécurité du lecteur S3.

Conditions préalables

L'importation du module enregistre un PowerShell fournisseur nomméAWS.S3. Vous pouvez confirmer qu'il est disponible :

Get-PSProvider AWS.S3

Monter un lecteur

Mount-S3PSDriveUtilisez-le pour créer un lecteur. Le -Name paramètre devient le nom du lecteur dans chaque chemin (par exemple, il vous -Name S3 donne des chemins tels queS3:/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:/

Exemple de sortie :

   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

Si vous avez déjà défini les paramètres de session par défaut avec Set-AWSCredential etSet-DefaultAWSRegion, vous pouvez effectuer le montage sans aucun autre paramètre :

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

Mount-S3PSDriveest une fine enveloppe recouvrant le boîtier PowerShell intégréNew-PSDrive. Si vous préférez, vous pouvez créer le lecteur directement et transmettre les mêmes paramètres d'identification et de région :

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

Par défaut, il ne Mount-S3PSDrive produit aucune sortie. Ajoutez -PassThru si vous voulez récupérer l'PSDriveInfoobjet.

Comment les informations d'identification et la région sont résolues

Un lecteur S3 authentifie et sélectionne une région exactement comme le font les applets de commande S3 : d'abord les paramètres explicites, puis les valeurs par défaut de la session définies par Set-AWSCredential etSet-DefaultAWSRegion, puis le profil, l'environnement et les sources de métadonnées d'instance des chaînes par défaut du SDK. Pour la commande en pleine résolution, voir Utilisation des AWS informations d'identification etSpécifiez AWS la région pour Outils AWS pour PowerShell.

Si rien n'alimente une région, le lecteur revient àus-east-1. La région dans laquelle vous effectuez le montage n'est que la région de départ : un seul lecteur peut atteindre plusieurs régions (voirAccédez à des compartiments dans toutes les régions à partir d'un seul lecteur).

Un profil incorrect ou un compartiment ou un préfixe manquant échoue àMount-S3PSDrive. Certaines erreurs d'autorisation peuvent ne pas apparaître tant que vous n'avez pas accédé à un objet.

Naviguez sur Amazon S3 comme sur un lecteur local

Après avoir monté le lecteur, naviguez à l'aide des commandes PowerShell de disque courantes. S3 ne possède pas de véritables dossiers, mais le fournisseur présente les préfixes sous forme de dossiers afin que vous puissiez y naviguer de la même manière.

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

Exemple de sortie :

   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

La saisie par tabulation fonctionne pour les compartiments, les préfixes et les objets. Vous pouvez donc compléter un chemin sans entrer de nom complet.

Get-ChildItemrenvoie chaque élément sous la forme d'un objet qui expose les LastModified propriétés NameType,Size, et. Ces propriétés permettent aux listes d'accéder directement à des commandes telles que Where-Object etSort-Object. Typeest l'un des BucketFolder, ouObject. Les dossiers et les seaux n'ont aucune taille.

# 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

D'autres commandes de navigation fonctionnent également sur le lecteur :

# 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)

Avec-Recurse, la clé d'un élément Name est sa clé par rapport au préfixe (il peut donc contenir/), et le même nom de feuille peut apparaître sous différents préfixes. Lorsque vous devez identifier un élément répertorié sans ambiguïté (par exemple, pour le rediriger vers la suite), utilisez-le plutôt que. 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

Lire des objets depuis S3

Get-Contenttélécharge un objet. Par défaut, il renvoie le texte ligne par ligne. Ajoutez -Raw pour renvoyer l'objet entier sous la forme d'une seule chaîne. À la fois Get-Content et Set-Content support -Encoding pour le texte et -AsByteStream pour le contenu binaire.

# 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

Pour les objets non textuels, utilisez -AsByteStream pour obtenir les octets bruts. Sur un chemin S3, cela fonctionne à la fois sur PowerShell 7+ et Windows PowerShell 5.1 car le fournisseur S3 fournit le paramètre. Seuls les fichiers locaux diffèrent selon l'édition (voirLa lecture des octets des fichiers locaux varie selon l'édition). Pour contrôler le décodage du texte, ajoutez-le -Encoding à l'un des noms de PowerShell codage standard (UTF8UTF8BOMUnicode,ASCII,, etc.). La valeur par défaut est UTF-8 sans nomenclature, à la fois sur Get-Content etSet-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-Contentaccepte également -PartSize de définir la taille des parties du téléchargement en plusieurs parties, en octets, entre le minimum S3 de 5 Mo et le maximum de 5 GiB. Il est -PartSize activéSet-Content, ce qui définit la taille de la partie chargée (voirTéléchargez des objets de très grande taille).

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

Écrire des objets dans S3

Set-Contenttélécharge (et remplace) un objet.

# 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

Les options de téléchargement sont les suivantes :

Vous pouvez annuler un chargement à tout moment avec Ctrl+C. Rien n'est validé tant que le chargement n'est pas terminé. L'annulation ne laisse donc pas un objet à moitié écrit à la place de l'ancien.

Téléchargez des objets de très grande taille

Chaque téléchargement via le lecteur est un téléchargement en plusieurs parties, et S3 limite un téléchargement en plusieurs parties à 10 000 parties. Avec une taille de pièce par défaut de 5 Mo qui limite un seul objet à environ 48 GiB, et un téléchargement dépassant le plafond est épuisé et échoue. Pour télécharger quelque chose de plus gros, augmentez de -PartSize manière à ce qu'il soit au moins 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

-PartSizeet -StorageClass sont des paramètres de destination S3. Utilisez-les avec un chemin de destination S3 explicite (comme dans l'exemple précédent), et non avec un objet de destination lié à un pipeline.

-PartSizeaccepte une valeur comprise entre le minimum S3 de 5 MiB et le maximum de 5 GiB. À un maximum de 5 GiB, 10 000 pièces couvrent le plus gros objet pris en charge par S3 (5 TiB).

Copier des objets entre S3 et le disque local

La copie dans S3 avec n'Copy-Itemest pas prise en charge (voirOpérations prises en charge et non prises en charge). Pour déplacer des données entre votre disque local et S3, redirigez le contenu via Get-Content etSet-Content.

Pour les données binaires, lisez et écrivez les octets exactement. Un chemin S3 est utilisé dans -AsByteStream les deux PowerShell éditions ; seul le côté local diffère, comme décrit dansLa lecture des octets des fichiers locaux varie selon l'édition.

# 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

La lecture des octets des fichiers locaux varie selon l'édition

Le ciblage d'un fichier local utilise FileSystem le PowerShell fournisseur intégré, mais ce fournisseur n'-AsByteStreamen a pas dans Windows PowerShell 5.1 (il est arrivé en PowerShell 6). Utilisez-le à la -Encoding Byte place. Il s'agit d'une limitation 5.1, qui n'est pas contrôlée par le lecteur S3 ; un chemin S3 prend -AsByteStream en charge les deux éditions.

Pour les S3-to-S3 copies côté serveur, utilisez l'applet de commande. Copy-S3Object

Supprimer des objets et des préfixes

Remove-Itemsupprime un seul objet. La suppression d'un préfixe (un dossier contenant du contenu) nécessite-Recurse, ce qui supprime tout ce qui se trouve en dessous par lots.

# 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

La question de savoir si Remove-Item les instructions dépendent de ce que vous ciblez :

Utilisez les PowerShell commutateurs natifs pour prévisualiser ou bloquer une suppression :

# 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

Vous ne pouvez pas supprimer un compartiment entier via le lecteur car les opérations liées au cycle de vie du bucket sont hors de portée. Utilisez Remove-S3Bucket à la place.

Limiter un lecteur à un compartiment ou à un préfixe

Montez avec -Root pour confiner un lecteur à un compartiment, ou utilisez un préfixe dans un compartiment. La racine du lecteur se trouve alors à cet endroit, et la navigation est confinée en dessous.

# 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/

La racine doit déjà exister. Un bucket ou un préfixe inexistant échoue au montage. Comme les trajectoires relatives ne peuvent pas dépasser la racine (elles .. sont bloquées par le moteur), un montage scopé vous donne une vue ciblée des données d'un seul projet.

Accédez à des compartiments dans toutes les régions à partir d'un seul lecteur

Un seul lecteur monté peut atteindre des godets dans toutes les régions. La première fois que vous touchez un compartiment, le fournisseur recherche sa région et achemine automatiquement les appels suivants vers le bon terminal. Vous n'avez pas besoin d'un lecteur distinct pour chaque région.

# 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

Définir une classe de stockage par défaut

Définissez une classe de stockage par défaut pour l'ensemble du disque au moment du montage avec. -StorageClass Chaque téléchargement via ce lecteur utilise la classe spécifiée à moins qu'une classe spécifique ne la Set-Content remplace par la sienne. -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

Démonter un lecteur

Utilisez Dismount-S3PSDrive (un emballageRemove-PSDrive) pour retirer un lecteur. Passez d'abord à un autre emplacement, car cela PowerShell ne supprimera pas un lecteur correspondant à votre position actuelle.

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

Opérations prises en charge et non prises en charge

Utilisez le lecteur pour parcourir et déplacer le contenu des objets. Le cycle de vie des compartiments et les opérations de copie côté serveur restent assurés par les applets de commande S3 dédiées.

Pris en charge

Non pris en charge

Les commandes non prises en charge échouent avec un message qui nomme la commande et pointe vers l'alternative, par exemple, « n'Copy-Item est pas prise en charge par le lecteur S3. À utiliser Copy-S3Object ou Get-Content à piquer Set-Content. » Les *-ItemProperty commandes constituent l'exception, comme décrit dans le tableau précédent.

Référence des commandes

Pour obtenir la liste complète des paramètres pour Mount-S3PSDrive et Dismount-S3PSDrive, consultez la référence des Outils AWS pour PowerShell applets de commande.

Sur un chemin S3, le lecteur ajoute également des paramètres dynamiques Set-Content auxquels Get-Content la PowerShell documentation de ces applets de commande ne couvre pas :

Résolution des problèmes

« Impossible de démonter le disque car il est en cours d'utilisation. »

Le lecteur S3 est l'emplacement actuel. Accédez à un emplacement sur un autre lecteur, par exemple$HOME, puis exécutez Dismount-S3PSDrive à nouveau.

Le montage échoue avec le message « root n'a pas été trouvé ou n'est pas accessible ».

Le compartiment ou le préfixe dans -Root n'existe pas. Vérifiez le nom (et la région, si le compartiment se trouve dans un compartiment que vos informations d'identification n'utilisent pas par défaut). Un échec d'identification produit une erreur différente, et non ce message « inaccessible ». Une erreur d'autorisation à la racine peut ne pas apparaître tant que vous n'avez pas accédé à un objet. Par conséquent, un montage réussi ne garantit pas que vous puissiez lire tous les chemins qui se trouvent sous cet objet.

La suppression d'un préfixe non vide se bloque dans un script.

Cela se produit lorsque vous supprimez un préfixe non vide sans. -Recurse Le PowerShell moteur lance une invite de confirmation car le préfixe comporte des enfants (comportement du fournisseur de système de fichiers contenant des enfants). Un hôte non interactif ne peut pas répondre à l'invite, la commande est donc bloquée.

Passez -Recurse pour supprimer le contenu du préfixe sans y être invité, ou confirmez de manière interactive pour continuer. (n'-Forceest pas consulté par le chemin de suppression du lecteur, il n'a donc aucun effet ici.)

« Un objet que je viens de changer en dehors du lecteur affiche toujours l'ancienne annonce. »

Les listes sont mises en cache brièvement (environ une seconde) pour accélérer la navigation. Les modifications effectuées via le lecteur apparaissent immédiatement. Les modifications apportées par un autre outil apparaissent après l'expiration du court cache.

« Une touche contient une barre oblique inverse. »

La capacité du lecteur à adresser une clé contenant une barre oblique inverse dépend du système d'exploitation, car le lecteur accepte le séparateur de chemin natif de la plate-forme :