Invoke-AzCostManagementQuery
Voer een query uit op de gebruiksgegevens voor het gedefinieerde bereik.
Syntaxis
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
Voer een query uit op de gebruiksgegevens voor het gedefinieerde bereik.
Voorbeelden
Voorbeeld 1: AzCostManagementQuery aanroepen op bereik
Invoke-AzCostManagementQuery -Scope "/subscriptions/***********" -Timeframe MonthToDate -Type Usage -DatasetGranularity 'Daily'
Column Row
------ ---
{UsageDate, Currency} {20201101 USD, 20201102 USD, 20201103 USD, 20201104 USD…}
AzCostManagementQuery aanroepen op bereik
Voorbeeld 2: AzCostManagementQuery aanroepen op bereik met dimensies
$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} {}
AzCostManagementQuery op bereik aanroepen met dimensies
Parameters
-ConfigurationColumn
Matrix van kolomnamen die moeten worden opgenomen in de query.
Type: | String[] |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Confirm
U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: | SwitchParameter |
Aliassen: | cf |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-DatasetAggregation
Woordenlijst van aggregatie-expressie die moet worden gebruikt in de query.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-DatasetFilter
Heeft filterexpressie die moet worden gebruikt in de query. Zie de sectie NOTES voor DE EIGENSCHAPPEN VAN DATASETFILTER en maak een hash-tabel om deze samen te stellen.
Type: | IQueryFilter |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-DatasetGranularity
De granulariteit van rijen in de query.
Type: | GranularityType |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-DatasetGrouping
Matrix van groeperen op expressie die moet worden gebruikt in de query. Zie de sectie NOTES voor de eigenschappen DATASETGROUPING en maak een hash-tabel om deze samen te stellen.
Type: | IQueryGrouping[] |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-DefaultProfile
De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.
Type: | PSObject |
Aliassen: | AzureRMContext, AzureCredential |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ExternalCloudProviderId
Dit kan {externalSubscriptionId} zijn voor een gekoppeld account of {externalBillingAccountId} voor een geconsolideerd account dat wordt gebruikt met dimensie-/querybewerkingen.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ExternalCloudProviderType
Het type externe cloudprovider dat is gekoppeld aan dimensie-/querybewerkingen.
Type: | ExternalCloudProviderType |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Scope
Dit omvat 'subscriptions/{subscriptionId}/' voor het abonnementsbereik, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' voor resourceGroup-bereik, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' voor het bereik van de factureringsrekening en providers/Microsoft.Billing/billingAccounts/{billingAccountId}/afdelingen/{departmentId} voor afdelingsbereik, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccountId} voor het bereik EnrollmentAccount, providers/Microsoft.Management/managementGroups/{managementGroupId} voor het bereik van beheergroepen, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' voor het bereik billingProfile, providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoiceSections/{invoiceSectionId} voor het bereik van invoiceSection en providers/Microsoft. Billing/billingAccounts/{billingAccountId}/customers/{customerId}' specifiek voor partners.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Timeframe
Het tijdsbestek voor het ophalen van gegevens voor de query.
Type: | TimeframeType |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-TimePeriodFrom
De begindatum waaruit gegevens moeten worden opgehaald.
Type: | DateTime |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-TimePeriodTo
De einddatum voor het ophalen van gegevens naar.
Type: | DateTime |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Type
Het type query.
Type: | ExportType |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-WhatIf
Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliassen: | wi |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
Uitvoerwaarden
Azure PowerShell