Dela via

Kommandot New-FinOpsCostExport

  • Artikel

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

Name 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". Default = "ActualCost".
‑DatasetVersion Valfritt. Schemaversion av datauppsättningen som ska exporteras. Default = (senaste versionen från juni 2024, till exempel "1.0" 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).
‑Monthly Valfritt. Anger att exporten ska köras varje månad (i stället för varje dag). 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 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 if -OneTime is set; annars fem å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).
‑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 det anges används den hanterade identiteten. Annars används inte hanterad identitet och exporten skickar inte data till ett lagringskonto bakom en brandvägg. Standard = (tom).
‑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. Standard = false.
‑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. Den körs bara en gång vid skapandetillfället. Misslyckade exporter har inte omförsökts. Stöds inte när -OneTime har angetts. Standard = 0.
‑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. Den körs bara en gång vid skapandetillfället. Misslyckade exporter har inte omförsökts. 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.


Relaterat innehåll

Relaterade produkter:

Relaterade lösningar: