Exemples Amazon S3 utilisant Tools for PowerShell V5

Exemple 1 : cette commande copie l’objet « sample.txt » depuis le compartiment « test-files » vers le même compartiment, mais avec une nouvelle clé « sample-copy.txt ».

Copy-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -DestinationKey sample-copy.txt

Exemple 2 : cette commande copie l’objet « sample.txt » depuis le compartiment « test-files » vers le compartiment « backup-files » avec une clé « sample-copy.txt ».

Copy-S3Object -BucketName amzn-s3-demo-source-bucket -Key sample.txt -DestinationKey sample-copy.txt -DestinationBucket amzn-s3-demo-destination-bucket

Exemple 3 : cette commande télécharge l’objet « sample.txt » depuis le compartiment « test-files » vers un fichier local nommé « local-sample.txt ».

Copy-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -LocalFile local-sample.txt

Exemple 4 : télécharge l’objet unique dans le fichier spécifié. Le fichier téléchargé se trouve dans c:\downloads\data\archive.zip

Copy-S3Object -BucketName amzn-s3-demo-bucket -Key data/archive.zip -LocalFolder c:\downloads

Exemple 5 : télécharge tous les objets qui correspondent au préfixe de clé spécifié dans le dossier local. La hiérarchie des clés relative sera préservée sous forme de sous-dossiers dans l’emplacement de téléchargement global.

Copy-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix data -LocalFolder c:\downloads

Exemple 6 : télécharge un seul objet dans un fichier local à l'aide du téléchargement parallèle en plusieurs parties pour améliorer les performances sur les fichiers volumineux.

Copy-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -LocalFile local-sample.txt -UseMultipartDownload

Exemple 7 : télécharge un objet volumineux à l'aide du mode RANGE avec une taille de partie personnalisée de 64 Mo. Le mode RANGE utilise des requêtes HTTP par plage d'octets et fonctionne pour tous les objets, quelle que soit la manière dont ils ont été chargés.

Copy-S3Object -BucketName amzn-s3-demo-bucket -Key large-file.zip -LocalFile local-large-file.zip -UseMultipartDownload -MultipartDownloadType RANGE -PartSize 64MB

Exemple 8 : télécharge tous les objets correspondant au préfixe clé dans un dossier local en utilisant le téléchargement en plusieurs parties avec téléchargements de fichiers simultanés.

Copy-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix data/ -LocalFolder C:\local-data -UseMultipartDownload -DownloadFilesConcurrently

Exemple 9 : télécharge un seul objet à l'aide d'un téléchargement partitionné avec 20 connexions simultanées pour un débit maximal sur les réseaux à bande passante élevée.

Copy-S3Object -BucketName amzn-s3-demo-bucket -Key large-file.zip -LocalFile local-large-file.zip -UseMultipartDownload -ConcurrentServiceRequest 20

Exemple 10 : télécharge tous les objets correspondant au préfixe de clé dans un dossier local à l'aide du téléchargement partitionné, en continuant les échecs individuels des fichiers au lieu d'abandonner.

Copy-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix data/ -LocalFolder C:\local-data -UseMultipartDownload -FailurePolicy ContinueOnFailure

Exemple 1 : cette commande renvoie tous les compartiments S3.

Get-S3Bucket

Exemple 2 : cette commande renvoie un compartiment nommé « test-files »

Get-S3Bucket -BucketName amzn-s3-demo-bucket

Exemple 1 : la commande obtient les détails du propriétaire de l’objet S3.

(Get-S3BucketACL -BucketName 'amzn-s3-demo-bucket' -Select *).Owner

Sortie :

DisplayName Id
----------- --
testusername      9988776a6554433d22f1100112e334acb45566778899009e9887bd7f66c5f544

Exemple 1 : cette commande renvoie la valeur Enabled, si les paramètres d’accélération du transfert sont activés pour le compartiment spécifié.

Get-S3BucketAccelerateConfiguration -BucketName 'amzn-s3-demo-bucket'

Sortie :

Value                                  
-----                                    
Enabled

Exemple 1 : cette commande renvoie les détails du filtre d’analyse nommé « testfilter » dans le compartiment S3 donné.

Get-S3BucketAnalyticsConfiguration -BucketName 'amzn-s3-demo-bucket' -AnalyticsId 'testfilter'

Exemple 1 : cette commande renvoie les cent premières configurations d’analyse du compartiment S3 donné.

Get-S3BucketAnalyticsConfigurationList -BucketName 'amzn-s3-demo-bucket'

Exemple 1 : cette commande renvoie toutes les règles de chiffrement côté serveur associées au compartiment donné.

Get-S3BucketEncryption -BucketName 'amzn-s3-demo-bucket'

Exemple 1 : cette commande renvoie les détails de l’inventaire nommé « testinventory » pour le compartiment S3 donné.

Get-S3BucketInventoryConfiguration -BucketName 'amzn-s3-demo-bucket' -InventoryId 'testinventory'

Exemple 1 : cette commande renvoie les cent premières configurations d’inventaire du compartiment S3 donné.

Get-S3BucketInventoryConfigurationList -BucketName 'amzn-s3-demo-bucket'

Exemple 1 : cette commande renvoie la contrainte d’emplacement pour le compartiment « amzn-s3-demo-bucket », s’il en existe une.

Get-S3BucketLocation -BucketName 'amzn-s3-demo-bucket'

Sortie :

Value
-----
ap-south-1

Exemple 1 : cette commande renvoie le statut de journalisation pour le compartiment spécifié.

Get-S3BucketLogging -BucketName 'amzn-s3-demo-bucket'

Sortie :

TargetBucketName   Grants TargetPrefix
----------------   ------ ------------
testbucket1        {}     testprefix

Exemple 1 : cette commande renvoie les détails du filtre de métriques nommé « testfilter » pour le compartiment S3 donné.

Get-S3BucketMetricsConfiguration -BucketName 'amzn-s3-demo-bucket' -MetricsId 'testfilter'

Exemple 1 : cet exemple extrait la configuration des notifications pour le compartiment donné

Get-S3BucketNotification -BucketName amzn-s3-demo-bucket | select -ExpandProperty TopicConfigurations

Sortie :

Id   Topic
--   -----
mimo arn:aws:sns:eu-west-1:123456789012:topic-1

Exemple 1 : cette commande génère la stratégie de compartiment associée au compartiment S3 donné.

Get-S3BucketPolicy -BucketName 'amzn-s3-demo-bucket'

Exemple 1 : cette commande renvoie le statut de la stratégie pour le compartiment S3 donné, indiquant si ce compartiment est public.

Get-S3BucketPolicyStatus -BucketName 'amzn-s3-demo-bucket'

Exemple 1 : renvoie les informations de configuration de réplication définies sur le compartiment nommé « amzn-s3-demo-bucket ».

Get-S3BucketReplication -BucketName amzn-s3-demo-bucket

Exemple 1 : renvoie la configuration de paiement des demandes pour le compartiment nommé « amzn-s3-demo-bucket ». Par défaut, le propriétaire du compartiment paie les téléchargements effectués depuis le compartiment.

Get-S3BucketRequestPayment -BucketName amzn-s3-demo-bucket

Exemple 1 : cette commande renvoie toutes les balises associées au compartiment donné.

Get-S3BucketTagging -BucketName 'amzn-s3-demo-bucket'

Exemple 1 : cette commande renvoie le statut de la gestion des versions par rapport au compartiment donné.

Get-S3BucketVersioning -BucketName 'amzn-s3-demo-bucket'

Exemple 1 : cette commande renvoie les détails des configurations de site Web statiques du compartiment S3 donné.

Get-S3BucketWebsite -BucketName 'amzn-s3-demo-bucket'

Exemple 1 : cette commande renvoie un objet contenant toutes les règles de configuration CORS correspondant au compartiment S3 donné.

Get-S3CORSConfiguration -BucketName 'amzn-s3-demo-bucket' -Select Configuration.Rules

Sortie :

AllowedMethods : {PUT, POST, DELETE}
AllowedOrigins : {http://www.example1.com}
Id             : 
ExposeHeaders  : {}
MaxAgeSeconds  : 0
AllowedHeaders : {*}

AllowedMethods : {PUT, POST, DELETE}
AllowedOrigins : {http://www.example2.com}
Id             : 
ExposeHeaders  : {}
MaxAgeSeconds  : 0
AllowedHeaders : {*}

AllowedMethods : {GET}
AllowedOrigins : {*}
Id             : 
ExposeHeaders  : {}
MaxAgeSeconds  : 0
AllowedHeaders : {}

Exemple 1 : Cette commande renvoie la sortie avec le code d'état HTTP 200 OK pour le compartiment existant lorsque l'utilisateur est autorisé à y accéder. BucketArn Le paramètre n'est pris en charge que pour les compartiments de répertoires S3.

Get-S3HeadBucket -BucketName amzn-s3-demo-bucket

Sortie :

AccessPointAlias   : False
BucketArn          :
BucketLocationName : 
BucketLocationType : 
BucketRegion       : us-east-2
ResponseMetadata   : Amazon.Runtime.ResponseMetadata
ContentLength      : 0
HttpStatusCode     : OK

Exemple 2 : cette commande génère une erreur avec le code d'état HTTP NotFound pour un compartiment inexistant.

Get-S3HeadBucket -BucketName amzn-s3-non-existing-bucket

Sortie :

Get-S3HeadBucket: Error making request with Error Code NotFound and Http Status Code NotFound. No further error information was returned by the service.

Exemple 3 : cette commande génère une erreur avec le code de statut HTTP Interdit pour le compartiment existant auquel l’utilisateur n’est pas autorisé à accéder.

Get-S3HeadBucket -BucketName amzn-s3-no-access-bucket

Sortie :

Get-S3HeadBucket: Error making request with Error Code Forbidden and Http Status Code Forbidden. No further error information was returned by the service.

Exemple 1 : cet exemple extrait la configuration du cycle de vie du compartiment.

Get-S3LifecycleConfiguration -BucketName amzn-s3-demo-bucket

Sortie :

Rules
-----
{Remove-in-150-days, Archive-to-Glacier-in-30-days}

Exemple 1 : Cette commande récupère les informations relatives à tous les éléments du compartiment « test-files ».

Get-S3Object -BucketName amzn-s3-demo-bucket

Exemple 2 : Cette commande récupère les informations relatives à l’élément « sample.txt » depuis le compartiment « test-files ».

Get-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt

Exemple 3 : Cette commande récupère les informations relatives à tous les éléments portant le préfixe « sample » à partir du compartiment « test-files ».

Get-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix sample

Exemple 1 : la commande obtient les détails du propriétaire de l’objet S3.

(Get-S3ObjectACL -BucketName 'amzn-s3-demo-bucket' -key 'initialize.ps1' -Select *).Owner

Sortie :

DisplayName Id
----------- --
testusername      9988776a6554433d22f1100112e334acb45566778899009e9887bd7f66c5f544

Exemple 1 : cette commande renvoie la valeur « Enabled » si la configuration du verrouillage d’objet est activée pour le compartiment S3 donné.

Get-S3ObjectLockConfiguration -BucketName 'amzn-s3-demo-bucket' -Select ObjectLockConfiguration.ObjectLockEnabled

Sortie :

Value
-----
Enabled

Exemple 1 : Cette commande renvoie les métadonnées de l'objet avec la clé « ListTrusts.txt » dans le compartiment S3 donné.

Get-S3ObjectMetadata -BucketName 'amzn-s3-demo-bucket' -Key 'ListTrusts.txt'

Sortie :

Headers                                       : Amazon.S3.Model.HeadersCollection
Metadata                                      : Amazon.S3.Model.MetadataCollection
DeleteMarker                                  : 
AcceptRanges                                  : bytes
ContentRange                                  : 
Expiration                                    : 
RestoreExpiration                             : 
RestoreInProgress                             : False
LastModified                                  : 01/01/2020 08:02:05
ETag                                          : "d000011112a222e333e3bb4ee5d43d21"
MissingMeta                                   : 0
VersionId                                     : null
Expires                                       : 01/01/0001 00:00:00
WebsiteRedirectLocation                       : 
ServerSideEncryptionMethod                    : AES256
ServerSideEncryptionCustomerMethod            : 
ServerSideEncryptionKeyManagementServiceKeyId : 
ReplicationStatus                             : 
PartsCount                                    : 
ObjectLockLegalHoldStatus                     : 
ObjectLockMode                                : 
ObjectLockRetainUntilDate                     : 01/01/0001 00:00:00
StorageClass                                  : 
RequestCharged                                :

Exemple 1 : la commande renvoie le mode et la date de conservation de l’objet.

Get-S3ObjectRetention -BucketName 'amzn-s3-demo-bucket' -Key 'testfile.txt'

Exemple 1 : l’exemple renvoie les balises associées à l’objet présent dans le compartiment S3 donné.

Get-S3ObjectTagSet -Key 'testfile.txt' -BucketName 'amzn-s3-demo-bucket'

Sortie :

Key  Value
---  -----
test value

Exemple 1 : la commande renvoie une URL pré-signée pour une clé spécifiée et une date d’expiration.

Get-S3PreSignedURL -BucketName 'amzn-s3-demo-bucket' -Key 'testkey' -Expires '2023-11-16'

Exemple 2 : la commande renvoie une URL pré-signée pour un compartiment de répertoire avec une clé spécifiée et une date d’expiration.

[Amazon.AWSConfigsS3]::UseSignatureVersion4 = $true
      Get-S3PreSignedURL -BucketName amzn-s3-demo-bucket--usw2-az1--x-s3 -Key 'testkey' -Expire '2023-11-17'

Exemple 1 : la commande renvoie la configuration du bloc d’accès public du compartiment S3 donné.

Get-S3PublicAccessBlock -BucketName 'amzn-s3-demo-bucket'

Exemple 1 : cette commande renvoie les métadonnées relatives à toutes les versions des objets du compartiment S3 donné.

Get-S3Version -BucketName 'amzn-s3-demo-bucket'

Sortie :

IsTruncated         : False
KeyMarker           : 
VersionIdMarker     : 
NextKeyMarker       : 
NextVersionIdMarker : 
Versions            : {EC2.txt, EC2MicrosoftWindowsGuide.txt, ListDirectories.json, ListTrusts.json}
Name                : amzn-s3-demo-bucket
Prefix              : 
MaxKeys             : 1000
CommonPrefixes      : {}
Delimiter           :

Exemple 1 : cette commande crée un nouveau compartiment privé nommé « sample-bucket ».

New-S3Bucket -BucketName amzn-s3-demo-bucket

Exemple 2 : cette commande crée un nouveau compartiment nommé « sample-bucket » avec des autorisations de lecture-écriture.

New-S3Bucket -BucketName amzn-s3-demo-bucket -PublicReadWrite

Exemple 3 : cette commande crée un nouveau compartiment nommé « sample-bucket » avec des autorisations de lecture seule.

New-S3Bucket -BucketName amzn-s3-demo-bucket -PublicReadOnly

Exemple 4 : Cette commande crée un nouveau compartiment de répertoire nommé « amzn-s3-demo-bucket--use1-az5--x-s3 » avec. PutBucketConfiguration

$bucketConfiguration = @{
      BucketInfo = @{
          DataRedundancy = 'SingleAvailabilityZone'
          Type = 'Directory'
      }
      Location = @{
          Name = 'usw2-az1'
          Type = 'AvailabilityZone'
      }
    }
New-S3Bucket -BucketName amzn-s3-demo-bucket--usw2-az1--x-s3 -BucketConfiguration $bucketConfiguration -Region us-west-2

Exemple 1 : Cette commande extrait l'élément « sample.txt » du compartiment « amzn-s3-demo-bucket » et l'enregistre dans un fichier nommé « local-sample.txt » à l'emplacement actuel. Il n’est pas nécessaire que le fichier « local-sample.txt » existe pour que cette commande soit appelée.

Read-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -File local-sample.txt

Exemple 2 : Cette commande extrait le répertoire virtuel « DIR » du compartiment « amzn-s3-demo-bucket » et l'enregistre dans un dossier nommé « » à l'emplacement actuel. Local-DIR Le dossier « Local-DIR » ne doit pas nécessairement exister pour que cette commande soit appelée.

Read-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix DIR -Folder Local-DIR

Exemple 3 : télécharge tous les objets dont les clés se terminent par « .json » à partir des compartiments dont le nom contient « config » vers les fichiers du dossier spécifié. Les clés d’objet sont utilisées pour définir les noms de fichiers.

Get-S3Bucket | ? { $_.BucketName -like '*config*' } | Get-S3Object | ? { $_.Key -like '*.json' } | Read-S3Object -Folder C:\ConfigObjects

Exemple 4 : télécharge un seul objet à l'aide d'un téléchargement parallèle en plusieurs parties pour améliorer les performances sur les fichiers volumineux.

Read-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -File local-sample.txt -UseMultipartDownload

Exemple 5 : télécharge un objet volumineux à l'aide du mode RANGE avec une taille de partie personnalisée de 64 Mo. Le mode RANGE utilise des requêtes HTTP par plage d'octets et fonctionne pour tous les objets, quelle que soit la manière dont ils ont été chargés.

Read-S3Object -BucketName amzn-s3-demo-bucket -Key large-file.zip -File local-large-file.zip -UseMultipartDownload -MultipartDownloadType RANGE -PartSize 64MB

Exemple 6 : télécharge tous les objets dotés du préfixe clé « data/ » dans un dossier local en utilisant le téléchargement partitionné avec téléchargements de fichiers simultanés.

Read-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix data/ -Folder C:\local-data -UseMultipartDownload -DownloadFilesConcurrently

Exemple 7 : télécharge un seul objet à l'aide d'un téléchargement partitionné avec 20 connexions simultanées pour un débit maximal sur les réseaux à bande passante élevée.

Read-S3Object -BucketName amzn-s3-demo-bucket -Key large-file.zip -File local-large-file.zip -UseMultipartDownload -ConcurrentServiceRequest 20

Exemple 8 : télécharge tous les objets dont le préfixe clé « data/ » est téléchargé dans un dossier local à l'aide du téléchargement partitionné, en poursuivant les échecs individuels des fichiers au lieu d'abandonner.

Read-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix data/ -Folder C:\local-data -UseMultipartDownload -FailurePolicy ContinueOnFailure

Exemple 1 : cette commande supprime tous les objets et toutes les versions d’objets du compartiment « test-files », puis supprime le compartiment. La commande vous invite à confirmer avant de poursuivre. Ajoutez le commutateur -Force pour supprimer la confirmation. Notez que les compartiments qui ne sont pas vides ne peuvent pas être supprimés.

Remove-S3Bucket -BucketName amzn-s3-demo-bucket -DeleteBucketContent

Exemple 1 : ma commande supprime le filtre d’analyse nommé « testfilter » dans le compartiment S3 donné.

Remove-S3BucketAnalyticsConfiguration -BucketName 'amzn-s3-demo-bucket' -AnalyticsId 'testfilter'

Exemple 1 : cela désactive le chiffrement activé pour le compartiment S3 fourni.

Remove-S3BucketEncryption -BucketName 'amzn-s3-demo-bucket'

Sortie :

Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-S3BucketEncryption (DeleteBucketEncryption)" on target "s3casetestbucket".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y

Exemple 1 : Cette commande supprime l'inventaire nommé « test InventoryName » correspondant au compartiment S3 donné.

Remove-S3BucketInventoryConfiguration -BucketName 'amzn-s3-demo-bucket' -InventoryId 'testInventoryName'

Sortie :

Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-S3BucketInventoryConfiguration (DeleteBucketInventoryConfiguration)" on target "amzn-s3-demo-bucket".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y

Exemple 1 : la commande supprime le filtre de métriques nommé « testmetrics » dans le compartiment S3 donné.

Remove-S3BucketMetricsConfiguration -BucketName 'amzn-s3-demo-bucket' -MetricsId 'testmetrics'

Exemple 1 : la commande supprime la stratégie de compartiment associée au compartiment S3 donné.

Remove-S3BucketPolicy -BucketName 'amzn-s3-demo-bucket'

Exemple 1 : supprime la configuration de réplication associée au compartiment nommé « amzn-s3-demo-bucket ». Notez que cette opération nécessite une autorisation pour l'DeleteReplicationConfiguration action s3 :. Vous devrez confirmer avant que l’opération ne se poursuive. Pour supprimer la confirmation, utilisez le commutateur -Force.

Remove-S3BucketReplication -BucketName amzn-s3-demo-bucket

Exemple 1 : cette commande supprime toutes les balises associées au compartiment S3 donné.

Remove-S3BucketTagging -BucketName 'amzn-s3-demo-bucket'

Sortie :

Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-S3BucketTagging (DeleteBucketTagging)" on target "amzn-s3-demo-bucket".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y

Exemple 1 : cette commande désactive la propriété d’hébergement statique du site Web du compartiment S3 donné.

Remove-S3BucketWebsite -BucketName 'amzn-s3-demo-bucket'

Sortie :

Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-S3BucketWebsite (DeleteBucketWebsite)" on target "amzn-s3-demo-bucket".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y

Exemple 1 : cette commande supprime la configuration CORS pour le compartiment S3 donné.

Remove-S3CORSConfiguration -BucketName 'amzn-s3-demo-bucket'

Sortie :

Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-S3CORSConfiguration (DeleteCORSConfiguration)" on target "amzn-s3-demo-bucket".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y

Exemple 1 : la commande supprime toutes les règles de cycle de vie pour le compartiment S3 donné.

Remove-S3LifecycleConfiguration -BucketName 'amzn-s3-demo-bucket'

Exemple 1 : cette commande annule les chargements partitionnés créés il y a moins de cinq jours.

Remove-S3MultipartUpload -BucketName amzn-s3-demo-bucket -DaysBefore 5

Exemple 2 : cette commande annule les chargements partitionnés créés avant le 2 janvier 2014.

Remove-S3MultipartUpload -BucketName amzn-s3-demo-bucket -InitiatedDate "Thursday, January 02, 2014"

Exemple 3 : cette commande annule les chargements partitionnés créés avant le 2 janvier 2014, à 10 h 45 m 37 s.

Remove-S3MultipartUpload -BucketName amzn-s3-demo-bucket -InitiatedDate "2014/01/02 10:45:37"

Exemple 1 : cette commande supprime l’objet « sample.txt » du compartiment « test-files ». Vous devrez confirmer avant l’exécution de la commande ; pour supprimer l’invite, utilisez le commutateur -Force.

Remove-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt

Exemple 2 : cette commande supprime la version de l’objet « sample.txt » depuis le compartiment « test-files », en supposant que le compartiment a été configuré pour activer les versions d’objet.

Remove-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -VersionId HLbxnx6V9omT6AQYVpks8mmFKQcejpqt

Exemple 3 : cette commande supprime les objets « sample1.txt », « sample2.txt » et « sample3.txt » du compartiment « test-files » en une seule opération par lots. La réponse du service répertoriera toutes les clés traitées, quel que soit le statut de réussite ou d’erreur de la suppression. Pour obtenir uniquement les erreurs pour les clés qui n'ont pas pu être traitées par le service, ajoutez le ReportErrorsOnly paramètre - (ce paramètre peut également être spécifié avec l'alias -Quiet).

Remove-S3Object -BucketName amzn-s3-demo-bucket -KeyCollection @( "sample1.txt", "sample2.txt", "sample3.txt" )

Exemple 4 : Cet exemple utilise une expression en ligne avec le KeyCollection paramètre - pour obtenir les clés des objets à supprimer. Get-S3Object renvoie une collection d' Amazon.S3.Model.S3Object instances, dont chacune possède un membre Key de type chaîne identifiant l'objet.

Remove-S3Object -bucketname "amzn-s3-demo-bucket" -KeyCollection (Get-S3Object "test-files" -KeyPrefix "prefix/subprefix" | select -ExpandProperty Key)

Exemple 5 : Cet exemple obtient tous les objets qui ont un préfixe clé « prefix/subprefix » dans le compartiment et les supprime. Notez que les objets entrants sont traités un par un. Pour les grandes collections, pensez à transmettre la collection au paramètre - InputObject (alias -S3ObjectCollection) de l'applet de commande pour permettre la suppression en tant que lot avec un seul appel au service.

Get-S3Object -BucketName "amzn-s3-demo-bucket" -KeyPrefix "prefix/subprefix" | Remove-S3Object -Force

Exemple 6 : Cet exemple dirige une collection d' Amazon.S3.Model.S3ObjectVersion instances qui représentent des marqueurs de suppression vers l'applet de commande pour suppression. Notez que les objets entrants sont traités un par un. Pour les grandes collections, pensez à transmettre la collection au paramètre - InputObject (alias -S3ObjectCollection) de l'applet de commande pour permettre la suppression en tant que lot avec un seul appel au service.

(Get-S3Version -BucketName "amzn-s3-demo-bucket").Versions | Where {$_.IsDeleteMarker -eq "True"} | Remove-S3Object -Force

Exemple 7 : Ce script montre comment effectuer une suppression par lots d'un ensemble d'objets (dans ce cas, supprimer des marqueurs) en construisant un tableau d'objets à utiliser avec le KeyAndVersionCollection paramètre -.

$keyVersions = @()
$markers = (Get-S3Version -BucketName $BucketName).Versions | Where {$_.IsDeleteMarker -eq "True"}
foreach ($marker in $markers) { $keyVersions += @{ Key = $marker.Key; VersionId = $marker.VersionId } }
Remove-S3Object -BucketName $BucketName -KeyAndVersionCollection $keyVersions -Force

Exemple 1 : cette commande supprime toutes les balises associées à l’objet avec la clé « testfile.txt » dans le compartiment S3 donné.

Remove-S3ObjectTagSet -Key 'testfile.txt' -BucketName 'amzn-s3-demo-bucket' -Select '^Key'

Sortie :

Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-S3ObjectTagSet (DeleteObjectTagging)" on target "testfile.txt".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y
testfile.txt

Exemple 1 : cette commande désactive le paramètre de blocage de l’accès public pour le compartiment donné.

Remove-S3PublicAccessBlock -BucketName 'amzn-s3-demo-bucket' -Force -Select '^BucketName'

Sortie :

amzn-s3-demo-bucket

Exemple 1 : Cette commande active le chiffrement côté serveur AES256 par défaut avec Amazon S3 Managed Keys (SSE-S3) sur le compartiment donné.

$Encryptionconfig = @{ServerSideEncryptionByDefault = @{ServerSideEncryptionAlgorithm = "AES256"}}
Set-S3BucketEncryption -BucketName 'amzn-s3-demo-bucket' -ServerSideEncryptionConfiguration_ServerSideEncryptionRule $Encryptionconfig

Exemple 1 : cette commande renvoie True si le compartiment existe, ou False dans le cas contraire. La commande renvoie True même si le compartiment n’appartient pas à l’utilisateur.

Test-S3Bucket -BucketName amzn-s3-demo-bucket

Exemple 1 : cette commande active l’accélération du transfert pour le compartiment S3 donné.

$statusVal = New-Object Amazon.S3.BucketAccelerateStatus('Enabled')
Write-S3BucketAccelerateConfiguration -BucketName 'amzn-s3-demo-bucket' -AccelerateConfiguration_Status $statusVal

Exemple 1 : Cet exemple configure la configuration de la rubrique SNS pour l'événement S3 ObjectRemovedDelete et active la notification pour le compartiment S3 donné

$topic =  [Amazon.S3.Model.TopicConfiguration] @{
  Id = "delete-event"
  Topic = "arn:aws:sns:eu-west-1:123456789012:topic-1"
  Event = [Amazon.S3.EventType]::ObjectRemovedDelete
}

Write-S3BucketNotification -BucketName amzn-s3-demo-bucket -TopicConfiguration $topic

Exemple 2 : Cet exemple active les notifications ObjectCreatedAll pour le bucket donné en l'envoyant à la fonction Lambda.

$lambdaConfig = [Amazon.S3.Model.LambdaFunctionConfiguration] @{
  Events = "s3:ObjectCreated:*"
  FunctionArn = "arn:aws:lambda:eu-west-1:123456789012:function:rdplock"
  Id = "ObjectCreated-Lambda"
  Filter = @{
    S3KeyFilter = @{
      FilterRules = @(
        @{Name="Prefix";Value="dada"}
        @{Name="Suffix";Value=".pem"}
      )
    }
  }
}

Write-S3BucketNotification -BucketName amzn-s3-demo-bucket -LambdaFunctionConfiguration $lambdaConfig

Exemple 3 : cet exemple crée deux configurations Lambda différentes sur la base d’un suffixe clé différent et configure les deux en une seule commande.

#Lambda Config 1

$firstLambdaConfig = [Amazon.S3.Model.LambdaFunctionConfiguration] @{
  Events = "s3:ObjectCreated:*"
  FunctionArn = "arn:aws:lambda:eu-west-1:123456789012:function:verifynet"
  Id = "ObjectCreated-dada-ps1"
  Filter = @{
    S3KeyFilter = @{
      FilterRules = @(
        @{Name="Prefix";Value="dada"}
        @{Name="Suffix";Value=".ps1"}
      )
    }
  }
}

#Lambda Config 2

$secondlambdaConfig = [Amazon.S3.Model.LambdaFunctionConfiguration] @{
  Events = [Amazon.S3.EventType]::ObjectCreatedAll
  FunctionArn = "arn:aws:lambda:eu-west-1:123456789012:function:verifyssm"
  Id = "ObjectCreated-dada-json"
  Filter = @{
    S3KeyFilter = @{
      FilterRules = @(
        @{Name="Prefix";Value="dada"}
        @{Name="Suffix";Value=".json"}
      )
    }
  }
}

Write-S3BucketNotification -BucketName amzn-s3-demo-bucket -LambdaFunctionConfiguration $firstLambdaConfig,$secondlambdaConfig

Exemple 1 : Cet exemple définit une configuration de réplication avec une règle unique permettant de répliquer vers le compartiment « amzn-s3-demo-bucket » tout nouvel objet créé avec le préfixe du nom de clé « » dans le compartiment « amzn-s3-demo-bucket ». TaxDocs

$rule1 = New-Object Amazon.S3.Model.ReplicationRule
$rule1.ID = "Rule-1"
$rule1.Status = "Enabled"
$rule1.Prefix = "TaxDocs"
$rule1.Destination = @{ BucketArn = "arn:aws:s3:::amzn-s3-demo-destination-bucket" }
    
$params = @{
    BucketName = "amzn-s3-demo-bucket"
    Configuration_Role = "arn:aws:iam::35667example:role/CrossRegionReplicationRoleForS3"
    Configuration_Rule = $rule1
}

Write-S3BucketReplication @params

Exemple 2 : Cet exemple définit une configuration de réplication avec plusieurs règles permettant de répliquer vers le compartiment « amzn-s3-demo-bucket » tout nouvel objet créé avec le préfixe du nom de clé «" ou "». TaxDocs OtherDocs Les préfixes de clés ne doivent pas se chevaucher.

$rule1 = New-Object Amazon.S3.Model.ReplicationRule
$rule1.ID = "Rule-1"
$rule1.Status = "Enabled"
$rule1.Prefix = "TaxDocs"
$rule1.Destination = @{ BucketArn = "arn:aws:s3:::amzn-s3-demo-destination-bucket" }
    
$rule2 = New-Object Amazon.S3.Model.ReplicationRule
$rule2.ID = "Rule-2"
$rule2.Status = "Enabled"
$rule2.Prefix = "OtherDocs"
$rule2.Destination = @{ BucketArn = "arn:aws:s3:::amzn-s3-demo-destination-bucket" }
    
$params = @{
    BucketName = "amzn-s3-demo-bucket"
    Configuration_Role = "arn:aws:iam::35667example:role/CrossRegionReplicationRoleForS3"
    Configuration_Rule = $rule1,$rule2
}

Write-S3BucketReplication @params

Exemple 3 : Cet exemple met à jour la configuration de réplication sur le compartiment spécifié pour désactiver la règle contrôlant la réplication des objets avec le préfixe du nom de clé « » vers le compartiment TaxDocs 'amzn-s3-demo-bucket'.

$rule1 = New-Object Amazon.S3.Model.ReplicationRule
$rule1.ID = "Rule-1"
$rule1.Status = "Disabled"
$rule1.Prefix = "TaxDocs"
$rule1.Destination = @{ BucketArn = "arn:aws:s3:::amzn-s3-demo-destination-bucket" }
    
$params = @{
    BucketName = "amzn-s3-demo-bucket"
    Configuration_Role = "arn:aws:iam::35667example:role/CrossRegionReplicationRoleForS3"
    Configuration_Rule = $rule1
}

Write-S3BucketReplication @params

Exemple 1 : met à jour la configuration du paiement des demandes pour le compartiment nommé « amzn-s3-demo-bucket » afin que le téléchargement soit facturé à la personne demandant des téléchargements depuis le compartiment. Par défaut, le propriétaire du compartiment paie les téléchargements. Pour rétablir la valeur par défaut de la demande de paiement, utilisez « BucketOwner » pour le paramètre RequestPaymentConfiguration _Payer.

Write-S3BucketRequestPayment -BucketName amzn-s3-demo-bucket -RequestPaymentConfiguration_Payer Requester

Exemple 1 : cette commande applique deux balises à un compartiment nommé cloudtrail-test-2018 : une balise avec une clé Stage et une valeur Test, et une balise avec une clé Environment et une valeur Alpha. Pour vérifier que les balises ont été ajoutées au compartiment, exécutez Get-S3BucketTagging -BucketName bucket_name. Les résultats doivent indiquer les balises que vous avez appliquées au compartiment lors de la première commande. Notez que Write-S3BucketTagging remplace la totalité du jeu de balises existant sur un compartiment. Pour ajouter ou supprimer des balises individuelles, exécutez les applets de commande Resource Groups et Tagging API, ainsi que Add-RGTResourceTag et Remove-RGTResourceTag. Vous pouvez également utiliser l'éditeur de balises dans la console AWS de gestion pour gérer les balises du compartiment S3.

Write-S3BucketTagging -BucketName amzn-s3-demo-bucket -TagSet @( @{ Key="Stage"; Value="Test" }, @{ Key="Environment"; Value="Alpha" } )

Exemple 2 : cette commande dirige un compartiment nommé cloudtrail-test-2018 vers l’applet de commande Write-S3BucketTagging. Il applique Stage:Production des étiquettes et Department:Finance au seau. Notez que Write-S3BucketTagging remplace la totalité du jeu de balises existant sur un compartiment.

Get-S3Bucket -BucketName amzn-s3-demo-bucket | Write-S3BucketTagging -TagSet @( @{ Key="Stage"; Value="Production" }, @{ Key="Department"; Value="Finance" } )

Exemple 1 : la commande active la gestion des versions pour le compartiment S3 donné.

Write-S3BucketVersioning -BucketName 'amzn-s3-demo-bucket' -VersioningConfig_Status Enabled

Exemple 1 : la commande active l’hébergement du site Web pour le compartiment donné avec le document d’index « index.html » et le document d’erreur « error.html ».

Write-S3BucketWebsite -BucketName 'amzn-s3-demo-bucket' -WebsiteConfiguration_IndexDocumentSuffix 'index.html' -WebsiteConfiguration_ErrorDocument 'error.html'

Exemple 1 : Cet exemple écrit/remplace la configuration fournie dans le $NewRule. Cette configuration garantit de limiter les objets de portée avec des valeurs de préfixe et de balise données.

$NewRule = [Amazon.S3.Model.LifecycleRule] @{
		Expiration =  @{
			Days=  50
		}
		Id =  "Test-From-Write-cmdlet-1"
		Filter=  @{
			LifecycleFilterPredicate =  [Amazon.S3.Model.LifecycleAndOperator]@{
				Operands=  @(
					[Amazon.S3.Model.LifecyclePrefixPredicate] @{
						"Prefix" =  "py"
					},
					[Amazon.S3.Model.LifecycleTagPredicate] @{
						"Tag"=  @{
							"Key" =  "non-use"
							"Value" = "yes"
						}
					}
				)
			}
		}
		"Status"= 'Enabled'
		NoncurrentVersionExpiration = @{
			NoncurrentDays = 75
		}
	}
    
	Write-S3LifecycleConfiguration -BucketName amzn-s3-demo-bucket -Configuration_Rule $NewRule

Exemple 2 : Cet exemple définit plusieurs règles avec filtrage. $ ArchiveRule définit les objets à archiver dans 30 jours sur Glacier et 120 sur DeepArchive. $ fait ExpireRule expirer la version actuelle et les versions précédentes dans 150 jours pour les objets dont le préfixe « py » et la balise tag:key « archieved » est définie sur « yes ».

$ExpireRule = [Amazon.S3.Model.LifecycleRule] @{
		Expiration =  @{
			Days=  150
		}
		Id =  "Remove-in-150-days"
		Filter=  @{
			LifecycleFilterPredicate =  [Amazon.S3.Model.LifecycleAndOperator]@{
				Operands=  @(
					[Amazon.S3.Model.LifecyclePrefixPredicate] @{
						"Prefix" =  "py"
					},
					[Amazon.S3.Model.LifecycleTagPredicate] @{
						"Tag"=  @{
							"Key" =  "archived"
							"Value" = "yes"
						}
					}
				)
			}
		}
		Status= 'Enabled'
		NoncurrentVersionExpiration = @{
			NoncurrentDays = 150
		}
	}

	$ArchiveRule = [Amazon.S3.Model.LifecycleRule] @{
		Expiration =  $null
		Id =  "Archive-to-Glacier-in-30-days"
		Filter=  @{
			LifecycleFilterPredicate =  [Amazon.S3.Model.LifecycleAndOperator]@{
				Operands= @(
					[Amazon.S3.Model.LifecyclePrefixPredicate] @{
						"Prefix" =  "py"
					},
					[Amazon.S3.Model.LifecycleTagPredicate] @{
						"Tag"=  @{
							"Key" =  "reviewed"
							"Value" = "yes"
						}
					}
				)
			}
		}
		Status = 'Enabled'
		NoncurrentVersionExpiration = @{
			NoncurrentDays = 75
		}
		Transitions = @(
			@{
				Days = 30
				"StorageClass"= 'Glacier'
			},
			@{
				Days = 120
				"StorageClass"= [Amazon.S3.S3StorageClass]::DeepArchive
			}
		)
	}

	Write-S3LifecycleConfiguration -BucketName amzn-s3-demo-bucket -Configuration_Rule $ExpireRule,$ArchiveRule

Exemple 1 : cette commande charge le fichier unique « local-sample.txt » sur Amazon S3, créant un objet avec la clé « sample.txt » dans le compartiment « test-files ».

Write-S3Object -BucketName amzn-s3-demo-bucket -Key "sample.txt" -File .\local-sample.txt

Exemple 2 : cette commande charge le fichier unique « sample.txt » sur Amazon S3, créant un objet avec la clé « sample.txt » dans le compartiment « test-files ». Si le paramètre -Key n’est pas fourni, le nom du fichier est utilisé comme clé d’objet S3.

Write-S3Object -BucketName amzn-s3-demo-bucket -File .\sample.txt

Exemple 3 : Cette commande télécharge le fichier unique « local-sample.txt » sur Amazon S3, créant un objet avec la clé « prefix/to /sample.txt » dans le compartiment « test-files ».

Write-S3Object -BucketName amzn-s3-demo-bucket -Key "prefix/to/sample.txt" -File .\local-sample.txt

Exemple 4 : Cette commande télécharge tous les fichiers du sous-répertoire « Scripts » vers le bucket « test-files » et applique le préfixe de clé commun « SampleScripts » à chaque objet. Chaque fichier téléchargé aura une clé de « » où le SampleScripts/filename « nom de fichier » varie.

Write-S3Object -BucketName amzn-s3-demo-bucket -Folder .\Scripts -KeyPrefix SampleScripts\

Exemple 5 : Cette commande télécharge tous les fichiers *.ps1 du répertoire local « Scripts » vers le bucket « test-files » et applique le préfixe de clé commun « » SampleScripts à chaque objet. Chaque fichier téléchargé aura une clé de « » où le SampleScripts/filename.ps1 « nom de fichier » varie.

Write-S3Object -BucketName amzn-s3-demo-bucket -Folder .\Scripts -KeyPrefix SampleScripts\ -SearchPattern *.ps1

Exemple 6 : cette commande crée un nouvel objet S3 contenant la chaîne de contenu spécifiée avec la clé « sample.txt ».

Write-S3Object -BucketName amzn-s3-demo-bucket -Key "sample.txt" -Content "object contents"

Exemple 7 : cette commande charge le fichier spécifié (le nom du fichier est utilisé comme clé) et applique les balises spécifiées au nouvel objet.

Write-S3Object -BucketName amzn-s3-demo-bucket -File "sample.txt" -TagSet @{Key="key1";Value="value1"},@{Key="key2";Value="value2"}

Exemple 8 : cette commande charge de manière récursive le dossier spécifié et applique les balises spécifiées à tous les nouveaux objets.

Write-S3Object -BucketName amzn-s3-demo-bucket -Folder . -KeyPrefix "TaggedFiles" -Recurse -TagSet @{Key="key1";Value="value1"},@{Key="key2";Value="value2"}

Exemple 1 : la commande active le mode de rétention de la gouvernance jusqu’à la date du 31 décembre 2019 à 00 h 00 m 00 s pour l’objet « testfile.txt » dans le compartiment S3 donné.

Write-S3ObjectRetention -BucketName 'amzn-s3-demo-bucket' -Key 'testfile.txt' -Retention_Mode GOVERNANCE -Retention_RetainUntilDate "2019-12-31T00:00:00"