New-FinOpsCostExport – příkaz

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:

  • 2025-03-01 (výchozí) – verze GA pro FocusCost a další datové sady.
  • 2023-07-01-preview
  • 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 Požadováno. ID prostředku oboru pro export dat.
‑Dataset Nepovinné. Datová sada, která se má exportovat. Povolené hodnoty = "ActualCost", "AmortizedCost", "FocusCost", "PriceSheet", "ReservationDetails", "ReservationRecommendations", "ReservationTransactions". Výchozí = "FocusCost".
‑DatasetVersion Nepovinné. Verze schématu datové sady k exportu Výchozí = "1.2-preview" (platí jenom 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 nebo novějších verzích. Platné filtry jsou reservationScope (Shared nebo Single), resourceType (například VirtualMachines), lookBackPeriod (Last7Days, Last30Days, Last60Days).
‑CommitmentDiscountScope Nepovinné. Filtr rozsahu rezervace, který se má použít při exportu doporučení pro rezervace. Ignorováno pro jiné typy exportu. Povolené hodnoty: Shared, Single. Výchozí: Sdíleno.
‑CommitmentDiscountResourceType Nepovinné. Filtr typu prostředku rezervace, který se má použít při exportu doporučení pro rezervace. Ignorováno pro jiné typy exportu. Výchozí hodnota: VirtualMachines.
‑CommitmentDiscountLookback Nepovinné. Filtr typu prostředku rezervace, který se má použít při exportu doporučení pro rezervace. Ignorováno pro jiné typy exportu. Povolené hodnoty: 7, 30, 60. Výchozí hodnota: 30.
‑Monthly Nepovinné. Označuje, že export by se měl spouštět měsíčně (místo denně). Ignorováno pro ceny, doporučení rezervací a transakce rezervací. 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. Nelze použít ve spojení s možností -Monthly.
‑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 pokud je nastaven -OneTime; jinak, 5 let od -StartDate.
‑StorageAccountId Požadováno. 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).
‑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í. Pokud vytváříte export pro centra FinOps, doporučujeme zadat možnost -DoNotOverwrite pro zlepšení řešení potíží. Výchozí = false.
‑SystemAssignedIdentity Nepovinné. Označuje, že spravovaná identita by se měla použít k odesílání 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žije a export nebude moct odesílat data do účtu úložiště za bránou firewall. Výchozí = (prázdné).
‑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žije a export nebude moct odesílat data do účtu úložiště za bránou firewall. Výchozí = (prázdné).
‑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. To se spustí jenom jednou při vytváření. Neúspěšné exporty se znovu nepokusí. 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 = 2025-03-01.

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ě.


Váš názor

Dejte nám vědět, jak si vedeme, pomocí rychlé zpětné vazby. Tyto recenze používáme k vylepšení a rozšíření nástrojů a prostředků FinOps.

Poskytnout zpětnou vazbu

Pokud hledáte něco konkrétního, hlasujte pro existující nebo vytvořte nový nápad. Sdílejte nápady s ostatními, abyste získali více hlasů. Zaměřujeme se na nápady s nejvíce hlasy.

hlasovat nebo navrhovat nápady


Související obsah

Související produkty:

Související řešení:


  • Last updated on