共用方式為

New-FinOpsCostExport 命令

  • 發行項

New-FinOpsCostExport 命令會為指定的範圍建立新的成本管理導出。

此指令已使用下列 API 版本進行測試：

  • 2023-07-01-preview （預設值） - 啟用 FocusCost 和其他數據集。
  • 2023-08-01

語法

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

參數

名稱 描述
‑Name 必要。 匯出的名稱。
‑Scope 必要。 要匯出數據之範圍的資源標識碼。
‑Dataset 選擇性。 要匯出的數據集。 允許的值 = “ActualCost”、“AmortizedCost”。 默認值 = “ActualCost”。
‑DatasetVersion 選擇性。 要匯出之數據集的架構版本。 默認值 = （截至 2024 年 6 月的最新版本;例如 FocusCost 的 “1.0”。
‑DatasetFilters 選擇性。 用來篩選數據集的索引鍵/值組字典。 僅適用於 2023-07-01-preview 中的 ReservationRecommendations 數據集。 有效篩選條件為 reservationScope （Shared 或 Single）、resourceType（例如 VirtualMachines）、lookBackPeriod （Last7Days、Last30Days、Last60Days）。
‑Monthly 選擇性。 表示匯出應該每月執行 （而不是每日）。 預設值 = false。
‑OneTime 選擇性。 表示匯出應該只執行一次。 設定時，開始/結束日期是查詢數據的日期。 無法與 -Monthly 選項搭配使用。
‑StartDate 選擇性。 開始執行導出的一天。 預設值 = 如果已設定 -OneTime，則為前一個月的第一天;否則，明天（DateTime.Now.AddDays（1））。
‑EndDate 選擇性。 執行導出的最後一天。 Default = 如果設定了 -OneTime，則為 -StartDate 中所識別月份的最後一天;否則，從 -StartDate 開始五年。
‑StorageAccountId 必要。 要匯出數據之記憶體帳戶的資源標識碼。
‑StorageContainer 選擇性。 要匯出數據之容器的名稱。 如果容器不存在，就會建立容器。 默認值 = “cost-management”。
‑StoragePath 選擇性。 將數據匯出至記憶體容器內的路徑。 預設值 = （範圍標識元）。
‑Location 選擇性。 指出要用於將數據推送至記憶體帳戶之受控識別的 Azure 位置。 需要受控識別才能在防火牆後方使用記憶體帳戶，但需要存取權來授與許可權（例如擁有者）。 如果指定，則會使用受控識別;否則，不會使用受控識別，而且您的導出不會將數據推送至防火牆後方的記憶體帳戶。 預設值 = （空白）。
‑DoNotPartition 選擇性。 指出是否要將導出的數據分割成多個檔案。 建議針對可靠性使用數據分割，因此此選項會停用數據分割。 預設值 = false。
‑DoNotOverwrite 選擇性。 指出是否要覆寫目前月份先前導出的數據。 建議覆寫記憶體大小和成本降低，因此此選項會停用覆寫。 預設值 = false。
‑Execute 選擇性。 表示匯出應該在建立之後立即執行。
‑Backfill 選擇性。 匯出數據的月數。 它只會在建立時間執行一次。 失敗的導出不會重新嘗試。 設定 -OneTime 時不支援。 預設值 = 0。
‑Execute 選擇性。 表示匯出應該在建立之後立即執行。
‑Backfill 選擇性。 匯出數據的月數。 它只會在建立時間執行一次。 失敗的導出不會重新嘗試。 設定 -OneTime 時不支援。 預設值 = 0。
‑ApiVersion 選擇性。 呼叫成本管理匯出 API 時要使用的 API 版本。 默認值 = 2023-07-01-preview。

範例

建立一次導出

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"

從 2023-07-01 到 2023-07-31，使用 Dataset = Actual 建立名為 'July2023OneTime' 的新一次導出，並執行一次。

建立並執行每日匯出

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

使用 StartDate = DateTime.Now 和 EndDate = 2024-12-31 建立名為 Daily-MTD 的新排程導出。 建立之後會立即執行導出。

建立每月匯出

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

從 DateTime.Now 和 EndDate 2024-08-15 建立名為 Monthly-Report 的新每月匯出。 建立之後會立即執行導出。

建立每日匯出和回填四個月

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

使用 StartDate = DateTime.Now 和 EndDate 5 年從 StartDate 建立名為 Daily-MTD 的新每日導出。 此外，匯出前四個月的成本數據，並將所有結果儲存在指定記憶體帳戶的容器中 costreports 。


相關內容

相關產品：

相關解決方案：