Freigeben über

Befehl 'New-FinOpsCostExport'

  • Artikel

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 Optional. Zu exportierende Datasets. Zulässige Werte = "ActualCost", "AmortizedCost". Default = "ActualCost".
‑DatasetVersion Optional. Schemaversion des zu exportierenden Datasets. Default = (neueste Version ab Juni 2024; z. B. "1.0" für FocusCost).
‑DatasetFilters Optional. 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).
‑Monthly Optional. Gibt an, dass der Export monatlich (statt täglich) ausgeführt werden soll. Standardwert = FALSE.
‑OneTime Optional. Gibt an, dass der Export nur einmal ausgeführt werden soll. Bei Festlegung sind die Anfangs-/Enddaten die Datumsangaben zum Abfragen von Daten. Kann nicht mit der Option "-Monthly" verwendet werden.
‑StartDate Optional. 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 Optional. Letzter Tag, an dem der Export ausgeführt werden soll. Default = Last day of the month identified in -StartDate if -OneTime is set; andernfalls fünf Jahre ab -StartDate.
‑StorageAccountId Erforderlich. Ressourcen-ID des Speicherkontos, in das Daten exportiert werden sollen.
‑StorageContainer Optional. Name des Containers, in den Daten exportiert werden sollen. Container wird erstellt, wenn er nicht vorhanden ist. Default = "cost-management".
‑StoragePath Optional. Pfad zum Exportieren von Daten in den Speichercontainer. Default = (Bereichs-ID).
‑Location Optional. 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 verschiebt keine Daten an ein Speicherkonto hinter einer Firewall. Default = (leer).
‑DoNotPartition Optional. 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 Optional. 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. Standardwert = FALSE.
‑Execute Optional. Gibt an, dass der Export unmittelbar nach der Erstellung ausgeführt werden soll.
‑Backfill Optional. Die Anzahl der Monate, für die die Daten exportiert werden sollen. Sie wird zur Erstellungszeit nur einmal ausgeführt. Fehlgeschlagene Exporte werden nicht erneut formatiert. Wird nicht unterstützt, wenn -OneTime festgelegt ist. Standard = 0.
‑Execute Optional. Gibt an, dass der Export unmittelbar nach der Erstellung ausgeführt werden soll.
‑Backfill Optional. Die Anzahl der Monate, für die die Daten exportiert werden sollen. Sie wird zur Erstellungszeit nur einmal ausgeführt. Fehlgeschlagene Exporte werden nicht erneut formatiert. Wird nicht unterstützt, wenn -OneTime festgelegt ist. Standard = 0.
‑ApiVersion Optional. 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.


Zugehöriger Inhalt

Verwandte Produkte:

Verwandte Lösungen: