Find-HtmlInteractionSurface

August 3, 2026 ยท View on GitHub

SYNOPSIS

Finds forms, hidden fields, tokens, inline endpoints, and optional linked-script endpoints in HTML.

SYNTAX

Node (Default)

Find-HtmlInteractionSurface [-HtmlNode] <Object> [-BaseUrl <uri>] [-IncludeLinkedScripts] [-IncludeExternalLinkedScripts] [-MaximumResponseBytes <int>] [<CommonParameters>]

Content

Find-HtmlInteractionSurface -Content <string> [-BaseUrl <uri>] [-IncludeLinkedScripts] [-IncludeExternalLinkedScripts] [-MaximumResponseBytes <int>] [<CommonParameters>]

File

Find-HtmlInteractionSurface -Path <string> [-BaseUrl <uri>] [-IncludeLinkedScripts] [-IncludeExternalLinkedScripts] [-MaximumResponseBytes <int>] [<CommonParameters>]

Url

Find-HtmlInteractionSurface -Url <uri> [-BaseUrl <uri>] [-IncludeLinkedScripts] [-IncludeExternalLinkedScripts] [-MaximumResponseBytes <int>] [-Proxy <string>] [-ProxyCredential <pscredential>] [<CommonParameters>]

DESCRIPTION

Finds forms, hidden fields, tokens, inline endpoints, and optional linked-script endpoints in HTML.

EXAMPLES

EXAMPLE 1

Find-HtmlInteractionSurface -Content $html

EXAMPLE 2

Find-HtmlInteractionSurface -Url https://example.org/app -IncludeLinkedScripts

EXAMPLE 3

Select-HtmlNode -Content $html -CssSelector 'form' | Find-HtmlInteractionSurface

PARAMETERS

-BaseUrl

Base URL used to resolve linked script URLs. Defaults to Url when downloading, and can be supplied by an absolute document base element.

Type: Uri
Parameter Sets: Node, Content, File, Url
Aliases: None
Possible values:

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

-Content

HTML content to inspect.

Type: String
Parameter Sets: Content
Aliases: None
Possible values:

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

-HtmlNode

HtmlAgilityPack node or document to inspect.

Type: Object
Parameter Sets: Node
Aliases: Node, InputObject
Possible values:

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

-IncludeExternalLinkedScripts

Allows cross-origin linked JavaScript downloads when IncludeLinkedScripts is used.

Type: SwitchParameter
Parameter Sets: Node, Content, File, Url
Aliases: None
Possible values:

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

-IncludeLinkedScripts

Downloads and inspects same-origin linked JavaScript files when BaseUrl, Url, or an absolute document base element is available.

Type: SwitchParameter
Parameter Sets: Node, Content, File, Url
Aliases: None
Possible values:

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

-MaximumResponseBytes

Maximum number of bytes accepted for the page and each linked JavaScript response.

Type: Int32
Parameter Sets: Node, Content, File, Url
Aliases: None
Possible values:

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

-Path

Path to an HTML file.

Type: String
Parameter Sets: File
Aliases: File
Possible values:

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

-Proxy

Proxy server address used when downloading by URL.

Type: String
Parameter Sets: Url
Aliases: None
Possible values:

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

-ProxyCredential

Credentials used with the proxy server.

Type: PSCredential
Parameter Sets: Url
Aliases: None
Possible values:

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

-Url

URL of an HTML page to download and inspect.

Type: Uri
Parameter Sets: Url
Aliases: Uri
Possible values:

Required: True
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.String
  • System.Object

OUTPUTS

  • HtmlTinkerX.HtmlInteractionSurfaceItem
  • None