View a markdown version of this page

Esempi ACM che utilizzano Tools for V5 PowerShell - AWS Esempi di codice SDK
Azioni

Sono disponibili altri esempi di AWS SDK nel repository AWS Doc SDK Examples. GitHub

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Esempi ACM che utilizzano Tools for V5 PowerShell

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Strumenti per PowerShell V5 con ACM.

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

L’esempio di codice seguente mostra come utilizzare Get-ACMCertificate.

Strumenti per V5 PowerShell

Esempio 1: questo esempio mostra come restituire un certificato e la relativa catena utilizzando l’ARN del certificato.

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

  • Per i dettagli sull'API, vedere GetCertificate in AWS Strumenti per PowerShell Cmdlet Reference (V5).

L’esempio di codice seguente mostra come utilizzare Get-ACMCertificateDetail.

Strumenti per V5 PowerShell

Esempio 1: restituisce i dettagli del certificato specificato.

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

Output:

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}

  • Per i dettagli sull'API, vedere DescribeCertificate in AWS Strumenti per PowerShell Cmdlet Reference (V5).

L’esempio di codice seguente mostra come utilizzare Get-ACMCertificateList.

Strumenti per V5 PowerShell

Esempio 1: recupera un elenco di ARN dei certificati e il relativo nome di dominio. Il cmdlet effettuerà automaticamente l’impaginazione per recuperare tutti gli ARN. Per controllare manualmente l'impaginazione, utilizzate il MaxItem parametro - per controllare quanti ARN di certificati vengono restituiti per ogni chiamata di servizio e il NextToken parametro - per indicare il punto di partenza di ogni chiamata. 

Get-ACMCertificateList

Output:

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

Esempio 2: recupera un elenco di tutti gli ARN dei certificati il cui stato corrisponde agli stati forniti.

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

Esempio 3: questo esempio restituisce un elenco di tutti i certificati nella Regione us-east-1 con un tipo di chiave RSA_2048 e l’utilizzo o scopo esteso CODE_SIGNING della chiave. Puoi trovare i valori per questi parametri di filtro nell'argomento di riferimento dell'API ListCertificates Filters: 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

Output:

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

  • Per i dettagli sull'API, consulta ListCertificates AWS Strumenti per PowerShell Cmdlet Reference (V5).

L’esempio di codice seguente mostra come utilizzare New-ACMCertificate.

Strumenti per V5 PowerShell

Esempio 1: crea un nuovo certificato. Il servizio restituisce l’ARN del nuovo certificato.

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

Output:

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

Esempio 2: crea un nuovo certificato. Il servizio restituisce l’ARN del nuovo certificato.

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

Output:

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

  • Per i dettagli sull'API, vedere RequestCertificate in AWS Strumenti per PowerShell Cmdlet Reference (V5).

L’esempio di codice seguente mostra come utilizzare Remove-ACMCertificate.

Strumenti per V5 PowerShell

Esempio 1: elimina il certificato identificato dall’ARN fornito e dalla chiave privata associata. Il cmdlet richiederà una conferma prima di procedere; aggiungi l’opzione -Force per disabilitare la conferma.

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

  • Per i dettagli sull'API, vedere DeleteCertificate in AWS Strumenti per PowerShell Cmdlet Reference (V5).

L’esempio di codice seguente mostra come utilizzare Send-ACMValidationEmail.

Strumenti per V5 PowerShell

Esempio 1: richiede l’invio dell’e-mail per convalidare la proprietà del dominio per “www.example.com”. Se $ della shell ConfirmPreference è impostato su «Medio» o su un valore inferiore, il cmdlet richiederà una conferma prima di procedere. Aggiungi l’opzione -Force per disattivare le richieste di conferma.

$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

  • Per informazioni dettagliate sull'API, vedere ResendValidationEmail in AWS Strumenti per PowerShell Cmdlet Reference (V5).