使用 Tools for PowerShell V4 的 ACM 示例 - AWS Tools for PowerShell（版本 4）
操作

AWS Tools for PowerShell 版本 5（V5）已经发布！

要开始使用新版本的工具，请参阅《AWS Tools for PowerShell 用户指南（V5）》，特别是关于迁移到 V5 的主题。

使用 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 参考（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 参考（V4）》中的 DescribeCertificate。

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

Tools for PowerShell V4

示例 1：检索您所有证书 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 参考（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 参考（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 参考（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 参考（V4）》中的 ResendValidationEmail。