你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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：使用 Dimensions 按范围调用 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} {}

使用 Dimensions 按范围调用 AzCostManagementQuery

参数

-ConfigurationColumn

要包含在查询中的列名数组。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DatasetAggregation

要用于查询的聚合表达式字典。

类型:	Hashtable
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DatasetFilter

在查询中使用筛选器表达式。若要构造，请参阅 DATASETFILTER 属性的 NOTES 部分并创建哈希表。

类型:	IQueryFilter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DatasetGranularity

查询中行的粒度。

类型:	GranularityType
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DatasetGrouping

要用于查询的按表达式分组的数组。若要构造，请参阅 DATASETGROUPING 属性的 NOTES 部分并创建哈希表。

类型:	IQueryGrouping[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:	PSObject
别名:	AzureRMContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ExternalCloudProviderId

对于链接帐户，这可以是“{externalSubscriptionId}”，也可以是用于维度/查询作的合并帐户的“{externalBillingAccountId}”。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ExternalCloudProviderType

与维度/查询作关联的外部云提供程序类型。

类型:	ExternalCloudProviderType
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Scope

这包括订阅范围的“subscriptions/{subscriptionId}/”、resourceGroup 范围的“subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}”、计费帐户范围的“providers/Microsoft.Billing/billingAccounts/{billingAccountId}”和“providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}” for Department scope， 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{EnrollmentAccount 范围的 enrollmentAccountId}，“providers/Microsoft.Management/managementGroups/{managementGroupId}”，用于管理组范围， “providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}”，用于 billingProfile 范围，“providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfileId}/invoiceSections/{invoiceSectionId}”和“providers/Microsoft”。Billing/billingAccounts/{billingAccountId}/customers/{customerId}特定于合作伙伴。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Timeframe

为查询拉取数据的时间范围。

类型:	TimeframeType
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-TimePeriodFrom

要从中提取数据的开始日期。

类型:	DateTime
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TimePeriodTo

要将数据拉取到的结束日期。

类型:	DateTime
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Type

查询的类型。

类型:	ExportType
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。命令脚本未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输出

IQueryResult

通过