第 5 版 (V5) AWS Tools for PowerShell 已發行！ 如需有關中斷變更和遷移應用程式的資訊，請參閱[遷移主題](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html)。 [https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html) 本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 使用 Tools for PowerShell V5 的 ACM 範例 下列程式碼範例示範如何使用 AWS Tools for PowerShell V5 搭配 ACM 來執行動作和實作常見案例。 *Actions* 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數，但您可以在其相關情境中查看內容中的動作。 每個範例均包含完整原始碼的連結，您可在連結中找到如何設定和執行內容中程式碼的相關指示。 **Topics** + [動作](#actions) ## 動作 ### `Get-ACMCertificate` 以下程式碼範例顯示如何使用 `Get-ACMCertificate`。 **Tools for PowerShell V5** **範例 1：此範例示範如何使用憑證的 ARN 傳回憑證及其鏈結。** ``` Get-ACMCertificate -CertificateArn "arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012" ``` + 如需 API 詳細資訊，請參閱《AWS Tools for PowerShell Cmdlet 參考 (V5)》**中的 [GetCertificate](https://docs.aws.amazon.com/powershell/v5/reference)。 ### `Get-ACMCertificateDetail` 以下程式碼範例顯示如何使用 `Get-ACMCertificateDetail`。 **Tools for PowerShell V5** **範例 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 參考 (V5)》**中的 [DescribeCertificate](https://docs.aws.amazon.com/powershell/v5/reference)。 ### `Get-ACMCertificateList` 以下程式碼範例顯示如何使用 `Get-ACMCertificateList`。 **Tools for PowerShell V5** **範例 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\$12048 金鑰類型，以及 CODE\$1SIGNING 延伸金鑰使用方式或用途的所有憑證清單。您可以在 ListCertificates Filters API 參考主題中找到這些篩選參數的值：https://docs.aws.amazon.com/acm/latest/APIReference/API\$1Filters.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 參考 (V5)》**中的 [ListCertificates](https://docs.aws.amazon.com/powershell/v5/reference)。 ### `New-ACMCertificate` 以下程式碼範例顯示如何使用 `New-ACMCertificate`。 **Tools for PowerShell V5** **範例 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 參考 (V5)*》中的 [RequestCertificate](https://docs.aws.amazon.com/powershell/v5/reference)。 ### `Remove-ACMCertificate` 以下程式碼範例顯示如何使用 `Remove-ACMCertificate`。 **Tools for PowerShell V5** **範例 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 參考 (V5)* 中的 [DeleteCertificate](https://docs.aws.amazon.com/powershell/v5/reference)。 ### `Send-ACMValidationEmail` 以下程式碼範例顯示如何使用 `Send-ACMValidationEmail`。 **Tools for PowerShell V5** **範例 1：請求傳送電子郵件以驗證 'www.example.com' 的網域擁有權。如果您 Shell 的 \$1ConfirmPreference 設定為 '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 參考 (V5)》**中的 [ResendValidationEmail](https://docs.aws.amazon.com/powershell/v5/reference)。