ACMBeispiele zur Verwendung von Tools für PowerShell - AWS SDKCode-Beispiele
Aktionen

Weitere AWS SDK Beispiele sind im Repo AWS Doc SDK Examples GitHub verfügbar.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

ACMBeispiele zur Verwendung von Tools für PowerShell

Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Tools for PowerShell with Aktionen ausführen und allgemeine Szenarien implementierenACM.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Aktionen zeigen Ihnen zwar, wie Sie einzelne Servicefunktionen aufrufen, aber Sie können Aktionen im Kontext der zugehörigen Szenarien sehen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, in dem Sie Anweisungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt die VerwendungGet-ACMCertificate.

Tools für PowerShell

Beispiel 1: Dieses Beispiel zeigt, wie ein Zertifikat und seine Kette anhand ARN des Zertifikats zurückgegeben werden.

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

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Get-ACMCertificateDetail

Tools für PowerShell

Beispiel 1: Gibt Details des angegebenen Zertifikats zurück.

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

Ausgabe:

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}

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Get-ACMCertificateList

Tools für PowerShell

Beispiel 1: Ruft eine Liste aller Ihrer Zertifikate ARNs und deren Domainnamen ab. Das Cmdlet paginiert automatisch, um alle abzurufen. ARNs Um die Paginierung manuell zu steuern, verwenden Sie den MaxItem Parameter -, um zu steuern, wie viele Zertifikate für jeden Serviceaufruf zurückgegeben ARNs werden, und den NextToken Parameter -, um den Startpunkt für jeden Aufruf anzugeben.

Get-ACMCertificateList

Ausgabe:

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

Beispiel 2: Ruft eine Liste all Ihrer Zertifikate abARNs, deren Zertifikatsstatus den angegebenen Status entspricht.

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

Beispiel 3: Dieses Beispiel gibt eine Liste aller Zertifikate in der Region us-east-1 zurück, die den Schlüsseltyp RSA _2048 und die erweiterte Schlüsselverwendung oder den Zweck von _ haben. CODE SIGNING Die Werte für diese Filterparameter finden Sie im API Referenzthema ListCertificates Filter: _Filters.html. https://docs.aws.amazon.com/acm/ latest/APIReference/API

Get-ACMCertificateList -Region us-east-1 -Includes_KeyType RSA_2048 -Includes_ExtendedKeyUsage CODE_SIGNING

Ausgabe:

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

Das folgende Codebeispiel zeigt, wie Sie es verwenden. New-ACMCertificate

Tools für PowerShell

Beispiel 1: Erstellt ein neues Zertifikat. Der Dienst gibt das ARN des neuen Zertifikats zurück.

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

Ausgabe:

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

Beispiel 2: Erstellt ein neues Zertifikat. Der Dienst gibt das ARN des neuen Zertifikats zurück.

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

Ausgabe:

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

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Remove-ACMCertificate

Tools für PowerShell

Beispiel 1: Löscht das Zertifikat, das durch den angegebenen ARN und den zugehörigen privaten Schlüssel identifiziert wurde. Das Cmdlet fordert Sie zur Bestätigung auf, bevor Sie fortfahren. Fügen Sie die Option -Force hinzu, um die Bestätigung zu unterdrücken.

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

  • APIEinzelheiten finden Sie unter DeleteCertificateCmdlet-Referenz.AWS Tools for PowerShell

Das folgende Codebeispiel zeigt, wie Sie es verwenden. Send-ACMValidationEmail

Tools für PowerShell

Beispiel 1: Fordert an, dass die E-Mail zur Bestätigung des Domainbesitzes für „www.example.com“ gesendet wird. Wenn $ in Ihrer Shell auf „Mittel“ oder niedriger gesetzt ConfirmPreference ist, fordert das Cmdlet vor dem Fortfahren zur Bestätigung auf. Fügen Sie die Option -Force hinzu, um Bestätigungsaufforderungen zu unterdrücken.

$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