支援 使用 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：將電子郵件通訊的內文新增至指定的案例，以及電子郵件 CC 行中包含的一或多個電子郵件地址。

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 Reference (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 Reference (V4) 中的 DescribeServices。

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

Tools for PowerShell V4

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

Get-ASASeverityLevel

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

Get-ASASeverityLevel -Language "ja"

  • 如需 API 詳細資訊，請參閱AWS Tools for PowerShell 《 Cmdlet Reference (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 檢查清單。 Get-ASATrustedAdvisorChecks 輸出是檢查的整體狀態、上次執行檢查的時間戳記，以及特定檢查的唯一檢查 ID。若要讓結果輸出以日文顯示，請新增 -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 參數的值。-SeverityCode 參數的值可使用 Get-ASASeverityLevel cmdlet 取得。-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 Reference (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 Reference (V4) 中的 ResolveCase。