Invoke-AzCostManagementQuery
Consulte os dados de uso para obter o escopo definido.
Sintaxe
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
Consulte os dados de uso para obter o escopo definido.
Exemplos
Exemplo 1: Invoque AzCostManagementQuery por escopo
Invoke-AzCostManagementQuery -Scope "/subscriptions/***********" -Timeframe MonthToDate -Type Usage -DatasetGranularity 'Daily'
Column Row
------ ---
{UsageDate, Currency} {20201101 USD, 20201102 USD, 20201103 USD, 20201104 USD…}
Invoque AzCostManagementQuery por escopo
Exemplo 2: Invocar AzCostManagementQuery por escopo com dimensões
$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} {}
Invoque AzCostManagementQuery por escopo com dimensões
Parâmetros
-ConfigurationColumn
Matriz de nomes de colunas a serem incluídos na consulta.
Tipo: | String[] |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Confirm
Solicita confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-DatasetAggregation
Dicionário de expressão de agregação a utilizar na consulta.
Tipo: | Hashtable |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-DatasetFilter
Tem expressão de filtro para usar na consulta. Para construir, consulte a seção NOTAS para propriedades DATASETFILTER e crie uma tabela de hash.
Tipo: | IQueryFilter |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-DatasetGranularity
A granularidade das linhas na consulta.
Tipo: | GranularityType |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-DatasetGrouping
Matriz de grupo por expressão a ser usada na consulta. Para construir, consulte a seção NOTAS para propriedades DATASETGROUPING e crie uma tabela de hash.
Tipo: | IQueryGrouping[] |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.
Tipo: | PSObject |
Aliases: | AzureRMContext, AzureCredential |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-ExternalCloudProviderId
Pode ser '{externalSubscriptionId}' para conta vinculada ou '{externalBillingAccountId}' para conta consolidada usada com operações de dimensão/consulta.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-ExternalCloudProviderType
O tipo de provedor de nuvem externo associado a operações de dimensão/consulta.
Tipo: | ExternalCloudProviderType |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Scope
Isso inclui 'subscriptions/{subscriptionId}/' para o escopo da assinatura, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' para o escopo resourceGroup, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' para o escopo da Conta de Cobrança e 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' para o escopo do Departamento, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccountId}' para o escopo EnrollmentAccount, 'providers/Microsoft.Management/managementGroups/{managementGroupId} para o escopo do Grupo de Gerenciamento, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' para o escopo do billingProfile, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}' para o escopo invoiceSection e 'providers/Microsoft. Billing/billingAccounts/{billingAccountId}/customers/{customerId}' específico para parceiros.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Timeframe
O período de tempo para extrair dados para a consulta.
Tipo: | TimeframeType |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-TimePeriodFrom
A data de início a partir da qual extrair dados.
Tipo: | DateTime |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-TimePeriodTo
A data final para a qual extrair dados.
Tipo: | DateTime |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Type
O tipo da consulta.
Tipo: | ExportType |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Saídas
Azure PowerShell