Public/Remove-FinOpsHub.ps1
|
# Copyright (c) Microsoft Corporation. # Licensed under the MIT License. <# .SYNOPSIS Delete a FinOps hub instance and optionally keep the storage account hosting cost data. .DESCRIPTION The Remove-FinOpsHub command deletes a FinOps Hub instance and optionally deletes the storage account hosting cost data. The command returns a boolean value indicating whether all resources were successfully deleted. .PARAMETER Name Required when specifying Name. Name of the FinOps Hub. .PARAMETER ResourceGroupName Optional when specifying Name. Resource Group Name for the FinOps Hub. .PARAMETER InputObject Required when specifying InputObject. Expected object is the output of Get-FinOpsHub. .PARAMETER KeepStorageAccount Optional. Indicates that the storage account associated with the FinOps Hub should be retained. .PARAMETER Force Optional. Deletes specified resources without asking for a confirmation. .EXAMPLE Remove-FinOpsHub -Name MyHub -ResourceGroupName MyRG -KeepStorageAccount Deletes a FinOps Hub named MyHub and deletes all associated resources except the storage account. #> function Remove-FinOpsHub { [CmdletBinding(SupportsShouldProcess, ConfirmImpact = 'High')] param ( [Parameter(Mandatory = $true, ParameterSetName = 'Name')] [ValidateNotNullOrEmpty()] [string]$Name, [Parameter(ParameterSetName = 'Name')] [string]$ResourceGroupName, [Parameter(Mandatory = $true, ParameterSetName = 'Object')] [ValidateNotNullOrEmpty()] [psobject]$InputObject, [Parameter(ParameterSetName = 'Name')] [Parameter(ParameterSetName = 'Object')] [switch]$KeepStorageAccount, [Parameter(ParameterSetName = 'Name')] [Parameter(ParameterSetName = 'Object')] [switch]$Force ) $context = Get-AzContext if (-not $context) { throw $script:LocalizedData.Common_ContextNotFound } try { if ($PSCmdlet.ParameterSetName -eq 'Name') { if (-not [string]::IsNullOrEmpty($ResourceGroupName)) { $hub = Get-FinOpsHub -Name $Name -ResourceGroupName $ResourceGroupName } else { $hub = Get-FinOpsHub -Name $Name $ResourceGroupName = $hub.Resources[0].ResourceGroupName } } else { $hub = $InputObject $Name = $hub.Name $ResourceGroupName = $hub.Resources[0].ResourceGroupName } if (-not $hub) { throw $script:LocalizedData.Hub_Remove_NotFound -f $Name } Write-Verbose -Message "Found FinOps Hub: $Name in resource group $ResourceGroupName" $uniqueId = Get-HubIdentifier -Collection $hub.Resources.Name $resources = Get-AzResource -ResourceGroupName $ResourceGroupName | Where-Object -FilterScript { $_.Name -like "*$uniqueId*" -and ((-not $KeepStorageAccount) -or $_.ResourceType -ne "Microsoft.Storage/storageAccounts") } Write-Verbose -Message "Filtered Resources: $($resources | ForEach-Object { $_.Name })" if ($null -eq $resources) { Write-Warning "No resources found to delete." return $false } Write-Verbose -Message "Resources to be deleted: $($resources | ForEach-Object { $_.Name })" # Temporarily set $ConfirmPreference to None if -Force is specified if ($Force) { $originalConfirmPreference = $ConfirmPreference $ConfirmPreference = 'None' } if ($PSCmdlet.ShouldProcess($Name, 'DeleteFinOpsHub')) { $success = $true foreach ($resource in $resources) { try { Write-Verbose -Message "Deleting resource: $($resource.Name)" Remove-AzResource -ResourceId $resource.ResourceId -Force:$Force -ErrorAction Stop } catch { Write-Error -Message "Failed to delete resource: $($resource.Name). Error: $_" $success = $false } } # Restore the original $ConfirmPreference if ($Force) { $ConfirmPreference = $originalConfirmPreference } return $success } } catch { Write-Error -Message "Failed to remove FinOps hub. Error: $_" if ($_.Exception.InnerException) { throw "Detailed Error: $($_.Exception.InnerException.Message)" } else { throw "Detailed Error: $($_.Exception.Message)" } } } |