Invoke-AzCostManagementQuery

  • Preview
Module:
Az.CostManagement Module

Deze cmdlet maakt deel uit van een preview-module . Preview-versies worden niet aanbevolen voor gebruik in productieomgevingen. Zie https://aka.ms/azps-refstatus voor meer informatie.

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

Syntax

UsageExpanded (Standaard) 

Invoke-AzCostManagementQuery
    -Scope <String>
    -Timeframe <String>
    -Type <String>
    [-ConfigurationColumn <String[]>]
    [-DatasetAggregation <Hashtable>]
    [-DatasetFilter <IQueryFilter>]
    [-DatasetGranularity <String>]
    [-DatasetGrouping <IQueryGrouping[]>]
    [-TimePeriodFrom <DateTime>]
    [-TimePeriodTo <DateTime>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UsageExpanded1 

Invoke-AzCostManagementQuery
    -ExternalCloudProviderId <String>
    -ExternalCloudProviderType <String>
    -Timeframe <String>
    -Type <String>
    [-ConfigurationColumn <String[]>]
    [-DatasetAggregation <Hashtable>]
    [-DatasetFilter <IQueryFilter>]
    [-DatasetGranularity <String>]
    [-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 met kolomnamen die in de query moeten worden opgenomen.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DatasetAggregation

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

Parametereigenschappen

Type:Hashtable
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DatasetFilter

Heeft filterexpressie die moet worden gebruikt in de query.

Parametereigenschappen

Type:IQueryFilter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DatasetGranularity

De granulariteit van rijen in de query.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DatasetGrouping

Matrix van groep op expressie die in de query moet worden gebruikt.

Parametereigenschappen

Type:

IQueryGrouping[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Parametereigenschappen

Type:PSObject
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzureRMContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ExternalCloudProviderId

Dit kan {externalSubscriptionId} zijn voor een gekoppeld account of {externalBillingAccountId} voor een geconsolideerd account dat wordt gebruikt met dimensie-/querybewerkingen.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

UsageExpanded1
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ExternalCloudProviderType

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

UsageExpanded1
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Scope

Dit omvat 'subscriptions/{subscriptionId}/' voor abonnementsbereik, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' voor het 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. Beheer/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 invoiceSection en providers/Microsoft. Billing/billingAccounts/{billingAccountId}/customers/{customerId}' specifiek voor partners.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

UsageExpanded
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Timeframe

Het tijdsbestek voor het ophalen van gegevens voor de query.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-TimePeriodFrom

De begindatum waaruit gegevens moeten worden opgehaald.

Parametereigenschappen

Type:DateTime
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-TimePeriodTo

De einddatum voor het ophalen van gegevens naar.

Parametereigenschappen

Type:DateTime
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Type

Het type query.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Uitvoerwaarden

IQueryResult