Compartir a través de


Invoke-AzCostManagementQuery

Consulte los datos de uso para el ámbito definido.

Sintaxis

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 los datos de uso para el ámbito definido.

Ejemplos

Ejemplo 1: Invocar AzCostManagementQuery por ámbito

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

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

Invocación de AzCostManagementQuery por ámbito

Ejemplo 2: Invocar AzCostManagementQuery por ámbito con dimensiones

$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} {}

Invocación de AzCostManagementQuery por ámbito con dimensiones

Parámetros

-ConfigurationColumn

Matriz de nombres de columna que se van a incluir en la consulta.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DatasetAggregation

Diccionario de expresiones de agregación que se van a usar en la consulta.

Tipo:Hashtable
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DatasetFilter

Tiene la expresión de filtro que se va a usar en la consulta. Para construir, consulte la sección NOTES de las propiedades DATASETFILTER y cree una tabla hash.

Tipo:IQueryFilter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DatasetGranularity

Granularidad de las filas de la consulta.

Tipo:GranularityType
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DatasetGrouping

Matriz de agrupación por expresión que se va a usar en la consulta. Para construir, consulte la sección NOTES de las propiedades DATASETGROUPING y cree una tabla hash.

Tipo:IQueryGrouping[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:PSObject
Alias:AzureRMContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ExternalCloudProviderId

Puede ser '{externalSubscriptionId}' para la cuenta vinculada o '{externalBillingAccountId}' para la cuenta consolidada usada con operaciones de dimensión/consulta.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ExternalCloudProviderType

Tipo de proveedor de nube externo asociado a las operaciones de dimensión y consulta.

Tipo:ExternalCloudProviderType
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Scope

Esto incluye "subscriptions/{subscriptionId}/" para el ámbito de la suscripción, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' para el ámbito resourceGroup, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' para el ámbito de la cuenta de facturación y 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' para el ámbito department, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccountId}" para el ámbito EnrollmentAccount, "providers/Microsoft.Management/managementGroups/{managementGroupId} para el ámbito del grupo de administración, "providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}" para el ámbito billingProfile, "providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}" para el ámbito invoiceSection y "providers/Microsoft". Billing/billingAccounts/{billingAccountId}/customers/{customerId}' específico para los partners.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Timeframe

Período de tiempo para extraer datos de la consulta.

Tipo:TimeframeType
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-TimePeriodFrom

Fecha de inicio de la que se van a extraer datos.

Tipo:DateTime
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-TimePeriodTo

Fecha de finalización a la que se van a extraer los datos.

Tipo:DateTime
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Type

Tipo de la consulta.

Tipo:ExportType
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Salidas

IQueryResult