Functions/CSP/Portal/Set-B1APIKey.ps1
|
function Set-B1APIKey { <# .SYNOPSIS Updates an existing Infoblox Portal API Key .DESCRIPTION This function is used to update an existing API Key from the Infoblox Portal, such as disabling/enabling it. .PARAMETER User Filter the results by user_email .PARAMETER Name Filter the results by the name of the API Key .PARAMETER Type Filter the results by the API Key Type .PARAMETER State Toggle the state of the API Key .PARAMETER Object The API Key Object. Accepts pipeline input .PARAMETER Force Perform the operation without prompting for confirmation. By default, this function will not prompt for confirmation unless $ConfirmPreference is set to Medium. .EXAMPLE PS> Set-B1APIKey -User "user@domain.corp" -Name "somename" -Type "interactive" -State Enabled .FUNCTIONALITY Universal DDI .FUNCTIONALITY Authentication #> [CmdletBinding( SupportsShouldProcess, ConfirmImpact = 'Medium' )] param( [Parameter(Mandatory=$true,ParameterSetName="Default")] $Name, [Parameter(ParameterSetName="Default")] $User, [Parameter(ParameterSetName="Default")] [ValidateSet("Interactive", "Legacy", "Service")] $Type, [ValidateSet("Enabled", "Disabled")] $State, [Parameter( ValueFromPipeline = $true, ParameterSetName="Object", Mandatory=$true )] [System.Object]$Object, [Switch]$Force ) process { $ConfirmPreference = Confirm-ShouldProcess $PSBoundParameters if ($Object) { $SplitID = $Object.id.split('/') if (("$($SplitID[0])/$($SplitID[1])") -ne "identity/apikeys") { Write-Error "Error. Unsupported pipeline object. This function only supports 'identity/apikeys' objects as input" return $null } $Type = $Object.type } else { if ($Type) { $Object = Get-B1APIKey -User $User -Name $Name -Type $Type -Strict } else { $Object = Get-B1APIKey -User $User -Name $Name -Strict } if (!($Object)) { Write-Error "Unable to find API Key: $($Name)" return $null } if ($Object.count -gt 1) { Write-Error "Multiple API Keys were found, to update more than one API Keys you should pass those objects using pipe instead." return $null } } $NewObj = $Object | Select-Object * -ExcludeProperty id $APIKeyIdSplit = $Object.id -split "identity/apikeys/" if ($State) { $NewObj.state = $State.toLower() } $JSON = $NewObj | ConvertTo-Json -Depth 5 -Compress if($PSCmdlet.ShouldProcess("Update Infoblox Portal API Key`n$(JSONPretty($JSON))","Update Infoblox Portal API Key: $($NewObj.name) ($($APIKeyIdSplit[1]))",$MyInvocation.MyCommand)){ $Results = Invoke-CSP -Method PATCH -Uri "$(Get-B1CSPUrl)/v2/api_keys/$($APIKeyIdSplit[1])" -Data $JSON if ($Results | Select-Object -ExpandProperty result -EA SilentlyContinue -WA SilentlyContinue) { $Results | Select-Object -ExpandProperty result } else { $Results } } } } |