使用 Tools forWord 的 ACM PowerShell 範例 - AWS SDK 程式碼範例
動作

文件 AWS SDK AWS 範例 SDK 儲存庫中有更多可用的 GitHub 範例。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 Tools forWord 的 ACM PowerShell 範例

下列程式碼範例示範如何使用 AWS Tools for PowerShell 搭配 ACM 來執行動作和實作常見案例。

Actions 是大型程式的程式碼摘錄，必須在內容中執行。雖然 動作會示範如何呼叫個別服務函數，但您可以在其相關案例中查看內容中的動作。

每個範例都包含完整原始程式碼的連結，您可以在其中找到如何在內容中設定和執行程式碼的指示。

主題

動作

下列程式碼範例示範如何使用 Get-ACMCertificate。

for PowerShell 工具

範例 1：此範例示範如何使用憑證的 ARN 傳回憑證及其鏈。

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

  • 如需 API 詳細資訊，請參閱 AWS Tools for PowerShell Cmdlet 參考中的 GetCertificate。

下列程式碼範例示範如何使用 Get-ACMCertificateDetail。

for PowerShell 工具

範例 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 參考中的 DescribeCertificate。

下列程式碼範例示範如何使用 Get-ACMCertificateList。

for PowerShell 工具

範例 1：擷取所有憑證 ARNs 的清單，以及每個憑證的網域名稱。cmdlet 會自動分頁以擷取所有 ARNs。若要手動控制分頁，請使用 -MaxItem 參數來控制每次服務呼叫傳回多少憑證 ARNs，並使用 -NextToken 參數來指示每次呼叫的起點。

Get-ACMCertificateList

輸出：

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

範例 2：擷取憑證狀態符合所提供狀態的所有憑證 ARNs 清單。

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

範例 3：此範例會傳回 us-east-1 區域中具有 RSA_2048 金鑰類型和 CODE_SIGNING 擴充金鑰用量或用途的所有憑證清單。您可以在 ListCertificates Filters API 參考主題： https://docs.aws.amazon.com/acm/latest/APIReference/APIWord_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 參考中的 ListCertificates。

下列程式碼範例示範如何使用 New-ACMCertificate。

for PowerShell 工具

範例 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 參考中的 RequestCertificate。

下列程式碼範例示範如何使用 Remove-ACMCertificate。

for PowerShell 工具

範例 1：刪除由提供的 ARN 和相關聯的私有金鑰所識別的憑證。cmdlet 會先提示確認再繼續；新增 -強制開關以隱藏確認。

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

  • 如需 API 詳細資訊，請參閱 AWS Tools for PowerShell Cmdlet 參考中的 DeleteCertificate。

下列程式碼範例示範如何使用 Send-ACMValidationEmail。

for PowerShell 工具

範例 1：請求傳送電子郵件以驗證 'www.example.com' 的網域擁有權。如果 Shell 的 $ConfirmPreference 設定為「中」或更低，則 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 參考中的 ResendValidationEmail。