Dela via


Kommandot New-FinOpsCostExport

Kommandot New-FinOpsCostExport skapar en ny Cost Management-export för det angivna omfånget.

Det här kommandot testades med följande API-versioner:

  • 2023-07-01-preview (standard) – Aktiverar FocusCost och andra datauppsättningar.
  • 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>]

Parametrar

Namn beskrivning
‑Name Obligatoriskt. Namnet på exporten.
‑Scope Obligatoriskt. Resurs-ID för omfånget som du vill exportera data för.
‑Dataset Valfritt. Datauppsättning som ska exporteras. Tillåtna värden = "ActualCost", "AmortizedCost", "FocusCost", "PriceSheet", "ReservationDetails", "ReservationRecommendations", "ReservationTransactions". Standard = "FocusCost".
‑DatasetVersion Valfritt. Schemaversion av datauppsättningen som ska exporteras. Standard = "1.0" (gäller endast För FocusCost).
‑DatasetFilters Valfritt. Ordlista över nyckel-/värdepar som datauppsättningen ska filtreras med. Gäller endast för datauppsättningen ReservationRecommendations i förhandsversionen 2023-07-01. Giltiga filter är reservationScope (delad eller enskild), resourceType (till exempel VirtualMachines), lookBackPeriod (Last7Days, Last30Days, Last60Days).
‑CommitmentDiscountScope Valfritt. Filter för reservationsomfång som ska användas vid export av reservationsrekommendationer. Ignoreras för andra exporttyper. Tillåtna värden: Delad, Enskild. Standard: Delad.
‑CommitmentDiscountResourceType Valfritt. Filter för reservationsresurstyp som ska användas vid export av reservationsrekommendationer. Ignoreras för andra exporttyper. Standard: VirtualMachines.
‑CommitmentDiscountLookback Valfritt. Filter för reservationsresurstyp som ska användas vid export av reservationsrekommendationer. Ignoreras för andra exporttyper. Tillåtna värden: 7, 30, 60. Standard: 30.
‑Monthly Valfritt. Anger att exporten ska köras varje månad (i stället för varje dag). Ignoreras för priser, reservationsrekommendationer och reservationstransaktioner. Standard = false.
‑OneTime Valfritt. Anger att exporten bara ska köras en gång. När de anges är start-/slutdatumen de datum som data ska frågas efter. Det går inte att använda tillsammans med alternativet -Monthly.
‑StartDate Valfritt. Dag för att börja köra exporter. Standard = Första dagen i föregående månad om -OneTime har angetts. annars i morgon (DateTime.Now.AddDays(1)).
‑EndDate Valfritt. Sista dagen att köra exporten. Default = Sista dagen i månaden som identifieras i -StartDate om -OneTime har angetts. annars 5 år från -StartDate.
‑StorageAccountId Obligatoriskt. Resurs-ID för lagringskontot som du vill exportera data till.
‑StorageContainer Valfritt. Namnet på containern som du vill exportera data till. Containern skapas om den inte finns. Standard = "cost-management".
‑StoragePath Valfritt. Sökväg för att exportera data till i lagringscontainern. Standard = (omfångs-ID).
‑DoNotPartition Valfritt. Anger om de exporterade data ska partitioneras i flera filer. Partitionering rekommenderas för tillförlitlighet, så det här alternativet är att inaktivera partitionering. Standard = false.
‑DoNotOverwrite Valfritt. Anger om du vill skriva över tidigare exporterade data för den aktuella månaden. Överskrivning rekommenderas för att hålla lagringsstorleken och kostnaderna nere, så det här alternativet är att inaktivera överskrivning. Om du skapar en export för FinOps-hubbar rekommenderar vi att du anger det -DoNotOverwrite alternativet för att förbättra felsökningen. Standard = false.
‑SystemAssignedIdentity Valfritt. Anger att hanterad identitet ska användas för att skicka data till lagringskontot. Hanterad identitet krävs för att kunna arbeta med lagringskonton bakom en brandvägg men kräver åtkomst för att bevilja behörigheter (till exempel Ägare). Om detta anges används den hanterade identiteten. Annars används inte hanterad identitet och exporten kan inte skicka data till ett lagringskonto bakom en brandvägg. Standard = (tom).
‑Location Valfritt. Anger den Azure-plats som ska användas för den hanterade identitet som används för att skicka data till lagringskontot. Hanterad identitet krävs för att kunna arbeta med lagringskonton bakom en brandvägg men kräver åtkomst för att bevilja behörigheter (till exempel Ägare). Om detta anges används den hanterade identiteten. Annars används inte hanterad identitet och exporten kan inte skicka data till ett lagringskonto bakom en brandvägg. Standard = (tom).
‑Execute Valfritt. Anger att exporten ska köras omedelbart efter att den har skapats.
‑Backfill Valfritt. Antal månader som data ska exporteras för. Detta körs bara en gång vid skapandetillfället. Misslyckade exporter görs inte på nytt. Stöds inte när -OneTime har angetts. Standard = 0.
‑ApiVersion Valfritt. API-version som ska användas när du anropar API:et för Cost Management-export. Standard = 2023-07-01-preview.

Exempel

Skapa en engångsexport

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"

Skapar en ny engångsexport med namnet "July2023OneTime" från 2023-07-01 till 2023-07-31 med Dataset = Actual och kör den en gång.

Skapa och köra en daglig export

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

Skapar en ny schemalagd export med namnet Daily-MTD med StartDate = DateTime.Now och EndDate = 2024-12-31. Exporten körs omedelbart efter att den har skapats.

Skapa en månatlig export

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

Skapar en ny månatlig export med namnet Monthly-Report med StartDate = 1 dag från DateTime.Now och EndDate 2024-08-15. Exporten körs omedelbart efter att den har skapats.

Skapa daglig export och återfyllnad fyra månader

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

Skapar en ny daglig export med namnet Daily-MTD med StartDate = DateTime.Now och EndDate 5 år från StartDate. Exportera dessutom kostnadsdata för de senaste fyra månaderna och spara alla resultat i costreports containern för det angivna lagringskontot.


Lämna feedback

Låt oss veta hur det går med en snabb granskning. Vi använder dessa granskningar för att förbättra och utöka FinOps-verktyg och -resurser.

Om du letar efter något specifikt kan du rösta på en befintlig eller skapa en ny idé. Dela idéer med andra för att få fler röster. Vi fokuserar på idéer med flest röster.


Relaterade produkter:

Relaterade lösningar: