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

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

如需有關中斷變更和遷移應用程式的資訊，請參閱遷移主題。

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

支援 使用 Tools for PowerShell V5 的範例

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

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

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

主題

動作

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

PowerShell V5 的工具

範例 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 (V5)》中的 AddCommunicationToCase。

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

PowerShell V5 的工具

範例 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 參考 (V5) 中的 DescribeCases。

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

PowerShell V5 的工具

範例 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 Reference (V5) 中的 DescribeCommunications。

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

PowerShell V5 的工具

範例 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 參考 (V5) 中的 DescribeServices。

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

PowerShell V5 的工具

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

Get-ASASeverityLevel

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

Get-ASASeverityLevel -Language "ja"

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

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

PowerShell V5 的工具

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

Get-ASATrustedAdvisorCheck -Language "en"

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

PowerShell V5 的工具

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

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

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

PowerShell V5 的工具

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

Get-ASATrustedAdvisorCheckResult -CheckId "checkid1"

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

PowerShell V5 的工具

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

Get-ASATrustedAdvisorCheckSummary -CheckId "checkid1"

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

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

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

PowerShell V5 的工具

範例 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 (V5) 中的 CreateCase。

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

PowerShell V5 的工具

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

Request-ASATrustedAdvisorCheckRefresh -CheckId "checkid1"

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

PowerShell V5 的工具

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

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

  • 如需 API 詳細資訊，請參閱 AWS Tools for PowerShell Cmdlet Reference (V5) 中的 ResolveCase。