[PowerShell] Get-FinOpsHubReport

📝 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

ℹ️ 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.

Start by reviewing Get-FinOpsToolkitVersion and the Releases API linked in the issue to understand release and PBIX metadata. Define the Name, Version, and Preview behavior, then verify the command returns the listed report properties, including download and release details, for the applicable FinOps hub version.