D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
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 Glacier utilisant des outils pour la PowerShell version 5
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 Glacier.
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
### `Get-GLCJob`
L'exemple de code suivant montre comment utiliser`Get-GLCJob`.
**Outils pour PowerShell V5**
**Exemple 1 : renvoi des détails de la tâche spécifiée. Lorsque la tâche est terminée avec succès, l'applet de commande GCJob Read-Output peut être utilisée pour récupérer le contenu de la tâche (une archive ou une liste d'inventaire) dans le système de fichiers local.**
```
Get-GLCJob -VaultName myvault -JobId "op1x...JSbthM"
```
**Sortie** :
```
Action : ArchiveRetrieval
ArchiveId : o9O9j...X-TpIhQJw
ArchiveSHA256TreeHash : 79f3ea754c02f58...dc57bf4395b
ArchiveSizeInBytes : 38034480
Completed : False
CompletionDate : 1/1/0001 12:00:00 AM
CreationDate : 12/13/2018 11:00:14 AM
InventoryRetrievalParameters :
InventorySizeInBytes : 0
JobDescription :
JobId : op1x...JSbthM
JobOutputPath :
OutputLocation :
RetrievalByteRange : 0-38034479
SelectParameters :
SHA256TreeHash : 79f3ea754c02f58...dc57bf4395b
SNSTopic :
StatusCode : InProgress
StatusMessage :
Tier : Standard
VaultARN : arn:aws:glacier:us-west-2:012345678912:vaults/test
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeJob](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `New-GLCVault`
L'exemple de code suivant montre comment utiliser`New-GLCVault`.
**Outils pour PowerShell V5**
**Exemple 1 : crée un nouveau coffre-fort pour le compte de l’utilisateur. Comme aucune valeur n'a été fournie au AccountId paramètre -, les applets de commande utilisent la valeur par défaut « - » pour indiquer le compte courant.**
```
New-GLCVault -VaultName myvault
```
**Sortie** :
```
/01234567812/vaults/myvault
```
+ Pour plus de détails sur l'API, reportez-vous [CreateVault](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Read-GLCJobOutput`
L'exemple de code suivant montre comment utiliser`Read-GLCJobOutput`.
**Outils pour PowerShell V5**
**Exemple 1 : télécharge le contenu de l’archive dont l’extraction était planifiée dans le cadre de la tâche spécifiée et stocke le contenu dans un fichier sur disque. Le téléchargement valide le checksum pour vous, s’il est disponible. Si vous le souhaitez, la réponse complète, y compris le checksum, peut être renvoyée en spécifiant `-Select '*'`.**
```
Read-GLCJobOutput -VaultName myvault -JobId "HSWjArc...Zq2XLiW" -FilePath "c:\temp\blue.bin"
```
+ Pour plus de détails sur l'API, reportez-vous [GetJobOutput](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Start-GLCJob`
L'exemple de code suivant montre comment utiliser`Start-GLCJob`.
**Outils pour PowerShell V5**
**Exemple 1 : démarre une tâche pour extraire une archive dans le coffre-fort spécifié appartenant à l’utilisateur. L'état de la tâche peut être vérifié à l'aide de l'GLCJob applet de commande Get-. Lorsque le travail est terminé avec succès, l'applet de commande GCJob Read-Output peut être utilisée pour récupérer le contenu de l'archive dans le système de fichiers local.**
```
Start-GLCJob -VaultName myvault -JobType "archive-retrieval" -JobDescription "archive retrieval" -ArchiveId "o9O9j...TX-TpIhQJw"
```
**Sortie** :
```
JobId JobOutputPath Location
----- ------------- --------
op1x...JSbthM /012345678912/vaults/test/jobs/op1xe...I4HqCHkSJSbthM
```
+ Pour plus de détails sur l'API, reportez-vous [InitiateJob](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Write-GLCArchive`
L'exemple de code suivant montre comment utiliser`Write-GLCArchive`.
**Outils pour PowerShell V5**
**Exemple 1 : télécharge un seul fichier dans le coffre-fort spécifié, en renvoyant l’ID de l’archive et la somme de contrôle calculée.**
```
Write-GLCArchive -VaultName myvault -FilePath c:\temp\blue.bin
```
**Sortie** :
```
FilePath ArchiveId Checksum
-------- --------- --------
C:\temp\blue.bin o9O9jUUs...TTX-TpIhQJw 79f3e...f4395b
```
**Exemple 2 : charge le contenu d’une hiérarchie de dossiers dans le coffre-fort spécifié dans le compte de l’utilisateur. Pour chaque fichier chargé, l’applet de commande émet le nom du fichier, l’ID d’archive correspondant et la somme de contrôle calculée de l’archive.**
```
Write-GLCArchive -VaultName myvault -FolderPath . -Recurse
```
**Sortie** :
```
FilePath ArchiveId Checksum
-------- --------- --------
C:\temp\blue.bin o9O9jUUs...TTX-TpIhQJw 79f3e...f4395b
C:\temp\green.bin qXAfOdSG...czo729UHXrw d50a1...9184b9
C:\temp\lum.bin 39aNifP3...q9nb8nZkFIg 28886...5c3e27
C:\temp\red.bin vp7E6rU_...Ejk_HhjAxKA e05f7...4e34f5
C:\temp\Folder1\file1.txt _eRINlip...5Sxy7dD2BaA d0d2a...c8a3ba
C:\temp\Folder2\file2.iso -Ix3jlmu...iXiDh-XfOPA 7469e...3e86f1
```
+ Pour plus de détails sur l'API, reportez-vous [UploadArchive](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.