Exemplos do ACM que usam o Tools for PowerShell V4 - Ferramentas da AWS para PowerShell (versão 4)
Ações

A versão 5 (V5) do Ferramentas da AWS para PowerShell foi lançada!

Para começar a usar a nova versão do SDK, consulte o Guia do usuário do Ferramentas da AWS para PowerShell (V5), especialmente o tópico Migração para V5.

Exemplos do ACM que usam o Tools for PowerShell V4

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o Ferramentas da AWS para PowerShell V4 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.

Tópicos

Ações

O código de exemplo a seguir mostra como usar Get-ACMCertificate.

Ferramentas para PowerShell V4

Exemplo 1: este exemplo mostra como retornar um certificado e a 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 na Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Get-ACMCertificateDetail.

Ferramentas para PowerShell V4

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 na Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Get-ACMCertificateList.

Ferramentas para PowerShell V4

Exemplo 1: recupera uma lista de todos os ARNs de certificado e o nome de domínio de cada ARN. O cmdlet será paginado automaticamente para recuperar todos os ARNs. Para controlar manualmente a paginação, use o parâmetro -MaxItem para controlar quantos ARNs de certificado retornam para cada chamada de serviço e o parâmetro -NextToken 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 ARNs do certificado em que o status do certificado corresponde aos estados fornecidos.

Get-ACMCertificateList -CertificateStatus "VALIDATION_TIMED_OUT","FAILED"

Exemplo 3: este exemplo retorna uma lista de todos os certificados na região us-east-1 que tenham um tipo de chave RSA_2048 e um uso de chave estendido, ou finalidade, de CODE_SIGNING. Você pode encontrar os valores desses parâmetros de filtragem no tópico de referência da API de filtros ListCertificates: https://docs.aws.amazon.com/acm/latest/APIReference/API_Filters.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 na Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar New-ACMCertificate.

Ferramentas para PowerShell V4

Exemplo 1: cria um novo 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 novo 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 na Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Remove-ACMCertificate.

Ferramentas para PowerShell V4

Exemplo 1: exclui o certificado identificado pelo ARN fornecido e pela chave privada associada. O cmdlet enviará um prompt de confirmação antes que a operação continue. Adicione a opção -Force para suprimir 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 na Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).

O código de exemplo a seguir mostra como usar Send-ACMValidationEmail.

Ferramentas para PowerShell V4

Exemplo 1: solicita que o e-mail de validação da propriedade do domínio de “www.example.com” seja enviado. Se o $ConfirmPreference do shell estiver definido como “Medium” ou inferior, o cmdlet enviará um prompt de confirmação antes de continuar. Adicione a opção -Force para suprimir os prompts 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 na Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).