次の方法で共有

New-FinOpsCostExport コマンド

  • [アーティクル]

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

Parameters

件名 説明
‑Name 必須。 エクスポートの名前。
‑Scope 必須。 データをエクスポートするスコープのリソース ID。
‑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 省略可能。 エクスポートを 1 回だけ実行することを示します。 設定すると、開始日/終了日はデータのクエリを実行する日付になります。 -Monthly オプションと共に使用することはできません。
‑StartDate 省略可能。 エクスポートの実行を開始する日。 -OneTime が設定されている場合、既定値は前月の最初の日です。それ以外の場合は、tomorrow (DateTime.Now.AddDays(1))。
‑EndDate 省略可能。 エクスポートを実行する最終日。 Default = -OneTime が設定されている場合、-StartDate で識別される月の最終日。それ以外の場合は、-StartDate から 5 年。
‑StorageAccountId 必須。 データをエクスポートするストレージ アカウントのリソース ID。
‑StorageContainer 省略可能。 データをエクスポートするコンテナーの名前。 コンテナーが存在しない場合は作成されます。 既定値 = "cost-management"。
‑StoragePath 省略可能。 ストレージ コンテナー内にデータをエクスポートするパス。 既定値 = (スコープ ID)。
‑Location 省略可能。 ストレージ アカウントにデータをプッシュするために使用するマネージド ID に使用する Azure の場所を示します。 マネージド ID は、ファイアウォールの背後にあるストレージ アカウントを操作するために必要ですが、アクセス許可を付与するためのアクセス権 (所有者など) が必要です。 指定した場合、マネージド ID が使用されます。それ以外の場合、マネージド ID は使用されず、エクスポートによってファイアウォールの背後にあるストレージ アカウントにデータがプッシュされることはありません。 既定値 = (空)。
‑DoNotPartition 省略可能。 エクスポートしたデータを複数のファイルにパーティション分割するかどうかを示します。 このオプションではパーティション分割を無効にするため、信頼性のためにパーティション分割をお勧めします。 既定値 = false。
‑DoNotOverwrite 省略可能。 現在の月の以前にエクスポートされたデータを上書きするかどうかを示します。 上書きは、ストレージ サイズとコストを抑えるために推奨されるため、このオプションでは上書きを無効にします。 既定値 = false。
‑Execute 省略可能。 作成した直後にエクスポートを実行する必要があることを示します。
‑Backfill 省略可能。 データをエクスポートする月数。 作成時に 1 回だけ実行されます。 失敗したエクスポートは再試行されません。 -OneTime が設定されている場合はサポートされません。 既定値 = 0。
‑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-01 2023-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 保存します。


関連するコンテンツ

関連製品:

関連するソリューション: