Compartir a través de

Comando New-FinOpsCostExport

  • Artículo

El comando New-FinOpsCostExport crea una nueva exportación de Cost Management para el ámbito especificado.

Este comando se probó con las siguientes versiones de API:

  • 2023-07-01-preview (valor predeterminado): habilita FocusCost y otros conjuntos de datos.
  • 2023-08-01

Sintaxis

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

Parámetros

Name Descripción
‑Name Obligatorio. Nombre de la exportación.
‑Scope Necesario. Identificador de recurso del ámbito para el que se van a exportar los datos.
‑Dataset Opcional. Conjunto de datos que se va a exportar. Valores permitidos = "ActualCost", "AmortizedCost". Valor predeterminado = "ActualCost".
‑DatasetVersion Opcional. Versión de esquema del conjunto de datos que se va a exportar. Default = (versión más reciente a partir de junio de 2024; por ejemplo, "1.0" para FocusCost).
‑DatasetFilters Opcional. Diccionario de pares clave-valor con los que filtrar el conjunto de datos. Solo se aplica al conjunto de datos ReservationRecommendations en 2023-07-01-preview. Los filtros válidos son reservationScope (compartido o único), resourceType (por ejemplo, VirtualMachines), lookBackPeriod (Last7Days, Last30Days, Last60Days).
‑Monthly Opcional. Indica que la exportación debe ejecutarse mensualmente (en lugar de diariamente). Valor predeterminado = False.
‑OneTime Opcional. Indica que la exportación solo se debe ejecutar una vez. Cuando se establece, las fechas de inicio y finalización son las fechas para las que se van a consultar los datos. No se puede usar con la opción -Monthly.
‑StartDate Opcional. Día para empezar a ejecutar exportaciones. Valor predeterminado = primer día del mes anterior si se establece -OneTime; de lo contrario, mañana (DateTime.Now.AddDays(1)).
‑EndDate Opcional. Último día para ejecutar la exportación. Valor predeterminado = Último día del mes identificado en -StartDate si se establece -OneTime; de lo contrario, cinco años de -StartDate.
‑StorageAccountId Necesario. Identificador de recurso de la cuenta de almacenamiento a la que exportar datos.
‑StorageContainer Opcional. Nombre del contenedor al que se van a exportar datos. El contenedor se crea si no existe. Valor predeterminado = "cost-management".
‑StoragePath Opcional. Ruta de acceso para exportar datos al contenedor de almacenamiento. Valor predeterminado = (id. de ámbito).
‑Location Opcional. Indica la ubicación de Azure que se va a usar para la identidad administrada que se usa para insertar datos en la cuenta de almacenamiento. La identidad administrada es necesaria para trabajar con cuentas de almacenamiento detrás de un firewall, pero requiere acceso para conceder permisos (por ejemplo, Propietario). Si se especifica, se usa la identidad administrada; De lo contrario, no se usa la identidad administrada y la exportación no inserta datos en una cuenta de almacenamiento detrás de un firewall. Valor predeterminado = (vacío).
‑DoNotPartition Opcional. Indica si se van a crear particiones de los datos exportados en varios archivos. La creación de particiones se recomienda para la confiabilidad, por lo que esta opción es deshabilitar la creación de particiones. Valor predeterminado = False.
‑DoNotOverwrite Opcional. Indica si se deben sobrescribir los datos exportados previamente para el mes actual. Se recomienda sobrescribir para mantener el tamaño de almacenamiento y los costos inactivos, por lo que esta opción es deshabilitar la sobrescritura. Valor predeterminado = False.
‑Execute Opcional. Indica que la exportación debe ejecutarse inmediatamente después de crearse.
‑Backfill Opcional. Número de meses para los que exportar los datos. Solo se ejecuta una vez en tiempo de creación. Las exportaciones con errores no se vuelven a adjuntar. No se admite cuando se establece -OneTime. Valor predeterminado = 0.
‑Execute Opcional. Indica que la exportación debe ejecutarse inmediatamente después de crearse.
‑Backfill Opcional. Número de meses para los que exportar los datos. Solo se ejecuta una vez en tiempo de creación. Las exportaciones con errores no se vuelven a adjuntar. No se admite cuando se establece -OneTime. Valor predeterminado = 0.
‑ApiVersion Opcional. Versión de LA API que se usará al llamar a la API de exportaciones de Cost Management. Valor predeterminado = 2023-07-01-preview.

Ejemplos

Creación de una exportación única

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"

Crea una nueva exportación única denominada "July2023OneTime" de 2023-07-01 a 2023-07-31 con Dataset = Real y ejecútelo una vez.

Creación y ejecución de una exportación diaria

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

Crea una nueva exportación programada denominada Daily-MTD con StartDate = DateTime.Now y EndDate = 2024-12-31. La exportación se ejecuta inmediatamente después de la creación.

Creación de una exportación mensual

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

Crea una nueva exportación mensual denominada Monthly-Report con StartDate = 1 día desde DateTime.Now y EndDate 2024-08-15. La exportación se ejecuta inmediatamente después de la creación.

Crear exportación diaria y reposición de cuatro meses

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

Crea una nueva exportación diaria denominada Daily-MTD con StartDate = DateTime.Now y EndDate 5 años a partir de StartDate. Además, exporte los datos de costos de los cuatro meses anteriores y guarde todos los resultados en costreports el contenedor de la cuenta de almacenamiento especificada.


Contenido relacionado

Productos relacionados:

Soluciones relacionadas: