Share via


Invoke-AzCostManagementQuery

Voer een query uit op de gebruiksgegevens voor het gedefinieerde bereik.

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>]
      [-Confirm]
      [-WhatIf]
      [<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>]
      [-Confirm]
      [-WhatIf]
      [<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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DatasetAggregation

Woordenlijst van aggregatie-expressie die moet worden gebruikt in de query.

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DatasetGranularity

De granulariteit van rijen in de query.

Type:GranularityType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ExternalCloudProviderType

Het type externe cloudprovider dat is gekoppeld aan dimensie-/querybewerkingen.

Type:ExternalCloudProviderType
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Timeframe

Het tijdsbestek voor het ophalen van gegevens voor de query.

Type:TimeframeType
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TimePeriodFrom

De begindatum waaruit gegevens moeten worden opgehaald.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimePeriodTo

De einddatum voor het ophalen van gegevens naar.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Type

Het type query.

Type:ExportType
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Uitvoerwaarden

IQueryResult

Notities

ALIASSEN

EIGENSCHAPPEN VAN COMPLEXE PARAMETERS

Als u de hieronder beschreven parameters wilt maken, maakt u een hash-tabel met de juiste eigenschappen. Voer Get-Help-about_Hash_Tables uit voor informatie over hashtabellen.

DATASETFILTER <IQueryFilter>: heeft filterexpressie die moet worden gebruikt in de query.

  • [And <IQueryFilter[]>]: De logische 'AND'-expressie. Moet ten minste 2 items bevatten.
  • [Dimensions <IQueryComparisonExpression>]: Heeft een vergelijkingsexpressie voor een dimensie
    • Name <String>: De naam van de kolom die moet worden gebruikt in vergelijking.
    • Value <String[]>: Matrix met waarden die moeten worden gebruikt voor vergelijking
  • [Not <IQueryFilter>]: De logische NOT-expressie.
  • [Or <IQueryFilter[]>]: De logische 'OR'-expressie. Moet ten minste 2 items bevatten.
  • [Tag <IQueryComparisonExpression>]: Heeft een vergelijkingsexpressie voor een tag

DATASETGROUPING <IQueryGrouping[]>: Matrix van groeperen op expressie die moet worden gebruikt in de query.

  • Name <String>: De naam van de kolom die moet worden gegroepeerd.
  • Type <QueryColumnType>: Heeft het type kolom dat moet worden gegroepeerd.