支援 使用 Tools for PowerShell V4 的範例 - AWS Tools for PowerShell （第 4 版）
動作

第 5 版 (V5) AWS Tools for PowerShell 已發行！

若要開始使用新版本的工具，請參閱 AWS Tools for PowerShell 使用者指南 (V5)，特別是遷移至 V5 的主題。

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

支援 使用 Tools for PowerShell V4 的範例

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

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

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

主題

動作

以下程式碼範例顯示如何使用 Add-ASACommunicationToCase。

Tools for PowerShell V4

範例 1：將電子郵件通訊的內文新增至指定的案例。

Add-ASACommunicationToCase -CaseId "case-12345678910-2013-c4c1d2bf33c5cf47" -CommunicationBody "Some text about the case"

範例 2：將電子郵件通訊的內文新增至指定的案例，再加上電子郵件副本行中包含的一或多個電子郵件地址。

Add-ASACommunicationToCase -CaseId "case-12345678910-2013-c4c1d2bf33c5cf47" -CcEmailAddress @("email1@address.com", "email2@address.com") -CommunicationBody "Some text about the case"

  • 如需 API 詳細資訊，請參閱《AWS Tools for PowerShell Cmdlet 參考 (V4)》中的 AddCommunicationToCase。

以下程式碼範例顯示如何使用 Get-ASACase。

Tools for PowerShell V4

範例 1：傳回所有支援案例的詳細資訊。

Get-ASACase

範例 2：傳回自指定日期和時間以來，所有支援案例的詳細資訊。

Get-ASACase -AfterTime "2013-09-10T03:06Z"

範例 3：傳回前 10 個支援案例的詳細資訊，包括已解決的案例。

Get-ASACase -MaxResult 10 -IncludeResolvedCases $true

範例 4：傳回單一指定之支援案例的詳細資訊。

Get-ASACase -CaseIdList "case-12345678910-2013-c4c1d2bf33c5cf47"

範例 5：傳回指定之支援案例的詳細資訊。

Get-ASACase -CaseIdList @("case-12345678910-2013-c4c1d2bf33c5cf47", "case-18929034710-2011-c4fdeabf33c5cf47")

  • 如需 API 詳細資訊，請參閱《AWS Tools for PowerShell Cmdlet 參考 (V4)》中的 DescribeCases。

以下程式碼範例顯示如何使用 Get-ASACommunication。

Tools for PowerShell V4

範例 1：傳回指定案例的所有通訊。

Get-ASACommunication -CaseId "case-12345678910-2013-c4c1d2bf33c5cf47"

範例 2：針對指定的案例，傳回自 2012 年 1 月 1 日 UTC 午夜以來的所有通訊。

Get-ASACommunication -CaseId "case-12345678910-2013-c4c1d2bf33c5cf47" -AfterTime "2012-01-10T00:00Z"

  • 如需 API 詳細資訊，請參閱《AWS Tools for PowerShell Cmdlet 參考 (V4)》中的 DescribeCommunications。

以下程式碼範例顯示如何使用 Get-ASAService。

Tools for PowerShell V4

範例 1：傳回所有可用的服務代碼、名稱和類別。

Get-ASAService

範例 2：使用指定的代碼，傳回服務的名稱和類別。

Get-ASAService -ServiceCodeList "amazon-cloudfront"

範例 3：傳回指定服務代碼的名稱和類別。

Get-ASAService -ServiceCodeList @("amazon-cloudfront", "amazon-cloudwatch")

範例 4：傳回指定服務代碼的名稱和類別 (日文)。目前支援英文 ("en") 和日文 ("ja") 語言代碼。

Get-ASAService -ServiceCodeList @("amazon-cloudfront", "amazon-cloudwatch") -Language "ja"

  • 如需 API 詳細資訊，請參閱《AWS Tools for PowerShell Cmdlet 參考 (V4)》中的 DescribeServices。

以下程式碼範例顯示如何使用 Get-ASASeverityLevel。

Tools for PowerShell V4

範例 1：傳回可指派給 AWS 支援案例的嚴重性等級清單。

Get-ASASeverityLevel

範例 2：傳回可指派給 AWS 支援案例的嚴重性等級清單。層級名稱以日文傳回。

Get-ASASeverityLevel -Language "ja"

  • 如需 API 詳細資訊，請參閱《AWS Tools for PowerShell Cmdlet 參考 (V4)》中的 DescribeSeverityLevels。

以下程式碼範例顯示如何使用 Get-ASATrustedAdvisorCheck。

Tools for PowerShell V4

範例 1：傳回 Trusted Advisor 檢查的集合。您必須指定語言參數，其可接受英文輸出 "en"，或日文輸出 "ja"。

Get-ASATrustedAdvisorCheck -Language "en"

以下程式碼範例顯示如何使用 Get-ASATrustedAdvisorCheckRefreshStatus。

Tools for PowerShell V4

範例 1：傳回指定之檢查的重新整理請求的目前狀態。Request-ASATrustedAdvisorCheckRefresh 可用來請求重新整理檢查的狀態資訊。

Get-ASATrustedAdvisorCheckRefreshStatus -CheckId @("checkid1", "checkid2")

以下程式碼範例顯示如何使用 Get-ASATrustedAdvisorCheckResult。

Tools for PowerShell V4

範例 1：傳回 Trusted Advisor 檢查的結果。可使用 Get-ASATrustedAdvisorChecks 取得可用的 Trusted Advisor 檢查清單。輸出是檢查的整體狀態、上次執行檢查的時間戳記，以及特定檢查的唯一 checkid。若要以日文顯示輸出結果，可新增 -Language "ja" 參數。

Get-ASATrustedAdvisorCheckResult -CheckId "checkid1"

以下程式碼範例顯示如何使用 Get-ASATrustedAdvisorCheckSummary。

Tools for PowerShell V4

範例 1：傳回指定之 Trusted Advisor 檢查的最新摘要。

Get-ASATrustedAdvisorCheckSummary -CheckId "checkid1"

範例 2：傳回指定之 Trusted Advisor 檢查的最新摘要。

Get-ASATrustedAdvisorCheckSummary -CheckId @("checkid1", "checkid2")

以下程式碼範例顯示如何使用 New-ASACase。

Tools for PowerShell V4

範例 1：在 AWS 支援中心建立新案例。可使用 Get-ASAService cmdlet 取得 -ServiceCode 和 -CategoryCode 參數的值。可使用 Get-ASASeverityLevel cmdlet 取得 -SeverityCode 參數的值。-IssueType 參數值可以是 "customer-service" 或 "technical"。如果成功，則會輸出 AWS 支援案例編號。預設以英文處理案例，若要使用日文，則需新增 -Language "ja" 參數。-ServiceCode、-CategoryCode、-Subject 和 -CommunicationBody 參數是強制性的。

New-ASACase -ServiceCode "amazon-cloudfront" -CategoryCode "APIs" -SeverityCode "low" -Subject "subject text" -CommunicationBody "description of the case" -CcEmailAddress @("email1@domain.com", "email2@domain.com") -IssueType "technical"

  • 如需 API 詳細資訊，請參閱《AWS Tools for PowerShell Cmdlet 參考 (V4)》中的 CreateCase。

以下程式碼範例顯示如何使用 Request-ASATrustedAdvisorCheckRefresh。

Tools for PowerShell V4

範例 1：請求重新整理指定的 Trusted Advisor 檢查。

Request-ASATrustedAdvisorCheckRefresh -CheckId "checkid1"

以下程式碼範例顯示如何使用 Resolve-ASACase。

Tools for PowerShell V4

範例 1：傳回指定案例的初始狀態，以及呼叫解決案例完成後的目前狀態。

Resolve-ASACase -CaseId "case-12345678910-2013-c4c1d2bf33c5cf47"

  • 如需 API 詳細資訊，請參閱《AWS Tools for PowerShell Cmdlet 參考 (V4)》中的 ResolveCase。