Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Exemplos de ACM usando o Tools for PowerShell V5
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o Ferramentas da AWS para PowerShell V5 com o ACM.
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
**Topics**
+ [Ações](#actions)
## Ações
### `Get-ACMCertificate`
O código de exemplo a seguir mostra como usar `Get-ACMCertificate`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo mostra como retornar um certificado e sua cadeia usando o ARN do certificado.**
```
Get-ACMCertificate -CertificateArn "arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012"
```
+ Para obter detalhes da API, consulte [GetCertificate](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-ACMCertificateDetail`
O código de exemplo a seguir mostra como usar `Get-ACMCertificateDetail`.
**Ferramentas para PowerShell V5**
**Exemplo 1: retorna detalhes do certificado especificado.**
```
Get-ACMCertificateDetail -CertificateArn "arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012"
```
**Saída**:
```
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}
```
+ Para obter detalhes da API, consulte [DescribeCertificate](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-ACMCertificateList`
O código de exemplo a seguir mostra como usar `Get-ACMCertificateList`.
**Ferramentas para PowerShell V5**
**Exemplo 1: recupera uma lista de todos os seus certificados ARNs e o nome de domínio de cada um. O cmdlet paginará automaticamente para recuperar todos os. ARNs Para controlar manualmente a paginação, use o MaxItem parâmetro - para controlar quantos certificados ARNs são retornados para cada chamada de serviço e o NextToken parâmetro - para indicar o ponto de partida de cada chamada.**
```
Get-ACMCertificateList
```
**Saída**:
```
CertificateArn DomainName
-------------- ----------
arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012 www.example.com
```
**Exemplo 2: Recupera uma lista de todos os seus certificados ARNs em que o status do certificado corresponde aos estados fornecidos.**
```
Get-ACMCertificateList -CertificateStatus "VALIDATION_TIMED_OUT","FAILED"
```
**Exemplo 3: esse exemplo retorna uma lista de todos os certificados na região us-east-1 que têm um tipo de chave RSA\$12048 e um uso estendido da chave, ou uma finalidade, de CODE\$1SIGNING. Você pode encontrar os valores desses parâmetros de filtragem no tópico de referência da API de ListCertificates filtros: 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
```
**Saída**:
```
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
```
+ Para obter detalhes da API, consulte [ListCertificates](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `New-ACMCertificate`
O código de exemplo a seguir mostra como usar `New-ACMCertificate`.
**Ferramentas para PowerShell V5**
**Exemplo 1: cria um certificado. O serviço retorna o ARN do novo certificado.**
```
New-ACMCertificate -DomainName "www.example.com"
```
**Saída**:
```
arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012
```
**Exemplo 2: cria um certificado. O serviço retorna o ARN do novo certificado.**
```
New-ACMCertificate -DomainName "www.example.com" -SubjectAlternativeName "example.com","www.example.net"
```
**Saída**:
```
arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012
```
+ Para obter detalhes da API, consulte [RequestCertificate](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Remove-ACMCertificate`
O código de exemplo a seguir mostra como usar `Remove-ACMCertificate`.
**Ferramentas para PowerShell V5**
**Exemplo 1: exclui o certificado identificado pelo ARN fornecido e pela chave privada associada. O cmdlet solicitará confirmação antes de prosseguir. Adicione a opção -Force para ignorar a confirmação.**
```
Remove-ACMCertificate -CertificateArn "arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012"
```
+ Para obter detalhes da API, consulte [DeleteCertificate](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Send-ACMValidationEmail`
O código de exemplo a seguir mostra como usar `Send-ACMValidationEmail`.
**Ferramentas para PowerShell V5**
**Exemplo 1: solicita que o e-mail para validar a propriedade do domínio para “www.example.com” seja enviado. Se o \$1 do seu shell ConfirmPreference estiver definido como 'Médio' ou inferior, o cmdlet solicitará a confirmação antes de continuar. Adicione a opção -Force para ignorar as solicitações de confirmação.**
```
$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
```
+ Para obter detalhes da API, consulte [ResendValidationEmail](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.