ACMexemplos usando ferramentas para PowerShell - AWS SDKExemplos de código
Ações

Há mais AWS SDK exemplos disponíveis no GitHub repositório AWS Doc SDK Examples.

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á.

ACMexemplos usando ferramentas para PowerShell

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Tools for PowerShell withACM.

Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar funções de serviço individuais, é possível ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, onde você pode encontrar instruções sobre como configurar e executar o código no contexto.

Tópicos

Ações

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

Ferramentas para PowerShell

Exemplo 1: Este 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 API obter detalhes, consulte GetCertificateem Referência de AWS Tools for PowerShell cmdlet.

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

Ferramentas para PowerShell

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 API obter detalhes, consulte DescribeCertificateem Referência de AWS Tools for PowerShell cmdlet.

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

Ferramentas para PowerShell

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: Este exemplo retorna uma lista de todos os certificados na região us-east-1 que têm um tipo de chave RSA de _2048 e um uso estendido de chave, ou finalidade, de _. CODE SIGNING Você pode encontrar os valores desses parâmetros de filtragem no tópico de API referência ListCertificates Filtros: 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 API obter detalhes, consulte ListCertificatesem Referência de AWS Tools for PowerShell cmdlet.

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

Ferramentas para PowerShell

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 API obter detalhes, consulte RequestCertificateem Referência de AWS Tools for PowerShell cmdlet.

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

Ferramentas para PowerShell

Exemplo 1: Exclui o certificado identificado pela chave privada fornecida ARN e pela chave privada associada. O cmdlet solicitará a confirmação antes de continuar; 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 API obter detalhes, consulte DeleteCertificateem Referência de AWS Tools for PowerShell cmdlet.

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

Ferramentas para PowerShell

Exemplo 1: Solicita que o e-mail para validar a propriedade do domínio para 'www.example.com' seja enviado. Se o $ 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 suprimir 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 API obter detalhes, consulte ResendValidationEmailem Referência de AWS Tools for PowerShell cmdlet.