Freigeben über

Befehl 'New-FinOpsCostExport'

Der Befehl "New-FinOpsCostExport" erstellt einen neuen Kostenverwaltungsexport für den angegebenen Bereich.

Dieser Befehl wurde mit den folgenden API-Versionen getestet:

  • 2023-07-01-preview (Standard) – Aktiviert FocusCost und andere Datasets.
  • 2023-08-01

Syntax

# Create a new daily/monthly export
New-FinOpsCostExport `
    [-Name] <string> `
    -Scope <string> `
    [-Dataset <string>] `
    [-DatasetVersion <string>] `
    [-DatasetFilters <hashtable>] `
    [-Monthly] `
    [-StartDate <DateTime>] `
    [-EndDate <DateTime>] `
    -StorageAccountId <string> `
    [-StorageContainer <string>] `
    [-StoragePath <string>] `
    [-Location] `
    [-DoNotPartition] `
    [-DoNotOverwrite] `
    [-Execute] `
    [-Backfill <int>] `
    [-ApiVersion <string>]

# Create a new one-time export
New-FinOpsCostExport `
    [-Name] <string> `
    -Scope <string> `
    [-Dataset <string>] `
    [-DatasetVersion <string>] `
    [-DatasetFilters <hashtable>] `
    -OneTime `
    -StartDate <DateTime> `
    -EndDate <DateTime> `
    -StorageAccountId <string> `
    [-StorageContainer <string>] `
    [-StoragePath <string>] `
    [-Location] `
    [-DoNotPartition] `
    [-ApiVersion <string>]

Parameter

Name BESCHREIBUNG
‑Name Erforderlich. Der Name des Exports.
‑Scope Erforderlich. Ressourcen-ID des Bereichs, für den Daten exportiert werden sollen.
‑Dataset Wahlfrei. Zu exportierende Datasets. Zulässige Werte = "ActualCost", "AmortizedCost", "FocusCost", "PriceSheet", "ReservationDetails", "ReservationRecommendations", "ReservationTransactions". Default = "FocusCost".
‑DatasetVersion Wahlfrei. Schemaversion des zu exportierenden Datasets. Default = "1.0" (gilt nur für FocusCost).
‑DatasetFilters Wahlfrei. Wörterbuch der Schlüssel-Wert-Paare zum Filtern des Datasets mit. Gilt nur für reservationRecommendations-Datasets in 2023-07-01-preview. Gültige Filter sind reservationScope (Shared or Single), resourceType (z. B. VirtualMachines), lookBackPeriod (Last7Days, Last30Days, Last60Days).
‑CommitmentDiscountScope Wahlfrei. Reservierungsbereichsfilter, der beim Exportieren von Reservierungsempfehlungen verwendet werden soll. Wird für andere Exporttypen ignoriert. Zulässige Werte: Shared, Single. Standard: Freigegeben.
‑CommitmentDiscountResourceType Wahlfrei. Reservierungsressourcentypfilter, der beim Exportieren von Reservierungsempfehlungen verwendet werden soll. Wird für andere Exporttypen ignoriert. Standard: VirtualMachines.
‑CommitmentDiscountLookback Wahlfrei. Reservierungsressourcentypfilter, der beim Exportieren von Reservierungsempfehlungen verwendet werden soll. Wird für andere Exporttypen ignoriert. Zulässige Werte: 7, 30, 60. Standard: 30.
‑Monthly Wahlfrei. Gibt an, dass der Export monatlich (statt täglich) ausgeführt werden soll. Wird für Preise, Reservierungsempfehlungen und Reservierungstransaktionen ignoriert. Standardwert = FALSE.
‑OneTime Wahlfrei. Gibt an, dass der Export nur einmal ausgeführt werden soll. Bei Festlegung sind die Anfangs-/Enddaten die Datumsangaben zum Abfragen von Daten. In Verbindung mit der Option -Monthly kann nicht verwendet werden.
‑StartDate Wahlfrei. Tag, an dem Exporte ausgeführt werden sollen. Standard = Erster Tag des vorherigen Monats, wenn -OneTime festgelegt ist; andernfalls morgen (DateTime.Now.AddDays(1)).
‑EndDate Wahlfrei. Letzter Tag, an dem der Export ausgeführt werden soll. Standard = Letzter Tag des Monats, der in -StartDate angegeben ist, wenn -OneTime festgelegt ist; andernfalls 5 Jahre ab -StartDate.
‑StorageAccountId Erforderlich. Ressourcen-ID des Speicherkontos, in das Daten exportiert werden sollen.
‑StorageContainer Wahlfrei. Name des Containers, in den Daten exportiert werden sollen. Container wird erstellt, wenn er nicht vorhanden ist. Default = "cost-management".
‑StoragePath Wahlfrei. Pfad zum Exportieren von Daten in den Speichercontainer. Default = (Bereichs-ID).
‑DoNotPartition Wahlfrei. Gibt an, ob die exportierten Daten in mehrere Dateien partitioniert werden sollen. Die Partitionierung wird zur Zuverlässigkeit empfohlen, sodass diese Option die Partitionierung deaktivieren soll. Standardwert = FALSE.
‑DoNotOverwrite Wahlfrei. Gibt an, ob zuvor exportierte Daten für den aktuellen Monat überschrieben werden sollen. Das Überschreiben wird empfohlen, die Speichergröße und die Kosten zu senken, sodass diese Option das Überschreiben deaktivieren soll. Wenn Sie einen Export für FinOps-Hubs erstellen, empfehlen wir Ihnen, die Option -DoNotOverwrite anzugeben, um die Problembehandlung zu verbessern. Standardwert = FALSE.
‑SystemAssignedIdentity Wahlfrei. Gibt an, dass verwaltete Identität verwendet werden soll, um Daten an das Speicherkonto zu übertragen. Verwaltete Identität ist erforderlich, um mit Speicherkonten hinter einer Firewall zu arbeiten, jedoch Zugriff auf die Erteilung von Berechtigungen (z. B. Besitzer). Wenn angegeben, wird verwaltete Identität verwendet; andernfalls wird keine verwaltete Identität verwendet, und Ihr Export kann keine Daten an ein Speicherkonto hinter einer Firewall übertragen. Default = (leer).
‑Location Wahlfrei. Gibt den Azure-Speicherort an, der für die verwaltete Identität verwendet werden soll, um Daten an das Speicherkonto zu übertragen. Verwaltete Identität ist erforderlich, um mit Speicherkonten hinter einer Firewall zu arbeiten, jedoch Zugriff auf die Erteilung von Berechtigungen (z. B. Besitzer). Wenn angegeben, wird verwaltete Identität verwendet; andernfalls wird keine verwaltete Identität verwendet, und Ihr Export kann keine Daten an ein Speicherkonto hinter einer Firewall übertragen. Default = (leer).
‑Execute Wahlfrei. Gibt an, dass der Export unmittelbar nach der Erstellung ausgeführt werden soll.
‑Backfill Wahlfrei. Die Anzahl der Monate, für die die Daten exportiert werden sollen. Dies wird zur Erstellungszeit nur einmal ausgeführt. Fehlgeschlagene Exporte werden nicht erneut versucht. Wird nicht unterstützt, wenn -OneTime festgelegt ist. Standard = 0.
‑ApiVersion Wahlfrei. API-Version, die beim Aufrufen der Kostenverwaltungsexport-API verwendet werden soll. Default = 2023-07-01-preview.

Beispiele

Einmaliges Exportieren erstellen

New-FinopsCostExport -Name 'July2023OneTime' `
    -Scope "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e" `
    -StorageAccountId "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/SharedStorage/providers/Microsoft.Storage/storageAccounts/ddsharedstorage" `
    -DataSet ActualCost `
    -OneTime `
    -StartDate "2023-07-01" `
    -EndDate "2023-07-31"

Erstellt einen neuen einmaligen Export namens "Juli2023OneTime" von 2023-07-01 bis 2023-07-31 mit Dataset = Ist und wird einmal ausgeführt.

Erstellen und Ausführen eines täglichen Exports

New-FinopsCostExport -Name 'DailyMTD' `
    -Scope "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e" `
    -StorageAccountId "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/SharedStorage/providers/Microsoft.Storage/storageAccounts/ddsharedstorage" `
    -DataSet AmortizedCost `
    -EndDate "2024-12-31" `
    -Execute

Erstellt einen neuen geplanten Export namens Daily-MTD mit StartDate = DateTime.Now und EndDate = 2024-12-31. Der Export wird unmittelbar nach der Erstellung ausgeführt.

Erstellen eines monatlichen Exports

New-FinopsCostExport -Name 'Monthly-Report' `
    -Scope "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e" `
    -StorageAccountId "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/SharedStorage/providers/Microsoft.Storage/storageAccounts/ddsharedstorage" `
    -DataSet AmortizedCost `
    -StartDate $(Get-Date).AddDays(5) `
    -EndDate "2024-08-15" `
    -Monthly `
    -Execute

Erstellt einen neuen monatlichen Export namens "Monthly-Report " mit StartDate = 1 Tag von DateTime.Now und EndDate 2024-08-15. Der Export wird unmittelbar nach der Erstellung ausgeführt.

Tägliches Exportieren und Rückfüllen vier Monate erstellen

New-FinopsCostExport -Name 'Daily--MTD' `
    -Scope "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e" `
    -StorageAccountId "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/SharedStorage/providers/Microsoft.Storage/storageAccounts/ddsharedstorage" `
    -DataSet ActualCost `
    -StorageContainer "costreports" `
    -Backfill 4 `
    -Execute

Erstellt einen neuen täglichen Export namens Daily-MTD mit StartDate = DateTime.Now und EndDate 5 Jahre ab StartDate. Exportieren Sie darüber hinaus Kostendaten für die vorherigen vier Monate, und speichern Sie alle Ergebnisse im costreports Container des angegebenen Speicherkontos.


Feedback senden

Teilen Sie uns mit, wie wir mit einer schnellen Überprüfung arbeiten. Wir verwenden diese Rezensionen, um FinOps-Tools und -Ressourcen zu verbessern und zu erweitern.

Feedback übermitteln

Wenn Sie nach etwas Spezifischem suchen, wählen Sie eine vorhandene Idee aus, oder erstellen Sie eine neue Idee. Teilen Sie Ideen mit anderen, um mehr Stimmen zu erhalten. Wir konzentrieren uns auf Ideen mit den meisten Stimmen.

Ideen abstimmen oder vorschlagen


Zugehöriger Inhalt

Verwandte Produkte:

Verwandte Lösungen:


  • Last updated on