New-FinOpsCostExport parancs

A New-FinOpsCostExport parancs létrehoz egy új Cost Management-exportálást a megadott hatókörhöz.

Ezt a parancsot a következő API-verziókkal teszteltük:

  • 2025-03-01 (alapértelmezett) – A FocusCost és más adatkészletek GA-verziója.
  • 2023-07-01-preview
  • 2023-08-01

Szemantika

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

Paraméterek

Név Leírás
‑Name Szükséges. Az exportálás neve.
‑Scope Szükséges. Annak a hatókörnek az erőforrás-azonosítója, amelybe adatokat szeretne exportálni.
‑Dataset Opcionális. Exportálandó adatkészlet. Engedélyezett értékek = "ActualCost", "AmortizedCost", "FocusCost", "PriceSheet", "ReservationDetails", "ReservationRecommendations", "ReservationTransactions". Default = "FocusCost".
‑DatasetVersion Opcionális. Az exportálandó adatkészlet sémaverziója. Default = "1.2-preview" (csak a FocusCostra vonatkozik).
‑DatasetFilters Opcionális. Kulcs-érték párok szótára az adathalmaz szűréséhez. Csak a ReservationRecommendations adathalmazra vonatkozik a 2023-07-01-preview vagy újabb verzióban. Érvényes szűrők: reservationScope (Megosztott vagy Egyetlen), resourceType (például VirtualMachines), lookBackPeriod (Last7Days, Last30Days, Last60Days).
‑CommitmentDiscountScope Opcionális. Foglalási hatókör szűrője, amelyet a foglalási javaslatok exportálásakor kell használni. Más exportálási típusok esetén figyelmen kívül hagyva. Engedélyezett értékek: Megosztott, Önálló. Alapértelmezett: Megosztott.
‑CommitmentDiscountResourceType Opcionális. Foglalási erőforrástípus szűrője, amelyet a foglalási javaslatok exportálásakor kell használni. Más exportálási típusok esetén figyelmen kívül hagyva. Alapértelmezett: VirtualMachines.
‑CommitmentDiscountLookback Opcionális. Foglalási erőforrástípus szűrője, amelyet a foglalási javaslatok exportálásakor kell használni. Más exportálási típusok esetén figyelmen kívül hagyva. Megengedett értékek: 7, 30, 60. Alapértelmezett: 30.
‑Monthly Opcionális. Azt jelzi, hogy az exportálást havonta kell végrehajtani (a napi helyett). Az árak, a foglalási javaslatok és a foglalási tranzakciók figyelmen kívül hagyva. Alapértelmezett = hamis.
‑OneTime Opcionális. Azt jelzi, hogy az exportálást csak egyszer kell végrehajtani. Ha be van állítva, a kezdő/záró dátumok azok a dátumok, amelyekhez adatokat kell lekérdezni. A -Monthly beállítással együtt nem használható.
‑StartDate Opcionális. Az exportálások futtatásának kezdőnapja. Alapértelmezett = Az előző hónap első napja, ha a -OneTime be van állítva; ellenkező esetben holnap (DateTime.Now.AddDays(1)).
‑EndDate Opcionális. Az exportálás futtatásának utolsó napja. Default = A hónap utolsó napja, amely -StartDate -OneTime van beállítva; ellenkező esetben a -StartDate-től 5 évig.
‑StorageAccountId Szükséges. A tárfiók erőforrás-azonosítója az adatok exportálásához.
‑StorageContainer Opcionális. Annak a tárolónak a neve, amelybe adatokat kíván exportálni. A tároló akkor jön létre, ha nem létezik. Default = "cost-management".
‑StoragePath Opcionális. Az adatok tárolón belüli exportálásának elérési útja. Default = (hatókörazonosító).
‑DoNotPartition Opcionális. Azt jelzi, hogy az exportált adatok több fájlba legyenek-e particionálva. A particionálás a megbízhatóság érdekében ajánlott, ezért ez a beállítás letiltja a particionálást. Alapértelmezett = hamis.
‑DoNotOverwrite Opcionális. Azt jelzi, hogy felülírja-e a korábban exportált adatokat az aktuális hónapra vonatkozóan. A felülírás ajánlott a tárterület méretének és költségeinek csökkentése érdekében, így ez a lehetőség letiltja a felülírást. Ha exportálást hoz létre a FinOps Hubshoz, javasoljuk, hogy adja meg a -DoNotOverwrite lehetőséget a hibaelhárítás javítása érdekében. Alapértelmezett = hamis.
‑SystemAssignedIdentity Opcionális. Azt jelzi, hogy a felügyelt identitással kell adatokat leküldni a tárfiókba. A felügyelt identitás szükséges a tűzfal mögötti tárfiókok használatához, de engedélyek megadásához (például tulajdonoshoz) való hozzáférésre van szükség. Ha meg van adva, a rendszer felügyelt identitást használ; ellenkező esetben a felügyelt identitás nem lesz használva, és az exportálás nem tudja leküldni az adatokat egy tűzfal mögötti tárfiókba. Default = (üres).
‑Location Opcionális. A tárfiókba való adatküldéshez használt felügyelt identitáshoz használandó Azure-helyet jelzi. A felügyelt identitás szükséges a tűzfal mögötti tárfiókok használatához, de engedélyek megadásához (például tulajdonoshoz) való hozzáférésre van szükség. Ha meg van adva, a rendszer felügyelt identitást használ; ellenkező esetben a felügyelt identitás nem lesz használva, és az exportálás nem tudja leküldni az adatokat egy tűzfal mögötti tárfiókba. Default = (üres).
‑Execute Opcionális. Azt jelzi, hogy az exportálást közvetlenül a létrehozás után kell futtatni.
‑Backfill Opcionális. Az adatok exportálásához szükséges hónapok száma. Ez csak egyszer fut a létrehozáskor. A sikertelen exportálások nem lesznek újrapróbálkozottak. A -OneTime beállítása nem támogatott. Alapértelmezett = 0.
‑ApiVersion Opcionális. A Cost Management Export API meghívásához használandó API-verzió. Alapértelmezett = 2025-03-01.

Példák

Egyszeri exportálás létrehozása

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"

Létrehoz egy "Július2023OneTime" nevű új egyszeri exportálást 2023-07-01-ről2023-07-31-be adatkészlet = Tényleges értékekkel, és egyszer hajtja végre.

Napi exportálás létrehozása és futtatása

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

Létrehoz egy új, Daily-MTD nevű ütemezett exportálást a StartDate = DateTime.Now és az EndDate = 2024-12-31 használatával. Az exportálás közvetlenül a létrehozás után fut.

Havi exportálás létrehozása

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

Létrehoz egy havi jelentés nevű új havi exportálást a StartDate = 1 nappal a DateTime-tól.Now és EndDate 2024-08-15. Az exportálás közvetlenül a létrehozás után fut.

Napi exportálás és utántöltés négy hónap létrehozása

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

Létrehoz egy Napi-MTD nevű új napi exportálást a StartDate = DateTime.Now és az EndDate 5 évvel a StartDate-ből. Emellett exportálja az előző négy hónap költségadatait, és mentse az összes eredményt a megadott tárfiók tárolójába costreports .


Visszajelzés küldése

Tudassa velünk, hogyan haladunk egy gyors áttekintéssel. Ezeket a felülvizsgálatokat a FinOps-eszközök és -erőforrások fejlesztésére és bővítésére használjuk.

Ha valami konkrétat keres, szavazzon egy meglévőre, vagy hozzon létre egy új ötletet. Ossza meg ötleteit másokkal, hogy több szavazatot kapjon. A legtöbb szavazattal rendelkező ötletekre összpontosítunk.


Kapcsolódó termékek:

Kapcsolódó megoldások: