Condividi tramite

Comando New-FinOpsCostExport

  • Articolo

Il comando New-FinOpsCostExport crea una nuova esportazione di Gestione costi per l'ambito specificato.

Questo comando è stato testato con le versioni API seguenti:

  • 2023-07-01-preview (impostazione predefinita): abilita FocusCost e altri set di dati.
  • 2023-08-01

Sintassi

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

Parametri

Nome Descrizione
‑Name Obbligatorio. Nome dell'esportazione.
‑Scope Obbligatorio. ID risorsa dell'ambito per cui esportare i dati.
‑Dataset Facoltativo. Set di dati da esportare. Valori consentiti = "ActualCost", "AmortizedCost". Valore predefinito = "ActualCost".
‑DatasetVersion Facoltativo. Versione dello schema del set di dati da esportare. Default = (versione più recente a partire da giugno 2024, ad esempio "1.0" per FocusCost).
‑DatasetFilters Facoltativo. Dizionario di coppie chiave/valore con cui filtrare il set di dati. Si applica solo al set di dati ReservationRecommendations nel 2023-07-01-preview. I filtri validi sono reservationScope (Condiviso o Singolo), resourceType (ad esempio VirtualMachines), lookBackPeriod (Last7Days, Last30Days, Last60Days).
‑Monthly Facoltativo. Indica che l'esportazione deve essere eseguita mensilmente (anziché giornaliera). Impostazione predefinita = false.
‑OneTime Facoltativo. Indica che l'esportazione deve essere eseguita una sola volta. Se impostata, le date di inizio/fine sono le date per cui eseguire query sui dati. Non è possibile usare con l'opzione -Monthly.
‑StartDate Facoltativo. Giorno in cui iniziare l'esecuzione delle esportazioni. Valore predefinito = Primo giorno del mese precedente se è impostato -OneTime; in caso contrario, domani (DateTime.Now.AddDays(1)).
‑EndDate Facoltativo. Ultimo giorno per eseguire l'esportazione. Default = Ultimo giorno del mese identificato in -StartDate se è impostato -OneTime; in caso contrario, cinque anni da -StartDate.
‑StorageAccountId Obbligatorio. ID risorsa dell'account di archiviazione in cui esportare i dati.
‑StorageContainer Facoltativo. Nome del contenitore in cui esportare i dati. Il contenitore viene creato se non esiste. Default = "cost-management".
‑StoragePath Facoltativo. Percorso in cui esportare i dati all'interno del contenitore di archiviazione. Valore predefinito = (ID ambito).
‑Location Facoltativo. Indica la posizione di Azure da usare per l'identità gestita usata per eseguire il push dei dati nell'account di archiviazione. L'identità gestita è necessaria per lavorare con gli account di archiviazione dietro un firewall, ma richiedere l'accesso per concedere le autorizzazioni, ad esempio Proprietario. Se specificato, viene usata l'identità gestita; in caso contrario, l'identità gestita non viene usata e l'esportazione non esegue il push dei dati in un account di archiviazione dietro un firewall. Valore predefinito = (vuoto).
‑DoNotPartition Facoltativo. Indica se partizionare i dati esportati in più file. Il partizionamento è consigliato per l'affidabilità, quindi questa opzione consiste nel disabilitare il partizionamento. Impostazione predefinita = false.
‑DoNotOverwrite Facoltativo. Indica se sovrascrivere i dati esportati in precedenza per il mese corrente. È consigliabile sovrascrivere le dimensioni di archiviazione e ridurre i costi, quindi questa opzione consiste nel disabilitare la sovrascrittura. Impostazione predefinita = false.
‑Execute Facoltativo. Indica che l'esportazione deve essere eseguita immediatamente dopo la creazione.
‑Backfill Facoltativo. Numero di mesi per cui esportare i dati. Viene eseguito una sola volta in fase di creazione. Le esportazioni non riuscite non vengono rivalutate. Non supportato quando è impostato -OneTime. Valore predefinito = 0.
‑Execute Facoltativo. Indica che l'esportazione deve essere eseguita immediatamente dopo la creazione.
‑Backfill Facoltativo. Numero di mesi per cui esportare i dati. Viene eseguito una sola volta in fase di creazione. Le esportazioni non riuscite non vengono rivalutate. Non supportato quando è impostato -OneTime. Valore predefinito = 0.
‑ApiVersion Facoltativo. Versione dell'API da usare quando si chiama l'API Esportazioni di Gestione costi. Valore predefinito = 2023-07-01-preview.

Esempi

Creare un'esportazione una sola volta

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"

Crea una nuova esportazione una volta denominata "July2023OneTime" dal 2023-07-01 al 2023-07-31 con Dataset = Actual ed eseguirla una sola volta.

Creare ed eseguire un'esportazione giornaliera

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

Crea una nuova esportazione pianificata denominata Daily-MTD con StartDate = DateTime.Now e EndDate = 2024-12-31. L'esportazione viene eseguita immediatamente dopo la creazione.

Creare un'esportazione mensile

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

Crea una nuova esportazione mensile denominata Monthly-Report con StartDate = 1 giorno da DateTime.Now e EndDate 2024-08-15. L'esportazione viene eseguita immediatamente dopo la creazione.

Creare l'esportazione giornaliera e il backfill quattro mesi

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

Crea una nuova esportazione giornaliera denominata Daily-MTD con StartDate = DateTime.Now e EndDate 5 anni da StartDate. Inoltre, esportare i dati sui costi per i quattro mesi precedenti e salvare tutti i risultati nel costreports contenitore dell'account di archiviazione specificato.


Contenuto correlato

Prodotti correlati:

Soluzioni correlate: