Sdílet prostřednictvím

New-FinOpsCostExport – příkaz

  • Článek

Příkaz New-FinOpsCostExport vytvoří nový export služby Cost Management pro zadaný obor.

Tento příkaz byl testován s následujícími verzemi rozhraní API:

  • 2023-07-01-preview (výchozí) – povolí focusCost a další datové sady.
  • 2023-08-01

Syntaxe

# 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>]

Parametry

Název Popis
‑Name Požadováno. Název exportu.
‑Scope Povinný: ID prostředku oboru pro export dat.
‑Dataset Nepovinné. Datová sada, která se má exportovat. Povolené hodnoty = "ActualCost", "AmortizedCost". Default = "ActualCost".
‑DatasetVersion Nepovinné. Verze schématu datové sady k exportu Default = (nejnovější verze od června 2024, například 1.0 pro FocusCost).
‑DatasetFilters Nepovinné. Slovník párů klíč/hodnota pro filtrování datové sady. Platí jenom pro datovou sadu ReservationRecommendations v 2023-07-01-preview. Platné filtry jsou reservationScope (Shared nebo Single), resourceType (například VirtualMachines), lookBackPeriod (Last7Days, Last30Days, Last60Days).
‑Monthly Nepovinné. Označuje, že export by se měl spouštět měsíčně (místo denně). Výchozí = false.
‑OneTime Nepovinné. Označuje, že export by měl být proveden pouze jednou. Při nastavení jsou počáteční a koncová data kalendářními daty pro dotazování na data. S možností -Monthly nejde použít.
‑StartDate Nepovinné. Den, kdy začnete spouštět exporty. Default = První den předchozího měsíce, pokud je nastaven -OneTime; jinak, zítra (DateTime.Now.AddDays(1)).
‑EndDate Nepovinné. Poslední den spuštění exportu Default = Last day of the month identifikovaný v -StartDate if -OneTime is set; jinak pět let od -StartDate.
‑StorageAccountId Povinný: ID prostředku účtu úložiště pro export dat do.
‑StorageContainer Nepovinné. Název kontejneru pro export dat do. Kontejner se vytvoří, pokud neexistuje. Výchozí = "cost-management".
‑StoragePath Nepovinné. Cesta k exportu dat do kontejneru úložiště Default = (ID oboru).
‑Location Nepovinné. Označuje umístění Azure, které se má použít pro spravovanou identitu použitou k nasdílení dat do účtu úložiště. Spravovaná identita se vyžaduje, aby fungovala s účty úložiště za bránou firewall, ale vyžaduje přístup k udělení oprávnění (například Vlastník). Pokud je zadána, použije se spravovaná identita; V opačném případě se spravovaná identita nepoužívá a váš export nenasdílí data do účtu úložiště za bránou firewall. Výchozí = (prázdné).
‑DoNotPartition Nepovinné. Určuje, jestli se mají exportovaná data rozdělit do více souborů. Pro spolehlivost se doporučuje dělení, takže tato možnost je zakázat dělení. Výchozí = false.
‑DoNotOverwrite Nepovinné. Určuje, zda chcete přepsat dříve exportovaná data pro aktuální měsíc. Přepsání se doporučuje zachovat velikost úložiště a náklady, aby tato možnost zakázala přepisování. Výchozí = false.
‑Execute Nepovinné. Označuje, že export by se měl spustit okamžitě po vytvoření.
‑Backfill Nepovinné. Počet měsíců k exportu dat. Spustí se jenom jednou při vytváření. Nepovedlo se exportovat znovu. Nepodporuje se při nastavení -OneTime. Výchozí hodnota = 0.
‑Execute Nepovinné. Označuje, že export by se měl spustit okamžitě po vytvoření.
‑Backfill Nepovinné. Počet měsíců k exportu dat. Spustí se jenom jednou při vytváření. Nepovedlo se exportovat znovu. Nepodporuje se při nastavení -OneTime. Výchozí hodnota = 0.
‑ApiVersion Nepovinné. Verze rozhraní API, která se má použít při volání rozhraní API pro exporty služby Cost Management. Výchozí hodnota = 2023-07-01-preview.

Příklady

Vytvoření jednorázového exportu

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"

Vytvoří nový jednorázový export s názvem Červenec 2023OneTime z 2023-07-01 do 2023-07-31 s datovou sadou = Skutečná a spustí ho jednou.

Vytvoření a spuštění denního exportu

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

Vytvoří nový naplánovaný export s názvem Daily-MTD with StartDate = DateTime.Now a EndDate = 2024-12-31. Export se spustí okamžitě po vytvoření.

Vytvoření měsíčního exportu

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

Vytvoří nový měsíční export s názvem Monthly-Report with StartDate = 1 day from DateTime.Now and EndDate 2024-08-15. Export se spustí okamžitě po vytvoření.

Vytvoření denního exportu a obnovení čtyř měsíců

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

Vytvoří nový denní export s názvem Daily-MTD with StartDate = DateTime.Now a EndDate 5 years from StartDate. Kromě toho exportujte data nákladů za předchozí čtyři měsíce a uložte všechny výsledky do costreports kontejneru zadaného účtu úložiště.


Související obsah

Související produkty:

Související řešení: