Public/System/Get-SIASetting.ps1
|
function Get-SIASetting { <# .SYNOPSIS Retrieves SIA tenant feature settings. .DESCRIPTION Retrieves every SIA feature setting, or a single feature's settings when -FeatureName is specified. Requires the SiaAdmin role. .PARAMETER FeatureName The feature to retrieve settings for, e.g. 'SSHRecording' or 'StandingAccess'. CyberArk's documentation lists the supported DpaFeatureName values. .EXAMPLE Get-SIASetting Retrieves every SIA feature setting. .EXAMPLE Get-SIASetting -FeatureName 'SSHRecording' Retrieves settings for the SSH recording feature. .INPUTS None. .OUTPUTS psSIA.Setting .LINK https://api-docs.cyberark.com/secure-infra-access/docs/sia-settings-api #> [CmdletBinding()] [OutputType('psSIA.Setting')] param( [Parameter(ValueFromPipelineByPropertyName)] [string]$FeatureName ) process { $path = if ($FeatureName) { "/api/settings/$FeatureName" } else { '/api/settings' } Invoke-SIARequest -Method GET -Path $path | ConvertFrom-SIAResponse -TypeName 'psSIA.Setting' } } |