Functions/Get-AllFabricCapacities.ps1
|
<#
.SYNOPSIS This function retrieves all resources of type "Microsoft.Fabric/capacities" from all resource groups in a given subscription or all subscriptions if no subscription ID is provided. .DESCRIPTION The Get-AllFabricCapacities function is used to retrieve all resources of type "Microsoft.Fabric/capacities" from all resource groups in a given subscription or all subscriptions if no subscription ID is provided. It uses the Az module to interact with Azure. .PARAMETER subscriptionID An optional parameter that specifies the subscription ID. If this parameter is not provided, the function will retrieve resources from all subscriptions. .EXAMPLE Get-AllFabricCapacities -subscriptionID "12345678-1234-1234-1234-123456789012" This command retrieves all resources of type "Microsoft.Fabric/capacities" from all resource groups in the subscription with the ID "12345678-1234-1234-1234-123456789012". .EXAMPLE Get-AllFabricCapacities This command retrieves all resources of type "Microsoft.Fabric/capacities" from all resource groups in all subscriptions. .NOTES Alias: Get-AllFabCapacities #> function Get-AllFabricCapacities { # Define aliases for the function for flexibility. [Alias("Get-AllFabCapacities")] # Define parameters for the function Param ( # Optional parameter for subscription ID [Parameter(Mandatory = $false)] [string]$subscriptionID ) # Initialize an array to store the results $res = @() # If a subscription ID is provided if ($subscriptionID) { # If the 'azToken' environment variable is null, connect to the Azure account and set the 'azToken' environment variable. if ($null -eq $env:azToken) { # Connect to the Azure account Connect-azaccount # Set the context to the provided subscription ID set-azcontext -SubscriptionId $subscriptionID # Set the 'azToken' environment variable $env:aztoken = "Bearer " + (get-azAccessToken).Token } # Set the context to the provided subscription ID set-azcontext -SubscriptionId $subscriptionID # Get all resource groups in the subscription $rgs = Get-AzResourceGroup # For each resource group, get all resources of type "Microsoft.Fabric/capacities" foreach ($r in $rgs) { # Get all resources of type "Microsoft.Fabric/capacities" and add them to the results array $res += Get-AzResource -ResourceGroupName $r.ResourceGroupName -resourcetype "Microsoft.Fabric/capacities" -ErrorAction SilentlyContinue } } else { # If no subscription ID is provided, get all subscriptions if ($null -eq $env:azToken) { # Connect to the Azure account Connect-azaccount # Set the 'azToken' environment variable $env:aztoken = "Bearer " + (get-azAccessToken).Token } # Get all subscriptions $subscriptions = Get-AzSubscription # For each subscription, set the context to the subscription ID foreach ($sub in $subscriptions) { # Set the context to the subscription ID set-azcontext -SubscriptionId $sub.id # Get all resource groups in the subscription $rgs = Get-AzResourceGroup # For each resource group, get all resources of type "Microsoft.Fabric/capacities" foreach ($r in $rgs) { # Get all resources of type "Microsoft.Fabric/capacities" and add them to the results array $res += Get-AzResource -ResourceGroupName $r.ResourceGroupName -resourcetype "Microsoft.Fabric/capacities" -ErrorAction SilentlyContinue } } } # Return the results return $res } |