Partager via

Commande New-FinOpsCostExport

  • Article

La commande New-FinOpsCostExport crée une exportation Cost Management pour l’étendue spécifiée.

Cette commande a été testée avec les versions d’API suivantes :

  • 2023-07-01-preview (par défaut) : active FocusCost et d’autres jeux de données.
  • 2023-08-01

Syntaxe

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

Paramètres

Nom Description
‑Name Obligatoire. Nom de l’exportation.
‑Scope Obligatoire. ID de ressource de l’étendue pour laquelle exporter des données.
‑Dataset facultatif. Jeu de données à exporter. Valeurs autorisées = « ActualCost », « AmortizedCost ». Default = « ActualCost ».
‑DatasetVersion facultatif. Version de schéma du jeu de données à exporter. Valeur par défaut = (dernière version de juin 2024 ; par exemple, « 1.0 » pour FocusCost).
‑DatasetFilters facultatif. Dictionnaire de paires clé/valeur avec lesquelles filtrer le jeu de données. S’applique uniquement au jeu de données ReservationRecommendations en 2023-07-01-preview. Les filtres valides sont reservationScope (partagé ou unique), resourceType (par exemple, VirtualMachines), lookBackPeriod (Last7Days, Last30Days, Last60Days).
‑Monthly facultatif. Indique que l’exportation doit être exécutée mensuellement (au lieu de quotidienne). Valeur par défaut ; False.
‑OneTime facultatif. Indique que l’exportation ne doit être exécutée qu’une seule fois. Quand elle est définie, les dates de début/fin sont les dates pour laquelle interroger les données. Impossible d’utiliser l’option -Monthly.
‑StartDate facultatif. Jour pour commencer à exécuter des exportations. Valeur par défaut = Premier jour du mois précédent si -OneTime est défini ; sinon, demain (DateTime.Now.AddDays(1)).
‑EndDate facultatif. Dernier jour pour exécuter l’exportation. Valeur par défaut = Dernier jour du mois identifié dans -StartDate si -OneTime est défini ; sinon, cinq ans à partir de -StartDate.
‑StorageAccountId Obligatoire. ID de ressource du compte de stockage vers lequel exporter des données.
‑StorageContainer facultatif. Nom du conteneur vers lequel exporter des données. Le conteneur est créé s’il n’existe pas. Default = « cost-management ».
‑StoragePath facultatif. Chemin d’accès pour exporter des données dans le conteneur de stockage. Valeur par défaut = (ID d’étendue).
‑Location facultatif. Indique l’emplacement Azure à utiliser pour l’identité managée utilisée pour envoyer des données au compte de stockage. L’identité managée est requise pour travailler avec des comptes de stockage derrière un pare-feu, mais nécessite l’accès pour accorder des autorisations (par exemple, Propriétaire). Si elle est spécifiée, l’identité managée est utilisée ; sinon, l’identité managée n’est pas utilisée et votre exportation n’envoie pas de données à un compte de stockage derrière un pare-feu. Default = (vide).
‑DoNotPartition facultatif. Indique s’il faut partitionner les données exportées dans plusieurs fichiers. Le partitionnement est recommandé pour la fiabilité. Cette option consiste donc à désactiver le partitionnement. Valeur par défaut ; False.
‑DoNotOverwrite facultatif. Indique s’il faut remplacer les données précédemment exportées pour le mois en cours. Le remplacement est recommandé pour réduire la taille du stockage et les coûts. Cette option consiste donc à désactiver le remplacement. Valeur par défaut ; False.
‑Execute facultatif. Indique que l’exportation doit être exécutée immédiatement après la création.
‑Backfill facultatif. Nombre de mois pour lequel exporter les données. Elle s’exécute une seule fois au moment de la création. Les exportations ayant échoué ne sont pas réatempestées. Non pris en charge lorsque -OneTime est défini. Valeur par défaut = 0.
‑Execute facultatif. Indique que l’exportation doit être exécutée immédiatement après la création.
‑Backfill facultatif. Nombre de mois pour lequel exporter les données. Elle s’exécute une seule fois au moment de la création. Les exportations ayant échoué ne sont pas réatempestées. Non pris en charge lorsque -OneTime est défini. Valeur par défaut = 0.
‑ApiVersion facultatif. Version de l’API à utiliser lors de l’appel de l’API Cost Management Exports. Valeur par défaut = 2023-07-01-preview.

Exemples

Créer une exportation à usage unique

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"

Crée une exportation unique appelée « juillet2023OneTime » de 2023-07-01 à 2023-07-31 avec Dataset = Réel et exécutez-la une seule fois.

Créer et exécuter une exportation quotidienne

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

Crée une exportation planifiée appelée Daily-MTD avec StartDate = DateTime.Now et EndDate = 2024-12-31. L’exportation est exécutée immédiatement après la création.

Créer une exportation mensuelle

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

Crée une exportation mensuelle appelée Rapport mensuel avec StartDate = 1 jour à partir de DateTime.Now et EndDate 2024-08-15. L’exportation est exécutée immédiatement après la création.

Créer une exportation quotidienne et remplir quatre mois

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

Crée une exportation quotidienne appelée Daily-MTD avec StartDate = DateTime.Now et EndDate 5 ans à partir de StartDate. En outre, exportez les données de coût des quatre mois précédents et enregistrez tous les résultats dans costreports le conteneur du compte de stockage spécifié.


Contenu connexe

Produits connexes :

Solutions connexes :