Freigeben über


Invoke-AzCostManagementQuery

Abfragen der Nutzungsdaten für den definierten Bereich.

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

Beschreibung

Abfragen der Nutzungsdaten für den definierten Bereich.

Beispiele

Beispiel 1: Aufrufen von AzCostManagementQuery nach Scope

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

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

Aufrufen von AzCostManagementQuery nach Scope

Beispiel 2: Aufrufen von AzCostManagementQuery nach Scope mit Dimensionen

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

Aufrufen von AzCostManagementQuery nach Scope mit Dimensionen

Parameter

-ConfigurationColumn

Array von Spaltennamen, die in die Abfrage einbezogen werden sollen.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliases:cf
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-DatasetAggregation

Wörterbuch des Aggregationsausdrucks, der in der Abfrage verwendet werden soll.

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-DatasetFilter

Hat Filterausdruck, der in der Abfrage verwendet werden soll. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für DATASETFILTER-Eigenschaften und erstellen eine Hashtabelle.

Typ:IQueryFilter
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-DatasetGranularity

Die Granularität von Zeilen in der Abfrage.

Typ:GranularityType
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-DatasetGrouping

Array von Gruppieren nach Ausdruck, das in der Abfrage verwendet werden soll. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für DATASETGROUPING-Eigenschaften und erstellen eine Hashtabelle.

Typ:IQueryGrouping[]
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-ExternalCloudProviderId

Dies kann '{externalSubscriptionId}' für verknüpftes Konto oder '{externalBillingAccountId}' für konsolidiertes Konto sein, das mit Dimensions-/Abfragevorgängen verwendet wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-ExternalCloudProviderType

Der externe Cloudanbietertyp, der Dimensions-/Abfragevorgängen zugeordnet ist.

Typ:ExternalCloudProviderType
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Dies umfasst "abonnements/{subscriptionId}/" für den Abonnementbereich, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' für resourceGroup-Bereich, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' für abrechnungskontobereich und 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' für Abteilungsbereich, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccountId}' für enrollmentAccount-Bereich, 'providers/Microsoft.Management/managementGroups/{managementGroupId} for Management Group scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for billingProfile scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId}' for invoiceSection scope, and 'providers/Microsoft. Billing/billingAccounts/{billingAccountId}/customers/{customerId}' speziell für Partner.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-Timeframe

Der Zeitrahmen zum Abrufen von Daten für die Abfrage.

Typ:TimeframeType
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-TimePeriodFrom

Das Startdatum, aus dem Daten abgerufen werden sollen.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-TimePeriodTo

Das Enddatum, in das Daten abgerufen werden sollen.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-Type

Der Typ der Abfrage.

Typ:ExportType
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliases:wi
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

Ausgaben

IQueryResult