Delen via

Opdracht New-FinOpsCostExport

  • Artikel

Met de opdracht New-FinOpsCostExport maakt u een nieuwe Cost Management-export voor het opgegeven bereik.

Deze opdracht is getest met de volgende API-versies:

  • 2023-07-01-preview (standaard): hiermee schakelt u FocusCost en andere gegevenssets in.
  • 2023-08-01

Syntaxis

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

Parameters

Name Beschrijving
‑Name Vereist. Naam van de export.
‑Scope Vereist. Resource-id van het bereik waarvoor gegevens moeten worden geëxporteerd.
‑Dataset Optioneel. Te exporteren gegevensset. Toegestane waarden = "ActualCost", "AmortizedCost". Default = "ActualCost".
‑DatasetVersion Optioneel. Schemaversie van de gegevensset die moet worden geëxporteerd. Default = (nieuwste versie vanaf juni 2024, bijvoorbeeld '1.0' voor FocusCost).
‑DatasetFilters Optioneel. Woordenlijst van sleutel-/waardeparen om de gegevensset mee te filteren. Alleen van toepassing op de gegevensset ReservationRecommendations in de preview-versie van 2023-07-01. Geldige filters zijn reservationScope (Shared of Single), resourceType (bijvoorbeeld VirtualMachines), lookBackPeriod (Last7Days, Last30Days, Last60Days).
‑Monthly Optioneel. Geeft aan dat de export maandelijks moet worden uitgevoerd (in plaats van dagelijks). Standaard = onwaar.
‑OneTime Optioneel. Geeft aan dat de export slechts één keer moet worden uitgevoerd. Wanneer deze optie is ingesteld, zijn de begin- en einddatums de datums waarop gegevens moeten worden opgevraagd. Kan niet worden gebruikt met de optie -Monthly.
‑StartDate Optioneel. Dag om te beginnen met het uitvoeren van exports. Standaard = Eerste dag van de vorige maand als -OneTime is ingesteld; anders, morgen (DateTime.Now.AddDays(1)).
‑EndDate Optioneel. Laatste dag om de export uit te voeren. Default = Laatste dag van de maand die is geïdentificeerd in -StartDate als -OneTime is ingesteld; anders vijf jaar vanaf -StartDate.
‑StorageAccountId Vereist. Resource-id van het opslagaccount waar gegevens naar moeten worden geëxporteerd.
‑StorageContainer Optioneel. De naam van de container waar gegevens naar moeten worden geëxporteerd. De container wordt gemaakt als deze niet bestaat. Default = "cost-management".
‑StoragePath Optioneel. Pad naar het exporteren van gegevens naar binnen de opslagcontainer. Default = (bereik-id).
‑Location Optioneel. Geeft de Azure-locatie aan die moet worden gebruikt voor de beheerde identiteit die wordt gebruikt om gegevens naar het opslagaccount te pushen. Beheerde identiteit is vereist om te kunnen werken met opslagaccounts achter een firewall, maar toegang nodig om machtigingen te verlenen (bijvoorbeeld Eigenaar). Indien opgegeven, wordt de beheerde identiteit gebruikt; Anders wordt de beheerde identiteit niet gebruikt en pusht uw export geen gegevens naar een opslagaccount achter een firewall. Default = (leeg).
‑DoNotPartition Optioneel. Geeft aan of de geëxporteerde gegevens moeten worden gepartitioneerde in meerdere bestanden. Partitionering wordt aanbevolen voor betrouwbaarheid, dus deze optie is om partitionering uit te schakelen. Standaard = onwaar.
‑DoNotOverwrite Optioneel. Hiermee wordt aangegeven of eerder geëxporteerde gegevens voor de huidige maand moeten worden overschreven. Overschrijven wordt aanbevolen om de opslaggrootte en -kosten omlaag te houden, dus deze optie is het uitschakelen van overschrijven. Standaard = onwaar.
‑Execute Optioneel. Geeft aan dat de export direct na het maken moet worden uitgevoerd.
‑Backfill Optioneel. Aantal maanden waarvoor de gegevens moeten worden geëxporteerd. Deze wordt slechts eenmaal uitgevoerd tijdens het maken. Mislukte exports worden niet opnieuw uitgevoerd. Niet ondersteund wanneer -OneTime is ingesteld. Standaard = 0.
‑Execute Optioneel. Geeft aan dat de export direct na het maken moet worden uitgevoerd.
‑Backfill Optioneel. Aantal maanden waarvoor de gegevens moeten worden geëxporteerd. Deze wordt slechts eenmaal uitgevoerd tijdens het maken. Mislukte exports worden niet opnieuw uitgevoerd. Niet ondersteund wanneer -OneTime is ingesteld. Standaard = 0.
‑ApiVersion Optioneel. API-versie die moet worden gebruikt bij het aanroepen van de Cost Management Exports-API. Standaard = 2023-07-01-preview.

Voorbeelden

Eenmalige export maken

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"

Hiermee maakt u een nieuwe eenmalige export met de naam Juli2023OneTime van 2023-07-01 tot 2023-07-31 met Gegevensset = Werkelijk en voert u deze eenmaal uit.

Een dagelijkse export maken en uitvoeren

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

Hiermee maakt u een nieuwe geplande export met de naam Daily-MTD met StartDate = DateTime.Now and EndDate = 2024-12-31. Exporteren wordt direct na het maken uitgevoerd.

Een maandelijkse export maken

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

Hiermee maakt u een nieuwe maandelijkse export met de naam Monthly-Report met StartDate = 1 dag vanaf DateTime.Now en EndDate 2024-08-15. Exporteren wordt direct na het maken uitgevoerd.

Dagelijkse export en backfill vier maanden maken

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

Hiermee maakt u een nieuwe dagelijkse export met de naam Daily-MTD met StartDate = DateTime.Now en EndDate 5 jaar vanaf StartDate. Daarnaast exporteert u kostengegevens voor de afgelopen vier maanden en slaat u alle resultaten op in costreports de container van het opgegeven opslagaccount.


Gerelateerde inhoud

Gerelateerde producten:

Verwante oplossingen: