Udostępnij za pośrednictwem

Polecenie New-FinOpsCostExport

  • Artykuł

Polecenie New-FinOpsCostExport tworzy nowy eksport usługi Cost Management dla określonego zakresu.

To polecenie zostało przetestowane przy użyciu następujących wersji interfejsu API:

  • 2023-07-01-preview (ustawienie domyślne) — włącza fokusCost i inne zestawy danych.
  • 2023-08-01

Składnia

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

Parametry

Nazwa/nazwisko opis
‑Name Wymagane. Nazwa eksportu.
‑Scope Wymagany. Identyfikator zasobu zakresu do wyeksportowania danych.
‑Dataset Opcjonalny. Zestaw danych do wyeksportowania. Dozwolone wartości = "ActualCost", "AmortizedCost". Default = "ActualCost".
‑DatasetVersion Opcjonalny. Wersja schematu zestawu danych do wyeksportowania. Default = (najnowsza wersja z czerwca 2024 r., na przykład "1.0" dla focusCost).
‑DatasetFilters Opcjonalny. Słownik par klucz/wartość do filtrowania zestawu danych za pomocą. Dotyczy tylko zestawu danych ReservationRecommendations w wersji 2023-07-01-preview. Prawidłowe filtry to reservationScope (udostępnione lub pojedyncze), resourceType (na przykład VirtualMachines), lookBackPeriod (Last7Days, Last30Days, Last60Days).
‑Monthly Opcjonalny. Wskazuje, że eksport powinien być wykonywany co miesiąc (zamiast codziennie). Wartość domyślna : false.
‑OneTime Opcjonalny. Wskazuje, że eksport powinien być wykonywany tylko raz. Po ustawieniu daty rozpoczęcia/zakończenia to daty zapytania o dane. Nie można używać z opcją -Monthly.
‑StartDate Opcjonalny. Dzień rozpoczęcia uruchamiania eksportów. Wartość domyślna : pierwszy dzień poprzedniego miesiąca, jeśli ustawiono parametr -OneTime; w przeciwnym razie jutro (DateTime.Now.AddDays(1)).
‑EndDate Opcjonalny. Ostatni dzień uruchomienia eksportu. Wartość domyślna : Ostatni dzień miesiąca zidentyfikowany w -StartDate, jeśli ustawiono parametr -OneTime; w przeciwnym razie pięć lat od -StartDate.
‑StorageAccountId Wymagany. Identyfikator zasobu konta magazynu do wyeksportowania danych.
‑StorageContainer Opcjonalny. Nazwa kontenera do wyeksportowania danych. Kontener zostanie utworzony, jeśli nie istnieje. Ustawienie domyślne = "cost-management".
‑StoragePath Opcjonalny. Ścieżka do eksportowania danych do kontenera magazynu. Default = (identyfikator zakresu).
‑Location Opcjonalny. Wskazuje lokalizację platformy Azure do użycia dla tożsamości zarządzanej używanej do wypychania danych do konta magazynu. Tożsamość zarządzana jest wymagana do pracy z kontami magazynu za zaporą, ale wymagają dostępu do udzielania uprawnień (na przykład Właściciel). W przypadku określenia tożsamości zarządzanej jest używana; w przeciwnym razie tożsamość zarządzana nie jest używana, a eksport nie wypycha danych do konta magazynu za zaporą. Wartość domyślna = (pusta).
‑DoNotPartition Opcjonalny. Wskazuje, czy chcesz podzielić wyeksportowane dane na wiele plików. Partycjonowanie jest zalecane w celu uzyskania niezawodności, więc ta opcja polega na wyłączeniu partycjonowania. Wartość domyślna : false.
‑DoNotOverwrite Opcjonalny. Wskazuje, czy zastąpić wcześniej wyeksportowane dane w bieżącym miesiącu. Zastępowanie jest zalecane, aby zachować rozmiar magazynu i koszty w dół, aby ta opcja polegała na wyłączeniu zastępowania. Wartość domyślna : false.
‑Execute Opcjonalny. Wskazuje, że eksport powinien być uruchamiany natychmiast po utworzeniu.
‑Backfill Opcjonalny. Liczba miesięcy, dla których mają być eksportowane dane. Jest uruchamiany tylko raz w czasie tworzenia. Nieudane eksporty nie są ponownie rozdzielane. Nieobsługiwane, gdy ustawiono parametr -OneTime. Wartość domyślna : 0.
‑Execute Opcjonalny. Wskazuje, że eksport powinien być uruchamiany natychmiast po utworzeniu.
‑Backfill Opcjonalny. Liczba miesięcy, dla których mają być eksportowane dane. Jest uruchamiany tylko raz w czasie tworzenia. Nieudane eksporty nie są ponownie rozdzielane. Nieobsługiwane, gdy ustawiono parametr -OneTime. Wartość domyślna : 0.
‑ApiVersion Opcjonalny. Wersja interfejsu API do użycia podczas wywoływania interfejsu API eksportów usługi Cost Management. Ustawienie domyślne = 2023-07-01-preview.

Przykłady

Tworzenie jednorazowego eksportu

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"

Tworzy nowy jednorazowy eksport o nazwie "July2023OneTime" z 2023-07-01 do 2023-07-31 z zestawem danych = actual i wykonaj go raz.

Tworzenie i uruchamianie codziennego eksportu

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

Tworzy nowy zaplanowany eksport o nazwie Daily-MTD z wartością StartDate = DateTime.Now i EndDate = 2024-12-31. Eksport jest uruchamiany natychmiast po utworzeniu.

Tworzenie eksportu miesięcznego

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

Tworzy nowy miesięczny eksport o nazwie Monthly-Report with StartDate = 1 day from DateTime.Now i EndDate 2024-08-15. Eksport jest uruchamiany natychmiast po utworzeniu.

Tworzenie codziennego eksportu i wypełniania kopii zapasowych przez cztery miesiące

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

Tworzy nowy codzienny eksport o nazwie Daily-MTD z wartością StartDate = DateTime.Now i EndDate 5 lat od daty rozpoczęcia. Ponadto wyeksportuj dane kosztów z poprzednich czterech miesięcy i zapisz wszystkie wyniki w costreports kontenerze określonego konta magazynu.


Powiązana zawartość

Powiązane produkty:

Powiązane rozwiązania: