使用 Tools for PowerShell V4 的 ACM 示例 - AWS SDK 代码示例
操作

AWS 文档 SDK 示例 GitHub 存储库中还有更多 AWS SDK 示例。

使用 Tools for PowerShell V4 的 ACM 示例

以下代码示例演示如何通过将 AWS Tools for PowerShell V4 与 ACM 结合使用，来执行操作和实现常见场景。

操作是大型程序的代码摘录，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景的上下文查看操作。

每个示例都包含一个指向完整源代码的链接，您可以从中找到有关如何在上下文中设置和运行代码的说明。

主题

操作

以下代码示例演示如何使用 Get-ACMCertificate。

Tools for PowerShell V4

示例 1：此示例演示如何使用证书的 ARN 返回证书及其链。

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

  • 有关 API 详细信息，请参阅《AWS Tools for PowerShell Cmdlet Reference (V4)》中的 GetCertificate。

以下代码示例演示如何使用 Get-ACMCertificateDetail。

Tools for PowerShell V4

示例 1：返回指定证书的详细信息。

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

输出：

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}

  • 有关 API 详细信息，请参阅《AWS Tools for PowerShell Cmdlet Reference (V4)》中的 DescribeCertificate。

以下代码示例演示如何使用 Get-ACMCertificateList。

Tools for PowerShell V4

示例 1：检索所有证书 ARN 以及每个 ARN 的域名列表。cmdlet 将自动进行分页以检索所有 ARN。要手动控制分页，请使用 -MaxItem 参数来控制每次服务调用返回多少个证书 ARN，并使用 -NextToken 参数来指示每次调用的起点。

Get-ACMCertificateList

输出：

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

示例 2：检索所有证书 ARN 的列表，其中证书状态与提供的状态相匹配。

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

示例 3：此示例返回 us-east-1 区域中密钥类型为 RSA_2048 且扩展密钥用法或用途为 CODE_SIGNING 的所有证书的列表。可以在 ListCertificates 筛选条件 API 参考主题中找到这些筛选参数的值：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

输出：

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

  • 有关 API 详细信息，请参阅《AWS Tools for PowerShell Cmdlet Reference (V4)》中的 ListCertificates。

以下代码示例演示如何使用 New-ACMCertificate。

Tools for PowerShell V4

示例 1：创建新证书。该服务返回新证书的 ARN。

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

输出：

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

示例 2：创建新证书。该服务返回新证书的 ARN。

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

输出：

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

  • 有关 API 详细信息，请参阅《AWS Tools for PowerShell Cmdlet Reference (V4)》中的 RequestCertificate。

以下代码示例演示如何使用 Remove-ACMCertificate。

Tools for PowerShell V4

示例 1：删除由提供的 ARN 和关联的私有密钥标识的证书。在继续操作之前，cmdlet 将提示您进行确认；添加 -Force 开关可禁止确认。

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

  • 有关 API 详细信息，请参阅《AWS Tools for PowerShell Cmdlet Reference (V4)》中的 DeleteCertificate。

以下代码示例演示如何使用 Send-ACMValidationEmail。

Tools for PowerShell V4

示例 1：请求发送用于验证“www.example.com”的域所有权的电子邮件。如果 Shell 的 $ConfirmPreference 设置为“Medium”或更低，则 cmdlet 将在继续操作之前提示您进行确认。添加 -Force 开关可禁止确认提示。

$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

  • 有关 API 详细信息，请参阅《AWS Tools for PowerShell Cmdlet Reference (V4)》中的 ResendValidationEmail。