다음을 통해 공유

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

매개 변수

속성 설명
‑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에서 5년입니다.
‑StorageAccountId 필수입니다. 데이터를 내보낼 스토리지 계정의 리소스 ID입니다.
‑StorageContainer 선택 사항. 데이터를 내보낼 컨테이너의 이름입니다. 컨테이너가 없으면 만들어집니다. 기본값 = "cost-management".
‑StoragePath 선택 사항. 스토리지 컨테이너 내에서 데이터를 내보내는 경로입니다. 기본값 = (범위 ID).
‑Location 선택 사항. 스토리지 계정에 데이터를 푸시하는 데 사용되는 관리 ID에 사용할 Azure 위치를 나타냅니다. 방화벽 뒤에 있는 스토리지 계정을 사용하려면 관리 ID가 필요하지만 권한을 부여하려면 액세스 권한이 필요합니다(예: 소유자). 지정된 경우 관리 ID가 사용됩니다. 그렇지 않으면 관리 ID가 사용되지 않으며 내보내기가 방화벽 뒤에 있는 스토리지 계정에 데이터를 푸시하지 않습니다. 기본값 = (비어 있음).
‑DoNotPartition 선택 사항. 내보낸 데이터를 여러 파일로 분할할지 여부를 나타냅니다. 이 옵션은 분할을 사용하지 않도록 설정하는 것이므로 안정성을 위해 분할하는 것이 좋습니다. 기본값은 False입니다.
‑DoNotOverwrite 선택 사항. 현재 월에 대해 이전에 내보낸 데이터를 덮어쓸지 여부를 나타냅니다. 스토리지 크기 및 비용을 낮추려면 덮어쓰기를 사용하는 것이 좋습니다. 따라서 이 옵션은 덮어쓰기를 사용하지 않도록 설정하는 것입니다. 기본값은 False입니다.
‑Execute 선택 사항. 내보내기를 만든 직후 실행해야 임을 나타냅니다.
‑Backfill 선택 사항. 데이터를 내보낼 월 수입니다. 만들기 시간에 한 번만 실행됩니다. 실패한 내보내기가 다시 시도되지 않습니다. -OneTime이 설정된 경우 지원되지 않습니다. 기본값 = 0.
‑Execute 선택 사항. 내보내기를 만든 직후 실행해야 임을 나타냅니다.
‑Backfill 선택 사항. 데이터를 내보낼 월 수입니다. 만들기 시간에 한 번만 실행됩니다. 실패한 내보내기가 다시 시도되지 않습니다. -OneTime이 설정된 경우 지원되지 않습니다. 기본값 = 0.
‑ApiVersion 선택 사항. Cost Management Exports 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"

Dataset = Actual를 사용하여 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에서 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년 후 StartDate를 사용하여 Daily-MTD라는 새 일별 내보내기를 만듭니다. 또한 이전 4개월 동안의 비용 데이터를 내보내고 모든 결과를 지정된 스토리지 계정의 컨테이너에 costreports 저장합니다.


관련 콘텐츠

관련 제품:

관련 솔루션: