Get-UsageAggregates

取得回報的 Azure 訂用帳戶使用量詳細數據。

警告

自 2024 年 2 月 29 日起,AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組,以確保持續支援和更新。

雖然 AzureRM 模組可能仍可運作,但不再維護或支援它,但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引,請參閱我們的 移轉資源

Syntax

Get-UsageAggregates
   -ReportedStartTime <DateTime>
   -ReportedEndTime <DateTime>
   [-AggregationGranularity <AggregationGranularity>]
   [-ShowDetails <Boolean>]
   [-ContinuationToken <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Get-UsageAggregates Cmdlet 會依下列屬性來匯總 Azure 訂用帳戶使用量數據:

  • 回報使用量的開始和結束時間。
  • 匯總精確度,每天或每小時。
  • 相同資源之多個實例的實例層級詳細數據。 為了取得一致的結果,傳回的數據是根據 Azure 資源報告使用量詳細數據時所依據。 如需詳細資訊,請參閱 Microsoft 開發人員網路連結庫中的 Azure 計費 REST API 參考https://msdn.microsoft.com/library/azure/1ea5b323-54bb-423d-916f-190de96c6a3c (https://msdn.microsoft.com/library/azure/1ea5b323-54bb-423d-916f-190de96c6a3c)。

範例

範例 1:擷取訂用帳戶數據

PS C:\>Get-UsageAggregates -ReportedStartTime "5/2/2015" -ReportedEndTime "5/5/2015"

此命令會擷取 2015 年 5 月 2 日和 5/5/2015 之間訂閱的報告使用量數據。

參數

-AggregationGranularity

指定數據的匯總精確度。 有效值為:每日和每小時。 預設值為每日。

Type:Microsoft.Azure.Commerce.UsageAggregates.Models.AggregationGranularity
Accepted values:Daily, Hourly
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContinuationToken

指定先前呼叫中從響應主體擷取的接續令牌。 對於大型結果集,回應會使用接續令牌來分頁。 接續令牌可作為進度的書籤。 如果您未指定此參數,則會從 ReportedStartTime 中指定的一天或一小時開始擷取數據。 建議您遵循回應頁面中的下一個連結,但數據。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ReportedEndTime

指定在 Azure 計費系統中記錄資源使用量的回報結束時間。 Azure 是一種分散式系統,橫跨世界各地的多個數據中心,因此資源實際耗用的時間、資源使用量時間,以及使用量事件到達計費系統,也就是資源使用量報告時間之間會有延遲。 若要取得一段時間所報告訂閱的所有使用量事件,您可以依報告的時間查詢。 即使您依報告時間查詢,Cmdlet 仍會依資源使用時間匯總響應數據。 資源使用量數據是分析數據的實用樞紐。

Type:DateTime
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ReportedStartTime

指定在 Azure 計費系統中記錄資源使用量的回報開始時間。

Type:DateTime
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ShowDetails

指出此 Cmdlet 是否使用使用量數據傳回實例層級詳細數據。 預設值為 $True。 如果$False,服務會在伺服器端匯總結果,因此會傳回較少的匯總群組。 例如,如果您執行三個網站,根據預設,您將取得三行專案以供網站取用。 不過,當值$False時,相同 subscriptionId、meterIdusageStartTimeusageEndTime 的所有數據都會折疊成單一明細專案。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

None

輸出

Microsoft.Azure.Commerce.UsageAggregates.Models.UsageAggregationGetResponse