다음을 통해 공유

Invoke-AzCostManagementQuery

  • 참조
모듈:
Az.CostManagement

정의된 범위에 대한 사용량 현황 데이터를 쿼리합니다.

구문

Invoke-AzCostManagementQuery
      -Scope <String>
      -Timeframe <TimeframeType>
      -Type <ExportType>
      [-ConfigurationColumn <String[]>]
      [-DatasetAggregation <Hashtable>]
      [-DatasetFilter <IQueryFilter>]
      [-DatasetGranularity <GranularityType>]
      [-DatasetGrouping <IQueryGrouping[]>]
      [-TimePeriodFrom <DateTime>]
      [-TimePeriodTo <DateTime>]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-AzCostManagementQuery
      -ExternalCloudProviderId <String>
      -ExternalCloudProviderType <ExternalCloudProviderType>
      -Timeframe <TimeframeType>
      -Type <ExportType>
      [-ConfigurationColumn <String[]>]
      [-DatasetAggregation <Hashtable>]
      [-DatasetFilter <IQueryFilter>]
      [-DatasetGranularity <GranularityType>]
      [-DatasetGrouping <IQueryGrouping[]>]
      [-TimePeriodFrom <DateTime>]
      [-TimePeriodTo <DateTime>]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

정의된 범위에 대한 사용량 현황 데이터를 쿼리합니다.

예제

예제 1: 범위별 AzCostManagementQuery 호출

Invoke-AzCostManagementQuery -Scope "/subscriptions/***********" -Timeframe MonthToDate -Type Usage -DatasetGranularity 'Daily'

Column                Row
------                ---
{UsageDate, Currency} {20201101 USD, 20201102 USD, 20201103 USD, 20201104 USD…}

범위별 AzCostManagementQuery 호출

예제 2: 차원을 사용하여 범위별 AzCostManagementQuery 호출

$dimensions = New-AzCostManagementQueryComparisonExpressionObject -Name 'ResourceGroup' -Value 'API'
$filter = New-AzCostManagementQueryFilterObject -Dimensions $dimensions
Invoke-AzCostManagementQuery -Type Usage -Scope "subscriptions/***********" -DatasetGranularity 'Monthly' -DatasetFilter $filter -Timeframe MonthToDate -Debug

Column                   Row
------                   ---
{BillingMonth, Currency} {}

차원을 사용하여 범위별 AzCostManagementQuery 호출

매개 변수

-ConfigurationColumn

쿼리에 포함할 열 이름의 배열입니다.

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

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

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

-DatasetAggregation

쿼리에 사용할 집계 식의 사전입니다.

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

-DatasetFilter

쿼리에 사용할 필터 식이 있습니다. 생성하려면 DATASETFILTER 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-DatasetGranularity

쿼리의 행 세분성입니다.

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

-DatasetGrouping

쿼리에 사용할 식별 그룹 배열입니다. 생성하려면 DATASETGROUPING 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-DefaultProfile

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

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

-ExternalCloudProviderId

연결된 계정의 경우 '{externalSubscriptionId}' 또는 차원/쿼리 작업에 사용되는 통합 계정의 경우 '{externalBillingAccountId}'일 수 있습니다.

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

-ExternalCloudProviderType

차원/쿼리 작업과 연결된 외부 클라우드 공급자 유형입니다.

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

-Scope

여기에는 구독 범위에 대한 'subscriptions/{subscriptionId}/', resourceGroup 범위에 대한 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}'이 포함됩니다. 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope and 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccount 범위에 대한 enrollmentAccountId}', 관리 그룹 범위의 경우 'providers/Microsoft.Management/managementGroups/{managementGroupId}, billingProfile 범위에 대한 'providers/Microsoft.Billing/billingAccountId}/{billingProfileId}' invoiceSection 범위에 대한 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}' 및 'providers/Microsoft. 파트너에 대한 청구/billingAccounts/{billingAccountId}/customers/{customerId}'

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

-Timeframe

쿼리에 대한 데이터를 끌어당기는 시간 프레임입니다.

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

-TimePeriodFrom

데이터를 끌어올 시작 날짜입니다.

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

-TimePeriodTo

데이터를 끌어올 종료 날짜입니다.

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

-Type

쿼리의 형식입니다.

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

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

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

출력

IQueryResult