Public/Account/Get-KB4AccountRiskScoreHistory.ps1
|
<# .SYNOPSIS Gets KnowBe4 account risk score history. .DESCRIPTION Retrieves risk score history for the connected KnowBe4 account. By default, KnowBe4 returns the standard history window. Use Full to request the complete available account risk score history. .PARAMETER Full Requests the full account risk score history instead of the default window. .PARAMETER Raw Returns the full PSKB4Reporting response envelope, including status code, headers, request ID, URI, and response body. .EXAMPLE Get-KB4AccountRiskScoreHistory Returns the default account risk score history. .EXAMPLE Get-KB4AccountRiskScoreHistory -Full Returns the full available account risk score history. .OUTPUTS PSCustomObject. #> function Get-KB4AccountRiskScoreHistory { [CmdletBinding()] param( [Parameter()] [switch] $Full, [Parameter()] [switch] $Raw ) $query = @{} if ($Full) { $query['full'] = $true } Get-KB4ResponseBody -Response (Invoke-KB4Request -Path '/v1/account/risk_score_history' -Query $query) -Raw:$Raw } |