Freigeben über


Get-UsageAggregates

Ruft die gemeldeten Azure-Abonnementnutzungsdetails ab.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul möglicherweise weiterhin funktioniert, wird es nicht mehr gewartet, und es wird kein Support mehr angeboten. Die weitere Nutzung erfolgt daher nach Ermessen und Risiko des Benutzers. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

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

Beschreibung

Das Cmdlet "Get-UsageAggregates " ruft aggregierte Azure-Abonnementnutzungsdaten anhand der folgenden Eigenschaften ab:

  • Start- und Endzeiten, zu denen die Verwendung gemeldet wurde.
  • Aggregationsgenauigkeit, entweder täglich oder stündlich.
  • Detail der Instanzebene für mehrere Instanzen derselben Ressource. Bei konsistenten Ergebnissen basieren die zurückgegebenen Daten darauf, wann die Nutzungsdetails von der Azure-Ressource gemeldet wurden. Weitere Informationen finden Sie unter 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 der Microsoft Developer Network-Bibliothek.

Beispiele

Beispiel 1: Abrufen von Abonnementdaten

PS C:\>Get-UsageAggregates -ReportedStartTime "5/2/2015" -ReportedEndTime "5/5/2015"

Mit diesem Befehl werden die gemeldeten Nutzungsdaten für das Abonnement zwischen dem 02.02.2015 und dem 5.05.2015 abgerufen.

Parameter

-AggregationGranularity

Gibt die Aggregationsgenauigkeit der Daten an. Gültige Werte sind: Täglich und Stündlich. Der Standardwert ist "Täglich".

Typ:Microsoft.Azure.Commerce.UsageAggregates.Models.AggregationGranularity
Zulässige Werte:Daily, Hourly
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ContinuationToken

Gibt das Fortsetzungstoken an, das aus dem Antworttext im vorherigen Aufruf abgerufen wurde. Bei einem großen Resultset werden Antworten mithilfe von Fortsetzungstoken ausgelagert. Das Fortsetzungstoken dient als Textmarke für den Fortschritt. Wenn Sie diesen Parameter nicht angeben, werden die Daten vom Anfang des in ReportedStartTime angegebenen Tages oder der angegebenen Stunde abgerufen. Es wird empfohlen, den nächsten Link in der Antwort auf die Seite mit den Daten zu befolgen.

Typ:String
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:IAzureContextContainer
Aliase:AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ReportedEndTime

Gibt die gemeldete Endzeit für die Aufzeichnung der Ressourcennutzung im Azure-Abrechnungssystem an. Azure ist ein verteiltes System, das mehrere Rechenzentren auf der ganzen Welt umfasst. Daher gibt es eine Verzögerung zwischen dem Zeitpunkt, an dem die Ressource tatsächlich verbraucht wurde, was die Ressourcennutzungszeit ist und wann das Nutzungsereignis das Abrechnungssystem erreicht hat, was die gemeldete Zeit für die Ressourcennutzung ist. Um alle Nutzungsereignisse für ein Abonnement abzurufen, das für einen Zeitraum gemeldet wird, fragen Sie nach gemeldeter Zeit ab. Obwohl Sie nach gemeldeter Zeit abfragen, aggregiert das Cmdlet die Antwortdaten nach der Ressourcennutzungszeit. Die Ressourcennutzungsdaten sind der nützliche Pivot zum Analysieren der Daten.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ReportedStartTime

Gibt die gemeldete Startzeit für die Aufzeichnung der Ressourcennutzung im Azure-Abrechnungssystem an.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ShowDetails

Gibt an, ob dieses Cmdlet Details auf Instanzebene mit den Verwendungsdaten zurückgibt. Der Standardwert ist $True. Wenn $False, aggregiert der Dienst die Ergebnisse auf der Serverseite und gibt daher weniger aggregierte Gruppen zurück. Wenn Sie beispielsweise drei Websites ausführen, erhalten Sie standardmäßig drei Positionen für den Websiteverbrauch. Wenn der Wert jedoch $False ist, werden alle Daten für dieselbe subscriptionId, meterId, usageStartTime und usageEndTime in ein einzelnes Zeilenelement reduziert.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

Microsoft.Azure.Commerce.UsageAggregates.Models.UsageAggregationGetResponse