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'ACM utilisant Tools for V5 PowerShell
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 ACM.
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-ACMCertificate`
L'exemple de code suivant montre comment utiliser`Get-ACMCertificate`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple montre comment renvoyer un certificat et sa chaîne à l’aide de l’ARN du certificat.**
```
Get-ACMCertificate -CertificateArn "arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012"
```
+ Pour plus de détails sur l'API, reportez-vous [GetCertificate](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-ACMCertificateDetail`
L'exemple de code suivant montre comment utiliser`Get-ACMCertificateDetail`.
**Outils pour PowerShell V5**
**Exemple 1 : renvoie les détails du certificat spécifié.**
```
Get-ACMCertificateDetail -CertificateArn "arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012"
```
**Sortie** :
```
CertificateArn : arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012
CreatedAt : 1/21/2016 5:55:59 PM
DomainName : www.example.com
DomainValidationOptions : {www.example.com}
InUseBy : {}
IssuedAt : 1/1/0001 12:00:00 AM
Issuer :
KeyAlgorithm : RSA-2048
NotAfter : 1/1/0001 12:00:00 AM
NotBefore : 1/1/0001 12:00:00 AM
RevocationReason :
RevokedAt : 1/1/0001 12:00:00 AM
Serial :
SignatureAlgorithm : SHA256WITHRSA
Status : PENDING_VALIDATION
Subject : CN=www.example.com
SubjectAlternativeNames : {www.example.net}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeCertificate](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-ACMCertificateList`
L'exemple de code suivant montre comment utiliser`Get-ACMCertificateList`.
**Outils pour PowerShell V5**
**Exemple 1 : récupère la liste de tous vos certificats ARNs et le nom de domaine de chacun d'entre eux. L'applet de commande pagine automatiquement pour récupérer tous les. ARNs Pour contrôler manuellement la pagination, utilisez le MaxItem paramètre - pour contrôler le nombre de certificats ARNs renvoyés pour chaque appel de service et le NextToken paramètre - pour indiquer le point de départ de chaque appel.**
```
Get-ACMCertificateList
```
**Sortie** :
```
CertificateArn DomainName
-------------- ----------
arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012 www.example.com
```
**Exemple 2 : récupère une liste de tous vos certificats ARNs dont le statut correspond aux états fournis.**
```
Get-ACMCertificateList -CertificateStatus "VALIDATION_TIMED_OUT","FAILED"
```
**Exemple 3 : cet exemple renvoie une liste de tous les certificats de la région us-east-1 dont le type de clé est RSA\$12048 et dont l’utilisation ou l’objectif étendu de la clé est CODE\$1SIGNING. Vous trouverez les valeurs de ces paramètres de filtrage dans la rubrique de référence de l'API ListCertificates Filters : https://docs.aws.amazon.com/acm/ latest/APIReference/API \$1Filters.html.**
```
Get-ACMCertificateList -Region us-east-1 -Includes_KeyType RSA_2048 -Includes_ExtendedKeyUsage CODE_SIGNING
```
**Sortie** :
```
CertificateArn DomainName
-------------- ----------
arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-d7c0-48c1-af8d-2133d8f30zzz *.route53docs.com
arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-98a5-443d-a734-800430c80zzz nerdzizm.net
arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-2be6-4376-8fa7-bad559525zzz
arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-e7ca-44c5-803e-24d9f2f36zzz
arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-1241-4b71-80b1-090305a62zzz
arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-8709-4568-8c64-f94617c99zzz
arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-a8fa-4a61-98cf-e08ccc0eezzz
arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-fa47-40fe-a714-2d277d3eezzz *.route53docs.com
```
+ Pour plus de détails sur l'API, reportez-vous [ListCertificates](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `New-ACMCertificate`
L'exemple de code suivant montre comment utiliser`New-ACMCertificate`.
**Outils pour PowerShell V5**
**Exemple 1 : crée un nouveau certificat. Le service renvoie l’ARN du nouveau certificat.**
```
New-ACMCertificate -DomainName "www.example.com"
```
**Sortie** :
```
arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012
```
**Exemple 2 : crée un nouveau certificat. Le service renvoie l’ARN du nouveau certificat.**
```
New-ACMCertificate -DomainName "www.example.com" -SubjectAlternativeName "example.com","www.example.net"
```
**Sortie** :
```
arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012
```
+ Pour plus de détails sur l'API, reportez-vous [RequestCertificate](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-ACMCertificate`
L'exemple de code suivant montre comment utiliser`Remove-ACMCertificate`.
**Outils pour PowerShell V5**
**Exemple 1 : supprime le certificat identifié par l’ARN fourni et la clé privée associée. L’applet de commande vous invite à confirmer avant de poursuivre ; ajoutez le commutateur -Force pour supprimer la confirmation.**
```
Remove-ACMCertificate -CertificateArn "arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012"
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteCertificate](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Send-ACMValidationEmail`
L'exemple de code suivant montre comment utiliser`Send-ACMValidationEmail`.
**Outils pour PowerShell V5**
**Exemple 1 : demande que l’e-mail de validation de la propriété du domaine pour « www.exemple.com » soit envoyé. Si le \$1 de votre shell ConfirmPreference est défini sur « Moyen » ou inférieur, l'applet de commande vous demandera une confirmation avant de continuer. Ajoutez le commutateur -Force pour supprimer les invites de confirmation.**
```
$params = @{
CertificateArn="arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012"
Domain="www.example.com"
ValidationDomain="example.com"
}
Send-ACMValidationEmail @params
```
+ Pour plus de détails sur l'API, reportez-vous [ResendValidationEmail](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.