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 |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
Typ: | SwitchParameter |
Aliase: | cf |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-DatasetAggregation
Wörterbuch des Aggregationsausdrucks, der in der Abfrage verwendet werden soll.
Typ: | Hashtable |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | 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 |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-DatasetGranularity
Die Granularität von Zeilen in der Abfrage.
Typ: | GranularityType |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | 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 |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-DefaultProfile
Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.
Typ: | PSObject |
Aliase: | AzureRMContext, AzureCredential |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | 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 |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ExternalCloudProviderType
Der externe Cloudanbietertyp, der Dimensions-/Abfragevorgängen zugeordnet ist.
Typ: | ExternalCloudProviderType |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | 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 |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Timeframe
Der Zeitrahmen zum Abrufen von Daten für die Abfrage.
Typ: | TimeframeType |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-TimePeriodFrom
Das Startdatum, aus dem Daten abgerufen werden sollen.
Typ: | DateTime |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-TimePeriodTo
Das Enddatum, in das Daten abgerufen werden sollen.
Typ: | DateTime |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Type
Der Typ der Abfrage.
Typ: | ExportType |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Typ: | SwitchParameter |
Aliase: | wi |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |