La version 5 (V5) du Outils AWS pour PowerShell est sortie \$1
Pour plus d'informations sur les modifications majeures et la migration de vos applications, consultez la [rubrique relative à la migration](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html).
[https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html)
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Exemples d'Amazon S3 utilisant des outils pour PowerShell V5
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de la Outils AWS pour PowerShell V5 avec Amazon S3.
Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.
Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.
**Topics**
+ [Actions](#actions)
## Actions
### `Copy-S3Object`
L'exemple de code suivant montre comment utiliser`Copy-S3Object`.
**Outils pour 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:\$1downloads\$1data\$1archive.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
```
+ Pour plus de détails sur l'API, reportez-vous [CopyObject](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3Bucket`
L'exemple de code suivant montre comment utiliser`Get-S3Bucket`.
**Outils pour PowerShell V5**
**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
```
+ Pour plus de détails sur l'API, reportez-vous [ListBuckets](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3BucketACL`
L'exemple de code suivant montre comment utiliser`Get-S3BucketACL`.
**Outils pour PowerShell V5**
**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
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketAcl](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3BucketAccelerateConfiguration`
L'exemple de code suivant montre comment utiliser`Get-S3BucketAccelerateConfiguration`.
**Outils pour PowerShell V5**
**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
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketAccelerateConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3BucketAnalyticsConfiguration`
L'exemple de code suivant montre comment utiliser`Get-S3BucketAnalyticsConfiguration`.
**Outils pour PowerShell V5**
**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'
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketAnalyticsConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3BucketAnalyticsConfigurationList`
L'exemple de code suivant montre comment utiliser`Get-S3BucketAnalyticsConfigurationList`.
**Outils pour PowerShell V5**
**Exemple 1 : cette commande renvoie les cent premières configurations d’analyse du compartiment S3 donné.**
```
Get-S3BucketAnalyticsConfigurationList -BucketName 'amzn-s3-demo-bucket'
```
+ Pour plus de détails sur l'API, reportez-vous [ListBucketAnalyticsConfigurations](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3BucketEncryption`
L'exemple de code suivant montre comment utiliser`Get-S3BucketEncryption`.
**Outils pour PowerShell V5**
**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'
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketEncryption](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3BucketInventoryConfiguration`
L'exemple de code suivant montre comment utiliser`Get-S3BucketInventoryConfiguration`.
**Outils pour PowerShell V5**
**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'
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketInventoryConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3BucketInventoryConfigurationList`
L'exemple de code suivant montre comment utiliser`Get-S3BucketInventoryConfigurationList`.
**Outils pour PowerShell V5**
**Exemple 1 : cette commande renvoie les cent premières configurations d’inventaire du compartiment S3 donné.**
```
Get-S3BucketInventoryConfigurationList -BucketName 'amzn-s3-demo-bucket'
```
+ Pour plus de détails sur l'API, reportez-vous [ListBucketInventoryConfigurations](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3BucketLocation`
L'exemple de code suivant montre comment utiliser`Get-S3BucketLocation`.
**Outils pour PowerShell V5**
**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
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketLocation](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3BucketLogging`
L'exemple de code suivant montre comment utiliser`Get-S3BucketLogging`.
**Outils pour PowerShell V5**
**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
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketLogging](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3BucketMetricsConfiguration`
L'exemple de code suivant montre comment utiliser`Get-S3BucketMetricsConfiguration`.
**Outils pour PowerShell V5**
**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'
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketMetricsConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3BucketNotification`
L'exemple de code suivant montre comment utiliser`Get-S3BucketNotification`.
**Outils pour PowerShell V5**
**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
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketNotification](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3BucketPolicy`
L'exemple de code suivant montre comment utiliser`Get-S3BucketPolicy`.
**Outils pour PowerShell V5**
**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'
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketPolicy](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3BucketPolicyStatus`
L'exemple de code suivant montre comment utiliser`Get-S3BucketPolicyStatus`.
**Outils pour PowerShell V5**
**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'
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketPolicyStatus](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3BucketReplication`
L'exemple de code suivant montre comment utiliser`Get-S3BucketReplication`.
**Outils pour PowerShell V5**
**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
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketReplication](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3BucketRequestPayment`
L'exemple de code suivant montre comment utiliser`Get-S3BucketRequestPayment`.
**Outils pour PowerShell V5**
**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
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketRequestPayment](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3BucketTagging`
L'exemple de code suivant montre comment utiliser`Get-S3BucketTagging`.
**Outils pour PowerShell V5**
**Exemple 1 : cette commande renvoie toutes les balises associées au compartiment donné.**
```
Get-S3BucketTagging -BucketName 'amzn-s3-demo-bucket'
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketTagging](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3BucketVersioning`
L'exemple de code suivant montre comment utiliser`Get-S3BucketVersioning`.
**Outils pour PowerShell V5**
**Exemple 1 : cette commande renvoie le statut de la gestion des versions par rapport au compartiment donné.**
```
Get-S3BucketVersioning -BucketName 'amzn-s3-demo-bucket'
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketVersioning](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3BucketWebsite`
L'exemple de code suivant montre comment utiliser`Get-S3BucketWebsite`.
**Outils pour PowerShell V5**
**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'
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketWebsite](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3CORSConfiguration`
L'exemple de code suivant montre comment utiliser`Get-S3CORSConfiguration`.
**Outils pour PowerShell V5**
**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 : {}
```
+ Pour plus de détails sur l'API, consultez la section [Get CORSConfiguration](https://docs.aws.amazon.com/powershell/v5/reference) in *Outils AWS pour PowerShell Cmdlet Reference (V5)*.
### `Get-S3HeadBucket`
L'exemple de code suivant montre comment utiliser`Get-S3HeadBucket`.
**Outils pour PowerShell V5**
**Exemple 1 : Cette commande renvoie le résultat avec le code d'état HTTP 200 OK pour le bucket existant lorsque l'utilisateur est autorisé à y accéder. BucketArn le paramètre n'est pris en charge que pour les compartiments de répertoire 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 bucket 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.
```
+ Pour plus de détails sur l'API, reportez-vous [HeadBucket](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3LifecycleConfiguration`
L'exemple de code suivant montre comment utiliser`Get-S3LifecycleConfiguration`.
**Outils pour PowerShell V5**
**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}
```
+ Pour plus de détails sur l'API, reportez-vous [GetLifecycleConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3Object`
L'exemple de code suivant montre comment utiliser`Get-S3Object`.
**Outils pour PowerShell V5**
**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
```
+ Pour plus de détails sur l'API, reportez-vous [ListObjects](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3ObjectACL`
L'exemple de code suivant montre comment utiliser`Get-S3ObjectACL`.
**Outils pour PowerShell V5**
**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
```
+ Pour plus de détails sur l'API, reportez-vous [GetObjectAcl](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3ObjectLockConfiguration`
L'exemple de code suivant montre comment utiliser`Get-S3ObjectLockConfiguration`.
**Outils pour PowerShell V5**
**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
```
+ Pour plus de détails sur l'API, reportez-vous [GetObjectLockConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3ObjectMetadata`
L'exemple de code suivant montre comment utiliser`Get-S3ObjectMetadata`.
**Outils pour PowerShell V5**
**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 :
```
+ Pour plus de détails sur l'API, reportez-vous [GetObjectMetadata](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3ObjectRetention`
L'exemple de code suivant montre comment utiliser`Get-S3ObjectRetention`.
**Outils pour PowerShell V5**
**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'
```
+ Pour plus de détails sur l'API, reportez-vous [GetObjectRetention](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3ObjectTagSet`
L'exemple de code suivant montre comment utiliser`Get-S3ObjectTagSet`.
**Outils pour PowerShell V5**
**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
```
+ Pour plus de détails sur l'API, reportez-vous [GetObjectTagging](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3PreSignedURL`
L'exemple de code suivant montre comment utiliser`Get-S3PreSignedURL`.
**Outils pour PowerShell V5**
**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'
```
+ Pour plus de détails sur l'API, voir [GetPreSignedURL](https://docs.aws.amazon.com/powershell/v5/reference) dans la *référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3PublicAccessBlock`
L'exemple de code suivant montre comment utiliser`Get-S3PublicAccessBlock`.
**Outils pour PowerShell V5**
**Exemple 1 : la commande renvoie la configuration du bloc d’accès public du compartiment S3 donné.**
```
Get-S3PublicAccessBlock -BucketName 'amzn-s3-demo-bucket'
```
+ Pour plus de détails sur l'API, reportez-vous [GetPublicAccessBlock](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-S3Version`
L'exemple de code suivant montre comment utiliser`Get-S3Version`.
**Outils pour PowerShell V5**
**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 :
```
+ Pour plus de détails sur l'API, reportez-vous [ListVersions](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `New-S3Bucket`
L'exemple de code suivant montre comment utiliser`New-S3Bucket`.
**Outils pour PowerShell V5**
**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
```
+ Pour plus de détails sur l'API, reportez-vous [PutBucket](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Read-S3Object`
L'exemple de code suivant montre comment utiliser`Read-S3Object`.
**Outils pour PowerShell V5**
**Exemple 1 : Cette commande récupère l'élément « sample.txt » du bucket « 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 bucket « amzn-s3-demo-bucket » et l'enregistre dans un dossier nommé « Local-dir » à l'emplacement actuel. Il n’est pas nécessaire que le fichier « "Local-DIR » existe 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
```
+ Pour plus de détails sur l'API, reportez-vous [GetObject](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-S3Bucket`
L'exemple de code suivant montre comment utiliser`Remove-S3Bucket`.
**Outils pour PowerShell V5**
**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
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteBucket](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-S3BucketAnalyticsConfiguration`
L'exemple de code suivant montre comment utiliser`Remove-S3BucketAnalyticsConfiguration`.
**Outils pour PowerShell V5**
**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'
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteBucketAnalyticsConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-S3BucketEncryption`
L'exemple de code suivant montre comment utiliser`Remove-S3BucketEncryption`.
**Outils pour PowerShell V5**
**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
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteBucketEncryption](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-S3BucketInventoryConfiguration`
L'exemple de code suivant montre comment utiliser`Remove-S3BucketInventoryConfiguration`.
**Outils pour PowerShell V5**
**Exemple 1 : Cette commande supprime l'inventaire nommé « testInventoryName » 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
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteBucketInventoryConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-S3BucketMetricsConfiguration`
L'exemple de code suivant montre comment utiliser`Remove-S3BucketMetricsConfiguration`.
**Outils pour PowerShell V5**
**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'
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteBucketMetricsConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-S3BucketPolicy`
L'exemple de code suivant montre comment utiliser`Remove-S3BucketPolicy`.
**Outils pour PowerShell V5**
**Exemple 1 : la commande supprime la stratégie de compartiment associée au compartiment S3 donné.**
```
Remove-S3BucketPolicy -BucketName 'amzn-s3-demo-bucket'
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteBucketPolicy](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-S3BucketReplication`
L'exemple de code suivant montre comment utiliser`Remove-S3BucketReplication`.
**Outils pour PowerShell V5**
**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
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteBucketReplication](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-S3BucketTagging`
L'exemple de code suivant montre comment utiliser`Remove-S3BucketTagging`.
**Outils pour PowerShell V5**
**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
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteBucketTagging](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-S3BucketWebsite`
L'exemple de code suivant montre comment utiliser`Remove-S3BucketWebsite`.
**Outils pour PowerShell V5**
**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
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteBucketWebsite](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-S3CORSConfiguration`
L'exemple de code suivant montre comment utiliser`Remove-S3CORSConfiguration`.
**Outils pour PowerShell V5**
**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
```
+ Pour plus de détails sur l'API, voir [Supprimer CORSConfiguration](https://docs.aws.amazon.com/powershell/v5/reference) dans la *référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-S3LifecycleConfiguration`
L'exemple de code suivant montre comment utiliser`Remove-S3LifecycleConfiguration`.
**Outils pour PowerShell V5**
**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'
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteLifecycleConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-S3MultipartUpload`
L'exemple de code suivant montre comment utiliser`Remove-S3MultipartUpload`.
**Outils pour PowerShell V5**
**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"
```
+ Pour plus de détails sur l'API, reportez-vous [AbortMultipartUpload](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-S3Object`
L'exemple de code suivant montre comment utiliser`Remove-S3Object`.
**Outils pour PowerShell V5**
**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-S3Objectrenvoie une collection d'instances Amazon.S3.Model.S3Object, dont chacune possède un membre clé 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 dont le préfixe clé est « prefix/subprefix » dans le compartiment et les supprime. Notez que les objets entrants sont traités un par un. Pour les collections volumineuses, pensez à transmettre la collection au paramètre - InputObject (alias -S3ObjectCollection) de l'applet de commande pour permettre à la suppression de se produire par lots 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'ObjectVersion instances Amazon.S3.Model.S3 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 collections volumineuses, pensez à transmettre la collection au paramètre - InputObject (alias -S3ObjectCollection) de l'applet de commande pour permettre à la suppression de se produire par lots 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 supprimer par lots un ensemble d'objets (dans ce cas, des marqueurs de suppression) en créant 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
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteObjects](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-S3ObjectTagSet`
L'exemple de code suivant montre comment utiliser`Remove-S3ObjectTagSet`.
**Outils pour PowerShell V5**
**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
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteObjectTagging](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-S3PublicAccessBlock`
L'exemple de code suivant montre comment utiliser`Remove-S3PublicAccessBlock`.
**Outils pour PowerShell V5**
**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
```
+ Pour plus de détails sur l'API, reportez-vous [DeletePublicAccessBlock](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Set-S3BucketEncryption`
L'exemple de code suivant montre comment utiliser`Set-S3BucketEncryption`.
**Outils pour PowerShell V5**
**Exemple 1 : Cette commande active le chiffrement côté AES256 serveur par défaut avec les clés gérées Amazon S3 (SSE-S3) sur le compartiment donné.**
```
$Encryptionconfig = @{ServerSideEncryptionByDefault = @{ServerSideEncryptionAlgorithm = "AES256"}}
Set-S3BucketEncryption -BucketName 'amzn-s3-demo-bucket' -ServerSideEncryptionConfiguration_ServerSideEncryptionRule $Encryptionconfig
```
+ Pour plus de détails sur l'API, reportez-vous [PutBucketEncryption](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Test-S3Bucket`
L'exemple de code suivant montre comment utiliser`Test-S3Bucket`.
**Outils pour PowerShell V5**
**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
```
+ Pour plus de détails sur l'API, reportez-vous [Test-S3Bucket](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Write-S3BucketAccelerateConfiguration`
L'exemple de code suivant montre comment utiliser`Write-S3BucketAccelerateConfiguration`.
**Outils pour PowerShell V5**
**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
```
+ Pour plus de détails sur l'API, reportez-vous [PutBucketAccelerateConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Write-S3BucketNotification`
L'exemple de code suivant montre comment utiliser`Write-S3BucketNotification`.
**Outils pour PowerShell V5**
**Exemple 1 : Cet exemple configure la configuration de la rubrique SNS pour l'événement S3 ObjectRemovedDelete et active les notifications 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é qui l'envoient à 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
```
+ Pour plus de détails sur l'API, reportez-vous [PutBucketNotification](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Write-S3BucketReplication`
L'exemple de code suivant montre comment utiliser`Write-S3BucketReplication`.
**Outils pour PowerShell V5**
**Exemple 1 : Cet exemple définit une configuration de réplication avec une règle unique permettant de répliquer dans le compartiment « amzn-s3-demo-bucket » tous les nouveaux objets créés avec le préfixe de nom 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 » tous les nouveaux objets créés avec le préfixe de 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é afin de désactiver la règle contrôlant la réplication des objets portant le préfixe de nom 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
```
+ Pour plus de détails sur l'API, reportez-vous [PutBucketReplication](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Write-S3BucketRequestPayment`
L'exemple de code suivant montre comment utiliser`Write-S3BucketRequestPayment`.
**Outils pour PowerShell V5**
**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 du paiement de la demande, utilisez « BucketOwner » pour le paramètre RequestPaymentConfiguration \$1Payer.**
```
Write-S3BucketRequestPayment -BucketName amzn-s3-demo-bucket -RequestPaymentConfiguration_Payer Requester
```
+ Pour plus de détails sur l'API, reportez-vous [PutBucketRequestPayment](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Write-S3BucketTagging`
L'exemple de code suivant montre comment utiliser`Write-S3BucketTagging`.
**Outils pour PowerShell V5**
**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 de 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`. Elle applique les balises Stage:Production et Department:Finance au compartiment. 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" } )
```
+ Pour plus de détails sur l'API, reportez-vous [PutBucketTagging](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Write-S3BucketVersioning`
L'exemple de code suivant montre comment utiliser`Write-S3BucketVersioning`.
**Outils pour PowerShell V5**
**Exemple 1 : la commande active la gestion des versions pour le compartiment S3 donné.**
```
Write-S3BucketVersioning -BucketName 'amzn-s3-demo-bucket' -VersioningConfig_Status Enabled
```
+ Pour plus de détails sur l'API, reportez-vous [PutBucketVersioning](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Write-S3BucketWebsite`
L'exemple de code suivant montre comment utiliser`Write-S3BucketWebsite`.
**Outils pour PowerShell V5**
**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'
```
+ Pour plus de détails sur l'API, reportez-vous [PutBucketWebsite](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Write-S3LifecycleConfiguration`
L'exemple de code suivant montre comment utiliser`Write-S3LifecycleConfiguration`.
**Outils pour PowerShell V5**
**Exemple 1 : Cet exemple écrit/remplace la configuration fournie dans le \$1NewRule. 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 le filtrage. \$1 ArchiveRule définit les objets à archiver dans 30 jours dans Glacier et 120 dans DeepArchive. \$1 ExpireRule expire les versions actuelles et précédentes en 150 jours pour les objets dont le préfixe « py » et le tag:key « archivé » sont définis 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
```
+ Pour plus de détails sur l'API, reportez-vous [PutLifecycleConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Write-S3Object`
L'exemple de code suivant montre comment utiliser`Write-S3Object`.
**Outils pour PowerShell V5**
**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 « » à chaque objet. SampleScripts Chaque fichier téléchargé aura une clé « SampleScripts /filename » où « filename » varie.**
```
Write-S3Object -BucketName amzn-s3-demo-bucket -Folder .\Scripts -KeyPrefix SampleScripts\
```
**Exemple 5 : Cette commande télécharge tous les fichiers\$1.ps1 du répertoire local « Scripts » vers le bucket « test-files » et applique le préfixe de clé commun « » à chaque objet. SampleScripts Chaque fichier téléchargé aura une clé « SampleScripts /filename.ps1 » où le « 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"}
```
+ Pour plus de détails sur l'API, reportez-vous [PutObject](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Write-S3ObjectRetention`
L'exemple de code suivant montre comment utiliser`Write-S3ObjectRetention`.
**Outils pour PowerShell V5**
**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"
```
+ Pour plus de détails sur l'API, reportez-vous [PutObjectRetention](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.