Perintah New-FinOpsCostExport

Perintah New-FinOpsCostExport membuat ekspor Cost Management baru untuk cakupan yang ditentukan.

Perintah ini diuji dengan versi API berikut:

  • 2025-03-01 (default) – Versi GA untuk FocusCost dan himpunan data lainnya.
  • 2023-07-01-preview
  • 2023-08-01

Sintaks

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

Parameter

Nama Deskripsi
‑Name Harus diisi. Nama ekspor.
‑Scope Harus diisi. ID sumber daya cakupan untuk mengekspor data.
‑Dataset Opsional. Himpunan data untuk diekspor. Nilai yang diizinkan = "ActualCost", "AmortizedCost", "FocusCost", "PriceSheet", "ReservationDetails", "ReservationRecommendations", "ReservationTransactions". Default = "FocusCost".
‑DatasetVersion Opsional. Versi skema himpunan data yang akan diekspor. Default = "1.2-preview" (hanya berlaku untuk FocusCost).
‑DatasetFilters Opsional. Kamus pasangan kunci/nilai untuk memfilter himpunan data. Hanya berlaku untuk himpunan data ReservationRecommendations dalam pratinjau 2023-07-01 atau yang lebih baru. Filter yang valid adalah reservationScope (Bersama atau Tunggal), resourceType (misalnya, VirtualMachines), lookBackPeriod (Last7Days, Last30Days, Last60Days).
‑CommitmentDiscountScope Opsional. Filter cakupan reservasi untuk digunakan saat mengekspor rekomendasi reservasi. Diabaikan untuk jenis ekspor lainnya. Nilai yang diizinkan: Bersama, Tunggal. Default: Bersama.
‑CommitmentDiscountResourceType Opsional. Filter jenis sumber daya reservasi untuk digunakan saat mengekspor rekomendasi reservasi. Diabaikan untuk jenis ekspor lainnya. Default: VirtualMachines.
‑CommitmentDiscountLookback Opsional. Filter jenis sumber daya reservasi untuk digunakan saat mengekspor rekomendasi reservasi. Diabaikan untuk jenis ekspor lainnya. Nilai yang diizinkan: 7, 30, 60. Default: 30.
‑Monthly Opsional. Menunjukkan bahwa ekspor harus dijalankan setiap bulan (bukan harian). Diabaikan untuk harga, rekomendasi reservasi, dan transaksi reservasi. Default = false.
‑OneTime Opsional. Menunjukkan bahwa ekspor hanya boleh dijalankan sekali. Saat diatur, tanggal mulai/selesai adalah tanggal untuk mengkueri data. Tidak dapat digunakan bersama dengan opsi -Monthly.
‑StartDate Opsional. Hari untuk mulai menjalankan ekspor. Default = Hari pertama bulan sebelumnya jika -OneTime diatur; jika tidak, besok (DateTime.Now.AddDays(1)).
‑EndDate Opsional. Hari terakhir untuk menjalankan ekspor. Default = Hari terakhir bulan yang diidentifikasi dalam -StartDate jika -OneTime diatur; jika tidak, 5 tahun dari -StartDate.
‑StorageAccountId Harus diisi. ID sumber daya akun penyimpanan untuk mengekspor data.
‑StorageContainer Opsional. Nama kontainer yang akan diekspor datanya. Kontainer dibuat jika tidak ada. Default = "cost-management".
‑StoragePath Opsional. Jalur untuk mengekspor data ke dalam kontainer penyimpanan. Default = (ID cakupan).
‑DoNotPartition Opsional. Menunjukkan apakah akan mempartisi data yang diekspor ke dalam beberapa file. Pemartisian direkomendasikan untuk keandalan sehingga opsi ini adalah menonaktifkan partisi. Default = false.
‑DoNotOverwrite Opsional. Menunjukkan apakah akan menimpa data yang diekspor sebelumnya untuk bulan ini. Penimpaan disarankan untuk menjaga ukuran dan biaya penyimpanan tetap rendah sehingga opsi ini adalah menonaktifkan penimpaan. Jika membuat ekspor untuk hub FinOps, kami sarankan Anda menentukan opsi -DoNotOverwrite untuk meningkatkan pemecahan masalah. Default = false.
‑SystemAssignedIdentity Opsional. Menunjukkan bahwa identitas terkelola harus digunakan untuk mendorong data ke akun penyimpanan. Identitas terkelola diperlukan untuk bekerja dengan akun penyimpanan di belakang firewall tetapi memerlukan akses untuk memberikan izin (misalnya, Pemilik). Jika ditentukan, identitas terkelola akan digunakan; jika tidak, identitas terkelola tidak akan digunakan dan ekspor Anda tidak akan dapat mendorong data ke akun penyimpanan di belakang firewall. Default = (kosong).
‑Location Opsional. Menunjukkan lokasi Azure yang akan digunakan untuk identitas terkelola yang digunakan untuk mendorong data ke akun penyimpanan. Identitas terkelola diperlukan untuk bekerja dengan akun penyimpanan di belakang firewall tetapi memerlukan akses untuk memberikan izin (misalnya, Pemilik). Jika ditentukan, identitas terkelola akan digunakan; jika tidak, identitas terkelola tidak akan digunakan dan ekspor Anda tidak akan dapat mendorong data ke akun penyimpanan di belakang firewall. Default = (kosong).
‑Execute Opsional. Menunjukkan bahwa ekspor harus dijalankan segera setelah dibuat.
‑Backfill Opsional. Jumlah bulan untuk mengekspor data. Ini hanya dijalankan sekali pada waktu pembuatan. Ekspor yang gagal tidak dicoba kembali. Tidak didukung ketika -OneTime diatur. Default = 0.
‑ApiVersion Opsional. Versi API yang akan digunakan saat memanggil API Ekspor Cost Management. Default = 2025-03-01.

Contoh

Membuat satu kali ekspor

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"

Membuat ekspor satu kali baru yang disebut 'Juli2023OneTime' dari 2023-07-01 hingga 2023-07-31 dengan Himpunan Data = Aktual dan jalankan sekali.

Membuat dan menjalankan ekspor harian

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

Membuat ekspor terjadwal baru yang disebut Daily-MTD dengan StartDate = DateTime.Now dan EndDate = 2024-12-31. Ekspor dijalankan segera setelah pembuatan.

Membuat ekspor bulanan

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

Membuat ekspor bulanan baru yang disebut Monthly-Report with StartDate = 1 hari dari DateTime.Now dan EndDate 2024-08-15. Ekspor dijalankan segera setelah pembuatan.

Buat ekspor harian dan isi ulang empat bulan

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

Membuat ekspor harian baru yang disebut Daily-MTD dengan StartDate = DateTime.Now dan EndDate 5 tahun dari StartDate. Selain itu, ekspor data biaya untuk empat bulan sebelumnya dan simpan semua hasil dalam costreports kontainer akun penyimpanan yang ditentukan.


Berikan umpan balik

Beri tahu kami bagaimana kami melakukan peninjauan cepat. Kami menggunakan ulasan ini untuk meningkatkan dan memperluas alat dan sumber daya FinOps.

Berikan umpan balik

Jika Anda mencari sesuatu yang spesifik, pilih yang sudah ada atau buat ide baru. Bagikan ide dengan orang lain untuk mendapatkan lebih banyak suara. Kami fokus pada ide-ide dengan suara terbanyak.

Memilih atau menyarankan ide


Konten terkait

Produk terkait:

Solusi terkait:


  • Last updated on