다음을 통해 공유


Get-UsageAggregates

보고된 Azure 구독 사용 세부 정보를 가져옵니다.

Warning

AzureRM PowerShell 모듈은 2024년 2월 29일부터 공식적으로 사용되지 않습니다. 사용자는 지속적인 지원 및 업데이트를 보장하기 위해 AzureRM에서 Az PowerShell 모듈로 마이그레이션하는 것이 좋습니다.

AzureRM 모듈은 여전히 작동할 수 있지만 더 이상 기본 또는 지원되지 않으므로 사용자의 재량에 따라 계속 사용할 수 있습니다. Az 모듈로 전환하는 방법에 대한 지침은 마이그레이션 리소스를 참조하세요.

구문

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일부터 2015년 5월 5일 사이에 구독에 대해 보고된 사용량 현황 데이터를 검색합니다.

매개 변수

-AggregationGranularity

데이터의 집계 정밀도를 지정합니다. 유효한 값은 일별 및 매시간입니다. 기본값은 Daily입니다.

형식:Microsoft.Azure.Commerce.UsageAggregates.Models.AggregationGranularity
허용되는 값:Daily, Hourly
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ContinuationToken

이전 호출의 응답 본문에서 검색된 연속 토큰을 지정합니다. 큰 결과 집합의 경우 응답은 연속 토큰을 사용하여 페이징됩니다. 연속 토큰은 진행률에 대한 책갈피 역할을 합니다. 이 매개 변수를 지정하지 않으면 ReportedStartTime에 지정된 날짜 또는 시간의 시작 부분에서 데이터가 검색됩니다. 데이터를 통해 페이지에 대한 응답의 다음 링크를 따르는 것이 좋습니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:IAzureContextContainer
별칭:AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ReportedEndTime

리소스 사용량이 Azure 청구 시스템에 기록된 경우의 보고된 종료 시간을 지정합니다. Azure는 전 세계의 여러 데이터 센터에 걸쳐 있는 분산 시스템이므로 리소스가 실제로 사용된 시간, 즉 리소스 사용 시간, 사용 이벤트가 청구 시스템에 도달한 시간(리소스 사용량 보고 시간) 사이에 지연이 있습니다. 일정 기간 동안 보고된 구독에 대한 모든 사용 이벤트를 가져오기 위해 보고된 시간별로 쿼리합니다. 보고된 시간별로 쿼리하더라도 cmdlet은 리소스 사용 시간별로 응답 데이터를 집계합니다. 리소스 사용량 데이터는 데이터를 분석하는 데 유용한 피벗입니다.

형식:DateTime
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ReportedStartTime

리소스 사용량이 Azure 청구 시스템에 기록된 경우의 보고된 시작 시간을 지정합니다.

형식:DateTime
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ShowDetails

이 cmdlet이 사용량 현황 데이터를 사용하여 인스턴스 수준 세부 정보를 반환하는지 여부를 나타냅니다. 기본값은 $True. $False 경우 서비스는 서버 쪽에서 결과를 집계하므로 더 적은 집계 그룹을 반환합니다. 예를 들어 3개의 웹 사이트를 실행하는 경우 기본적으로 웹 사이트 사용에 대한 세 개의 품목이 제공됩니다. 그러나 값이 $False 동일한 subscriptionId, meterId, usageStartTime 및 usageEndTime에 대한 모든 데이터는 단일 줄 항목으로 축소됩니다.

형식:Boolean
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

None

출력

Microsoft.Azure.Commerce.UsageAggregates.Models.UsageAggregationGetResponse