Exemplos do ACM usando as ferramentas para PowerShell V4 - Exemplos de código do AWS SDK
Ações

Há mais exemplos do AWS SDK disponíveis no repositório do GitHub Documento de Exemplos do AWS SDK.

Exemplos do ACM usando as ferramentas para 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: 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"

  • Consulte detalhes da API em 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}

  • Consulte detalhes da API em 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 todos os ARNs de certificado e o nome de domínio de cada. O cmdlet fará a paginação automaticamente para recuperar todos os ARNs. Para controlar manualmente a paginação, use o parâmetro -MaxItem para controlar quantos ARNs de certificado devem ser retornados 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 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_2048 e um uso estendido da chave, ou uma finalidade, de CODE_SIGNING. Os valores desses parâmetros de filtragem estão disponíveis no tópico de referência da API ListCertificates Filters: http://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

  • Consulte detalhes da API em 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 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

  • Consulte detalhes da API em 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 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"

  • Consulte detalhes da API em 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 para validar a propriedade do domínio para “www.example.com” seja enviado. Se $ConfirmPreference do shell estiver definido como '”Médio” ou menos, 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

  • Consulte detalhes da API em ResendValidationEmail na Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).