Ejemplos de ACM con Herramientas para PowerShell V5 - Ejemplos de código de AWS SDK
Acciones

Hay más ejemplos de AWS SDK disponibles en el repositorio de GitHub de ejemplos de AWS SDK de documentos.

Ejemplos de ACM con Herramientas para PowerShell V5

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes usando Herramientas de AWS para PowerShell V5 con ACM.

Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

Acciones

En el siguiente ejemplo de código, se muestra cómo utilizar Get-ACMCertificate.

Herramientas para PowerShell V5

Ejemplo 1: En este ejemplo se muestra cómo devolver un certificado y su cadena mediante el ARN del certificado.

Get-ACMCertificate -CertificateArn "arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012"

  • Para obtener información sobre la API, consulte GetCertificate en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V5).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-ACMCertificateDetail.

Herramientas para PowerShell V5

Ejemplo 1: Devuelve información detallada del certificado especificado.

Get-ACMCertificateDetail -CertificateArn "arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012"

Salida:

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 obtener información sobre la API, consulte DescribeCertificate en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V5).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-ACMCertificateList.

Herramientas para PowerShell V5

Ejemplo 1: Recupera una lista de todos los ARN de certificados y el nombre de dominio de cada uno. El cmdlet paginará automáticamente para recuperar todos los ARN. Para controlar manualmente la paginación, utilice el parámetro -MaxItem para controlar cuántos ARN de certificado se devuelven para cada llamada de servicio y el parámetro -NextToken para indicar el punto de inicio de cada llamada.

Get-ACMCertificateList

Salida:

CertificateArn                                                                      DomainName
--------------                                                                      ----------
arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012 www.example.com

Ejemplo 2: Recupera una lista de todos los ARN de certificado en los que el estado del certificado coincide con los estados proporcionados.

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

Ejemplo 3: Este ejemplo devuelve una lista de todos los certificados de la región us-east-1 que tienen el tipo de clave RSA_2048 y el uso o propósito de clave extendido CODE_SIGNING. Puede encontrar los valores de estos parámetros de filtrado en el tema de referencia de la 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

Salida:

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 obtener información sobre la API, consulte ListCertificates en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V5).

En el siguiente ejemplo de código, se muestra cómo utilizar New-ACMCertificate.

Herramientas para PowerShell V5

Ejemplo 1: Crea un certificado nuevo. El servicio devuelve el ARN del nuevo certificado.

New-ACMCertificate -DomainName "www.example.com"

Salida:

arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012

Ejemplo 2: Crea un certificado nuevo. El servicio devuelve el ARN del nuevo certificado.

New-ACMCertificate -DomainName "www.example.com" -SubjectAlternativeName "example.com","www.example.net"

Salida:

arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012

  • Para obtener información sobre la API, consulte RequestCertificate en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V5).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-ACMCertificate.

Herramientas para PowerShell V5

Ejemplo 1: Elimina el certificado identificado por el ARN y la clave privada asociada proporcionados. El cmdlet pedirá confirmación antes de continuar con la operación; para suprimir la confirmación, utilice el modificador -Force.

Remove-ACMCertificate -CertificateArn "arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012"

  • Para obtener información sobre la API, consulte DeleteCertificate en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V5).

En el siguiente ejemplo de código, se muestra cómo utilizar Send-ACMValidationEmail.

Herramientas para PowerShell V5

Ejemplo 1: Solicita que se envíe el correo electrónico para validar la propiedad del dominio de “www.example.com”. Si $ConfirmPreference en el intérprete de comandos está establecido en “Medium” o en un valor inferior, el cmdlet solicitará la confirmación antes de continuar. Añada el modificador -Force para suprimir la solicitud de confirmación.

$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 obtener información sobre la API, consulte ResendValidationEmail en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V5).