New-FinOpsCostExport コマンド

2025-04-03

New-FinOpsCostExport コマンドは、指定したスコープの新しい Cost Management エクスポートを作成します。

このコマンドは、次の 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"、"FocusCost"、"PriceSheet"、"ReservationDetails"、"ReservationRecommendations"、"ReservationTransactions"。既定値 = "FocusCost"。
`‑DatasetVersion`	省略可能。エクスポートするデータセットのスキーマバージョン。既定値 = "1.0" (FocusCost にのみ適用されます)。
`‑DatasetFilters`	省略可能。データセットをフィルター処理するキーと値のペアのディクショナリ。 2023-07-01-preview の ReservationRecommendations データセットにのみ適用されます。有効なフィルターは、reservationScope (Shared または Single)、resourceType (VirtualMachines など)、lookBackPeriod (Last7Days、Last30Days、Last60Days) です。
`‑CommitmentDiscountScope`	省略可能。予約の推奨事項をエクスポートするときに使用する予約スコープフィルター。他のエクスポートの種類では無視されます。使用できる値: Shared、Single。既定値: 共有。
`‑CommitmentDiscountResourceType`	省略可能。予約の推奨事項をエクスポートするときに使用する予約リソースの種類フィルター。他のエクスポートの種類では無視されます。既定値: VirtualMachines。
`‑CommitmentDiscountLookback`	省略可能。予約の推奨事項をエクスポートするときに使用する予約リソースの種類フィルター。他のエクスポートの種類では無視されます。使用できる値: 7、30、60。既定値: 30。
`‑Monthly`	省略可能。エクスポートを毎日ではなく毎月実行する必要があることを示します。価格、予約の推奨事項、および予約トランザクションでは無視されます。既定値 = false。
`‑OneTime`	省略可能。エクスポートを 1 回だけ実行することを示します。設定すると、開始日/終了日はデータのクエリを実行する日付になります。 -Monthly オプションと組み合わせて使用することはできません。
`‑StartDate`	省略可能。エクスポートの実行を開始する日。 -OneTime が設定されている場合、既定値は前月の最初の日です。それ以外の場合は、tomorrow (DateTime.Now.AddDays(1))。
`‑EndDate`	省略可能。エクスポートを実行する最終日。既定値 = -OneTime が設定されている場合、-StartDate で識別される月の最終日。それ以外の場合は、-StartDate から 5 年。
`‑StorageAccountId`	必須。データをエクスポートするストレージアカウントのリソース ID。
`‑StorageContainer`	省略可能。データをエクスポートするコンテナーの名前。コンテナーが存在しない場合は作成されます。既定値 = "cost-management"。
`‑StoragePath`	省略可能。ストレージコンテナー内にデータをエクスポートするパス。既定値 = (スコープ ID)。
`‑DoNotPartition`	省略可能。エクスポートしたデータを複数のファイルにパーティション分割するかどうかを示します。このオプションではパーティション分割を無効にするため、信頼性のためにパーティション分割をお勧めします。既定値 = false。
`‑DoNotOverwrite`	省略可能。現在の月の以前にエクスポートされたデータを上書きするかどうかを示します。上書きは、ストレージサイズとコストを抑えるために推奨されるため、このオプションでは上書きを無効にします。 FinOps ハブのエクスポートを作成する場合は、トラブルシューティングを改善するために -DoNotOverwrite オプションを指定することをお勧めします。既定値 = false。
`‑SystemAssignedIdentity`	省略可能。マネージド ID を使用してストレージアカウントにデータをプッシュする必要があることを示します。マネージド ID は、ファイアウォールの背後にあるストレージアカウントを操作するために必要ですが、アクセス許可を付与するためのアクセス権 (所有者など) が必要です。指定した場合、マネージド ID が使用されます。それ以外の場合、マネージド ID は使用されず、エクスポートはファイアウォールの背後にあるストレージアカウントにデータをプッシュできなくなります。既定値 = (空)。
`‑Location`	省略可能。ストレージアカウントにデータをプッシュするために使用するマネージド ID に使用する Azure の場所を示します。マネージド ID は、ファイアウォールの背後にあるストレージアカウントを操作するために必要ですが、アクセス許可を付与するためのアクセス権 (所有者など) が必要です。指定した場合、マネージド ID が使用されます。それ以外の場合、マネージド ID は使用されず、エクスポートはファイアウォールの背後にあるストレージアカウントにデータをプッシュできなくなります。既定値 = (空)。
`‑Execute`	省略可能。作成した直後にエクスポートを実行する必要があることを示します。
`‑Backfill`	省略可能。データをエクスポートする月数。これは、作成時に 1 回だけ実行されます。失敗したエクスポートは再試行されません。 -OneTime が設定されている場合はサポートされません。既定値 = 0。
`‑ApiVersion`	省略可能。 Cost Management Exports API を呼び出すときに使用する API バージョン。既定値 = 2023-07-01-preview。

例

1 回限りエクスポートを作成する

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"

"July2023OneTime" という名前の新しい 1 回限りのエクスポートを 2023-07-012023-07-31 に作成し Dataset = Actual で 1 回実行します。

毎日のエクスポートを作成して実行する

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 から StartDate = 1 日の Monthly-Report という名前の新しい月次エクスポートを作成します。エクスポートは作成直後に実行されます。

毎日のエクスポートとバックフィルを 4 か月作成する

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 という新しい日次エクスポートを作成します。さらに、過去 4 か月間のコストデータをエクスポートし、すべての結果を指定したストレージアカウントのコンテナー costreports 保存します。

フィードバックを送る

クイックレビューを使用して、どのように取り組んでいるかをお知らせください。これらのレビューを使用して、FinOps のツールとリソースを改善および拡張します。

フィードバック

特定の情報をお探しの場合は、既存のアイデアに投票するか、新しいアイデアを作成してください。他のユーザーとアイデアを共有して、投票を増やしましょう。投票数が最も多いアイデアに焦点を当てています。

アイデアに投票または提案