Get-UsageAggregates

Hiermee haalt u de gerapporteerde gebruiksgegevens van het Azure-abonnement op.

Notitie

Dit is de vorige versie van onze documentatie. Raadpleeg de meest recente versie voor actuele informatie.

Syntax

Get-UsageAggregates
   -ReportedStartTime <DateTime>
   -ReportedEndTime <DateTime>
   [-AggregationGranularity <AggregationGranularity>]
   [-ShowDetails <Boolean>]
   [-ContinuationToken <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Met de cmdlet Get-UsageAggregates worden geaggregeerde gebruiksgegevens voor Azure-abonnementen opgehaald door de volgende eigenschappen:

  • Begin- en eindtijden waarop het gebruik is gerapporteerd.
  • Aggregatieprecisie, dagelijks of per uur.
  • Detail op exemplaarniveau voor meerdere exemplaren van dezelfde resource. Voor consistente resultaten zijn de geretourneerde gegevens gebaseerd op wanneer de gebruiksgegevens zijn gerapporteerd door de Azure-resource. Zie Azure Billing REST API Referencehttps://msdn.microsoft.com/library/azure/1ea5b323-54bb-423d-916f-190de96c6a3c (https://msdn.microsoft.com/library/azure/1ea5b323-54bb-423d-916f-190de96c6a3c) in de Microsoft Developer Network-bibliotheek voor meer informatie.

Voorbeelden

Voorbeeld 1: Abonnementsgegevens ophalen

Get-UsageAggregates -ReportedStartTime "5/2/2015" -ReportedEndTime "5/5/2015"

Met deze opdracht worden de gerapporteerde gebruiksgegevens voor het abonnement opgehaald tussen 5-2-2015 en 5-5-2015.

Parameters

-AggregationGranularity

Hiermee geeft u de aggregatieprecisie van de gegevens op. Geldige waarden zijn: Dagelijks en Elk uur. De standaardwaarde is Dagelijks.

Type:Microsoft.Azure.Commerce.UsageAggregates.Models.AggregationGranularity
Accepted values:Daily, Hourly
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ContinuationToken

Hiermee geeft u het vervolgtoken op dat is opgehaald uit de hoofdtekst van het antwoord in de vorige aanroep. Voor een grote resultatenset worden antwoorden gepaginad met behulp van vervolgtokens. Het vervolgtoken fungeert als bladwijzer voor voortgang. Als u deze parameter niet opgeeft, worden de gegevens opgehaald vanaf het begin van de dag of het uur dat is opgegeven in ReportedStartTime. U wordt aangeraden de volgende koppeling te volgen in het antwoord op de pagina met de gegevens.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ReportedEndTime

Hiermee geeft u de gerapporteerde eindtijd op voor het moment waarop het resourcegebruik is vastgelegd in het Azure-factureringssysteem. Azure is een gedistribueerd systeem, dat meerdere datacenters over de hele wereld beslaat, dus er is een vertraging tussen het moment waarop de resource daadwerkelijk is verbruikt, wat de tijd van het resourcegebruik is en wanneer de gebruiksgebeurtenis het factureringssysteem heeft bereikt, wat de gerapporteerde tijd van het resourcegebruik is. Als u alle gebruiksevenementen wilt ophalen voor een abonnement dat gedurende een bepaalde periode wordt gerapporteerd, voert u een query uit op de gerapporteerde tijd. Hoewel u query's uitvoert op gerapporteerde tijd, worden de antwoordgegevens door de cmdlet geaggregeerd op basis van de tijd van het resourcegebruik. De resourcegebruiksgegevens zijn de nuttige draai voor het analyseren van de gegevens.

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

Hiermee geeft u de gerapporteerde begintijd op voor het moment waarop het resourcegebruik is vastgelegd in het Azure-factureringssysteem.

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

Hiermee wordt aangegeven of met deze cmdlet details op exemplaarniveau worden geretourneerd met de gebruiksgegevens. De standaardwaarde is $True. Als $False, aggregeert de service de resultaten aan de serverzijde en retourneert daarom minder statistische groepen. Als u bijvoorbeeld drie websites uitvoert, krijgt u standaard drie regelitems voor websiteverbruik. Wanneer de waarde echter wordt $False, worden alle gegevens voor dezelfde subscriptionId, meterId, usageStartTime en usageEndTime samengevouwen in één regelitem.

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

Invoerwaarden

None

Uitvoerwaarden

Microsoft.Azure.Commerce.UsageAggregates.Models.UsageAggregationGetResponse