Dela via


Invoke-AzCostManagementQuery

Fråga användningsdata för definierat omfång.

Syntax

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

Fråga användningsdata för definierat omfång.

Exempel

Exempel 1: Anropa AzCostManagementQuery efter omfång

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

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

Anropa AzCostManagementQuery efter omfång

Exempel 2: Anropa AzCostManagementQuery efter omfång med dimensioner

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

Anropa AzCostManagementQuery efter omfång med dimensioner

Parametrar

-ConfigurationColumn

Matris med kolumnnamn som ska ingå i frågan.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DatasetAggregation

Ordlista med sammansättningsuttryck som ska användas i frågan.

Typ:Hashtable
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DatasetFilter

Har filteruttryck att använda i frågan. Information om hur du skapar finns i AVSNITTET ANTECKNINGAR för DATASETFILTER-egenskaper och skapa en hash-tabell.

Typ:IQueryFilter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DatasetGranularity

Kornigheten för rader i frågan.

Typ:GranularityType
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DatasetGrouping

Matris med gruppera efter uttryck som ska användas i frågan. Information om hur du skapar finns i AVSNITTET ANTECKNINGAR för DATASETGROUPING-egenskaper och skapa en hash-tabell.

Typ:IQueryGrouping[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:PSObject
Alias:AzureRMContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ExternalCloudProviderId

Detta kan vara {externalSubscriptionId} för det länkade kontot eller {externalBillingAccountId} för konsoliderat konto som används med dimensions-/frågeåtgärder.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ExternalCloudProviderType

Den externa molnleverantörstypen som är associerad med dimensions-/frågeåtgärder.

Typ:ExternalCloudProviderType
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Scope

Detta inkluderar "subscriptions/{subscriptionId}/" för prenumerationsomfång, "subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}" för resourceGroup-omfånget, "providers/Microsoft.Billing/billingAccounts/{billingAccountId}" för faktureringskontoomfånget och "providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}" för avdelningsomfånget Providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccountId} för EnrollmentAccount-omfång, "providers/Microsoft.Management/managementGroups/{managementGroupId} för hanteringsgruppsomfång, "providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}" för billingProfile scope, "providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}" för invoiceSection-omfång och "providers/Microsoft. Fakturering/faktureringKonton/{billingAccountId}/customers/{customerId} specifika för partner.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Timeframe

Tidsramen för att hämta data för frågan.

Typ:TimeframeType
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TimePeriodFrom

Startdatumet för att hämta data från.

Typ:DateTime
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TimePeriodTo

Slutdatumet för att hämta data till.

Typ:DateTime
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Type

Typen av fråga.

Typ:ExportType
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Utdata

IQueryResult