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 weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. 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 |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.
| Typ: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReportedStartTime
Gibt die gemeldete Startzeit für die Aufzeichnung der Ressourcennutzung im Azure-Abrechnungssystem an.
| Typ: | DateTime |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Eingaben
None
Ausgaben
Microsoft.Azure.Commerce.UsageAggregates.Models.UsageAggregationGetResponse