Esempi ACM che utilizzano Tools for V5 PowerShell - AWS Strumenti per PowerShell (versione 5)
Azioni

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

Per informazioni sulle modifiche introduttive e sulla migrazione delle applicazioni, consulta l'argomento sulla migrazione.

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

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

Strumenti per PowerShell V5

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 (V5).

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

Strumenti per PowerShell V5

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 (V5).

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

Strumenti per PowerShell V5

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 l’utilizzo o scopo esteso CODE_SIGNING della chiave. È possibile 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, vedere ListCertificatesin AWS Strumenti per PowerShell Cmdlet Reference (V5).

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

Strumenti per PowerShell V5

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 (V5).

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

Strumenti per PowerShell V5

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

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

Strumenti per PowerShell V5

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 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 i dettagli sull'API, vedere ResendValidationEmailin AWS Strumenti per PowerShell Cmdlet Reference (V5).