Esempi ACM che utilizzano Tools for V4 PowerShell - AWS Strumenti per PowerShell (versione 4)
Operazioni

È stata rilasciata la versione 5 (V5) di! AWS Strumenti per PowerShell

Per iniziare a utilizzare la nuova versione degli strumenti, consulta la Guida per l'AWS Strumenti per PowerShell utente (V5), in particolare l'argomento per la migrazione alla V5.

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 V4 PowerShell

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

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

Ogni esempio include un collegamento al codice sorgente completo, in cui è possibile trovare istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Operazioni

Il seguente esempio di codice mostra come utilizzareGet-ACMCertificate.

Strumenti per PowerShell V4

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 GetCertificatein AWS Strumenti per PowerShell Cmdlet Reference (V4).

Il seguente esempio di codice mostra come utilizzare. Get-ACMCertificateDetail

Strumenti per PowerShell V4

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 DescribeCertificatein AWS Strumenti per PowerShell Cmdlet Reference (V4).

Il seguente esempio di codice mostra come utilizzare. Get-ACMCertificateList

Strumenti per PowerShell V4

Esempio 1: recupera un elenco di tutti i certificati ARNs e il nome di dominio per ciascuno. Il cmdlet verrà impaginato automaticamente per recuperare tutti i. ARNs Per controllare manualmente l'impaginazione, utilizzare il MaxItem parametro - per controllare il numero di certificati ARNs restituiti per ogni chiamata di servizio e il NextToken parametro - per indicare il punto di partenza per 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 i certificati ARNs in cui lo stato del certificato corrisponde a quello degli 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 un utilizzo o scopo esteso della chiave di CODE_SIGNING. È possibile trovare i valori per questi parametri di filtro nell'argomento di riferimento dell'API Filters: _Filters.html. ListCertificates https://docs.aws.amazon.com/acm/ latest/APIReference/API

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, vedere ListCertificatesin AWS Strumenti per PowerShell Cmdlet Reference (V4).

Il seguente esempio di codice mostra come utilizzare. New-ACMCertificate

Strumenti per PowerShell V4

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 RequestCertificatein AWS Strumenti per PowerShell Cmdlet Reference (V4).

Il seguente esempio di codice mostra come utilizzare. Remove-ACMCertificate

Strumenti per PowerShell V4

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

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

  • Per i dettagli sull'API, vedere DeleteCertificatein Cmdlet Reference (V4).AWS Strumenti per PowerShell

Il seguente esempio di codice mostra come utilizzare. Send-ACMValidationEmail

Strumenti per PowerShell V4

Esempio 1: richiede l'invio dell'e-mail per convalidare la proprietà del dominio per «www.example.com». Se il valore $ della shell ConfirmPreference è impostato su 'Medium' o inferiore, il cmdlet richiederà una conferma prima di procedere. Aggiungi l'opzione -Force per sopprimere 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 i dettagli sull'API, vedere ResendValidationEmailin AWS Strumenti per PowerShell Cmdlet Reference (V4).