ConvertFrom-HtmlSsoHandoff

August 3, 2026 ยท View on GitHub

SYNOPSIS

Analyzes an SSO handoff form and safely decodes known protocol artifacts.

SYNTAX

__AllParameterSets

ConvertFrom-HtmlSsoHandoff [-Handoff] <Object> [-IncludeXml] [-IncludeJson] [-IncludeSensitiveValues] [<CommonParameters>]

DESCRIPTION

Analyzes an SSO handoff form and safely decodes known protocol artifacts.

EXAMPLES

EXAMPLE 1

Get-HtmlBrowserSsoHandoff -Session $session -IncludeSensitiveValues | ConvertFrom-HtmlSsoHandoff

PARAMETERS

-Handoff

SSO handoff object returned by Get-HtmlBrowserSsoHandoff.

Type: Object
Parameter Sets: __AllParameterSets
Aliases: None
Possible values:

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-IncludeJson

Include decoded JWT header and payload JSON when id_token or access_token fields are present. Values remain redacted unless IncludeSensitiveValues is also set.

Type: SwitchParameter
Parameter Sets: __AllParameterSets
Aliases: None
Possible values:

Required: False
Position: named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-IncludeSensitiveValues

Reveal subject, user-identifying, and assertion values in nested summaries. Use only for authorized troubleshooting.

Type: SwitchParameter
Parameter Sets: __AllParameterSets
Aliases: None
Possible values:

Required: False
Position: named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-IncludeXml

Include decoded SAML XML when a SAMLResponse is present. Values remain redacted unless IncludeSensitiveValues is also set.

Type: SwitchParameter
Parameter Sets: __AllParameterSets
Aliases: None
Possible values:

Required: False
Position: named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

  • System.Object

OUTPUTS

  • HtmlTinkerX.HtmlSsoHandoffAnalysis
  • None