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>]

説明

定義されたスコープの使用状況データに対してクエリを実行します。

例

例 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[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DatasetAggregation

クエリで使用する集計式のディクショナリ。

型:	Hashtable
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DatasetFilter

クエリで使用するフィルター式があります。構築するには、DATASETFILTER プロパティの NOTES セクションを参照し、ハッシュテーブルを作成します。

型:	IQueryFilter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DatasetGranularity

クエリ内の行の粒度。

型:	GranularityType
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DatasetGrouping

クエリで使用する式によるグループの配列。構築するには、DATASETGROUPING プロパティの NOTES セクションを参照し、ハッシュテーブルを作成します。

型:	IQueryGrouping[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

型:	PSObject
Aliases:	AzureRMContext, AzureCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ExternalCloudProviderId

これは、リンクされたアカウントの場合は '{externalSubscriptionId}'、ディメンション/クエリ操作で使用される統合アカウントの場合は '{externalBillingAccountId}' にすることができます。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ExternalCloudProviderType

ディメンション/クエリ操作に関連付けられている外部クラウドプロバイダーの種類。

型:	ExternalCloudProviderType
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Scope

これには、サブスクリプションスコープの 'subscriptions/{subscriptionId}/' が含まれます。 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' for resourceGroup scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccounts/{billingAccountId}/{departmentId}' for Department scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccount スコープの enrollmentAccountId}'、"providers/Microsoft.Management/managementGroups/{managementGroupId} for Management Group scope" billingProfile スコープの場合は 'providers/Microsoft.Billing/billingAccountId}/{billingAccountId}/{billingProfileId}'、invoiceSection スコープの場合は 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfileId}/{billingProfileId}/invoiceSections/{invoiceSectionId}' 、'providers/Microsoft' です。Billing/billingAccounts/{billingAccountId}/customers/{customerId}' specific for partners.

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Timeframe

クエリのデータをプルする期間。

型:	TimeframeType
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-TimePeriodFrom

データをプルする開始日。

型:	DateTime
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-TimePeriodTo

データをプルする終了日。

型:	DateTime
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Type

クエリの種類。

型:	ExportType
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットの実行時に発生する内容を示します。このコマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

出力

IQueryResult

次の方法で共有