Public/Remove-ExpressionCacheProvider.ps1
|
<#
.SYNOPSIS Removes a registered ExpressionCache provider. .DESCRIPTION Removes a provider from the module’s registered provider list. Supports -WhatIf / -Confirm via ShouldProcess. If the provider spec includes an optional Deinitialize hook, it is invoked before removal (errors are logged as Verbose and do not stop removal). - Name matching is case-insensitive. - If no provider with the given name exists, a warning is written and nothing is removed. - Use -PassThru to return the removed provider object(s). .PARAMETER Name The provider name to remove (e.g., 'LocalFileSystemCache', 'Redis'). Accepts pipeline input by value (string) or by property name (objects with a Name or ProviderName property). .PARAMETER PassThru When set, outputs the removed provider object(s). Without this switch, the command is silent on success. .INPUTS System.String Objects with a Name or ProviderName property (ValueFromPipelineByPropertyName) .OUTPUTS None, unless -PassThru is specified; then PSCustomObject (the removed provider spec). .EXAMPLE # Remove by name (with confirmation prompt) Remove-ExpressionCacheProvider -Name Redis -Confirm .EXAMPLE # Preview without changing state Remove-ExpressionCacheProvider -Name LocalFileSystemCache -WhatIf .EXAMPLE # Pipe provider objects (ValueFromPipelineByPropertyName) and capture what was removed $removed = Get-ExpressionCacheProvider -Name Redis | Remove-ExpressionCacheProvider -PassThru -Confirm:$false .EXAMPLE # Remove multiple by name via the pipeline 'Redis','LocalFileSystemCache' | Remove-ExpressionCacheProvider -Confirm:$false .EXAMPLE # Suppress the "not found" warning if the provider may not exist Remove-ExpressionCacheProvider -Name 'DoesNotExist' -WarningAction SilentlyContinue .NOTES - If the provider spec exposes a Deinitialize function, it is invoked prior to removal. Failures during deinitialization are written as Verbose messages. - This command updates module state ($script:RegisteredStorageProviders). .LINK Add-ExpressionCacheProvider Get-ExpressionCacheProvider Clear-ExpressionCache about_CommonParameters #> function Remove-ExpressionCacheProvider { [CmdletBinding(SupportsShouldProcess = $true, ConfirmImpact = 'Low')] param( [Parameter(Mandatory, ValueFromPipeline, ValueFromPipelineByPropertyName)] [Alias('ProviderName')] [ValidateNotNullOrEmpty()] [string]$Name, [switch]$PassThru ) begin { $removed = @() } process { $matchesFound = $script:RegisteredStorageProviders | Where-Object { $_.Name -eq $Name } if (-not $matchesFound) { Write-Warning "ExpressionCache: No provider named '$Name'." return } foreach ($prov in $matchesFound) { if ($PSCmdlet.ShouldProcess($prov.Name, 'Remove storage provider')) { # Optional teardown hook (if you add one in provider specs later) if ($prov.PSObject.Properties.Name -contains 'Deinitialize' -and $prov.Deinitialize) { try { & $prov.Deinitialize } catch { Write-Verbose "Deinitialize failed for '$($prov.Name)': $_" } } # Remove this specific instance $script:RegisteredStorageProviders = @($script:RegisteredStorageProviders | Where-Object { $_ -ne $prov }) if ($PassThru) { $removed += , $prov } } } } end { if ($PassThru -and $removed) { $removed } } } |