[PowerShell] Get-FinOpsHubReport

[flanakin]

📝 Scenario

As a hub admin, I need to discover what Power BI reports are available in order to download them

💎 Solution

Create a Get-FinOpsHubReport command to get a list of available FinOps hub reports.

Synopsis

Gets details about Power BI reports available for FinOps hubs.

Syntax

Get-FinOpsHubReport `
    [-Name] <string> `
    [[-Version] <string>] `
    [-Preview]

Description

The Get-FinOpsHubReport command gets a list of Power BI reports that are available for FinOps hubs.

Parameters

Parameter	Description
-Name	Optional. Name of the Power BI report to get details about. Default = "*".
-Version	Optional. FinOps hub version to get reports for. Default = "latest".
-Preview	Optional. Indicates whether to include preview releases when -Version is "latest". Ignored when a specific version is specified. Default = false.

ℹ️ Additional info

Use Get-FinOpsToolkitVersion to get the release details. Refer to the Releases API for more details about what's available in case details are getting trimmed today. PBIX files are saved there. Return a list of reports with the following properties:

• Name (e.g., "CostSummary")
• FileName (e.g., "CostSummary.pbix")
• FileSize
• DownloadUrl
• DocumentationUrl (e.g., "https://aka.ms/finops/toolkit/costsummary")
• ReleaseName
• ReleaseVersion
• ReleaseUrl
• DownloadCount
• PublishDate
• UpdateDate

🙋‍♀️ Ask for the community

We could use your help:

1. Please vote this issue up (👍) to prioritize it.
2. Are there any other properties you expect to see per report?
3. Are there any parameters that are missing?
4. Leave comments to help us solidify the vision.