通过

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 必需。 要导出其数据的范围的资源 ID。
‑Dataset 可选。 要导出的数据集。 允许的值 = “ActualCost”， “AmortizedCost”。 默认值为“ActualCost”。
‑DatasetVersion 可选。 要导出的数据集的架构版本。 默认值 = （截至 2024 年 6 月的最新版本;例如，FocusCost 的“1.0”）。
‑DatasetFilters 可选。 用于筛选数据集的键/值对字典。 仅适用于 2023-07-01-preview 中的 ReservationRecommendations 数据集。 有效筛选器为 reservationScope（共享或单一）、resourceType（例如 VirtualMachines）、lookBackPeriod（Last7Days、Last30Days、Last60Days）。
‑Monthly 可选。 指示导出应每月执行（而不是每日）。 默认值为 false。
‑OneTime 可选。 指示导出应只执行一次。 设置后，开始日期/结束日期是查询数据的日期。 不能与 -Monthly 选项一起使用。
‑StartDate 可选。 开始运行导出的一天。 默认值 = 如果设置了 -OneTime，则为上月的第一天;否则，明天（DateTime.Now.AddDays（1））。
‑EndDate 可选。 运行导出的最后一天。 默认值 = 设置 -OneTime 时在 -StartDate 中标识的月份的最后一天;否则，从 -StartDate 开始五年。
‑StorageAccountId 必需。 要将数据导出到的存储帐户的资源 ID。
‑StorageContainer 可选。 要将数据导出到的容器的名称。 如果容器不存在，则会创建容器。 默认值为“cost-management”。
‑StoragePath 可选。 将数据导出到存储容器中的路径。 默认值 = （范围 ID）。
‑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 创建名为“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 的新每月导出，其中包含 StartDate = 1 天。 创建后立即运行导出。

创建每日导出和回填四个月

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 年创建名为 Daily-MTD 的新每日导出。 此外，导出前四个月的成本数据，并将所有结果保存在指定存储帐户的容器中 costreports 。


相关内容

相关产品：

相关解决方案：