Skip to main content
Version: 4.0

Get-ADTWindowTitle

SYNOPSIS​

Search for an open window title and return details about the window.

SYNTAX​

SearchWinTitle​

Get-ADTWindowTitle -WindowTitle <String[]> [<CommonParameters>]

SearchWinHandle​

Get-ADTWindowTitle -WindowHandle <IntPtr[]> [<CommonParameters>]

SearchParentProcess​

Get-ADTWindowTitle -ParentProcess <String[]> [<CommonParameters>]

GetAllWinTitles​

Get-ADTWindowTitle [-GetAllWindowTitles] [<CommonParameters>]

DESCRIPTION​

Search for a window title. If window title searched for returns more than one result, then details for each window will be displayed.

Returns the following properties for each window:

  • WindowTitle
  • WindowHandle
  • ParentProcess
  • ParentProcessMainWindowHandle
  • ParentProcessId

Function does not work in SYSTEM context unless launched with "psexec.exe -s -i" to run it as an interactive process under the SYSTEM account.

EXAMPLES​

EXAMPLE 1​

Get-ADTWindowTitle -WindowTitle 'Microsoft Word'

Gets details for each window that has the words "Microsoft Word" in the title.

EXAMPLE 2​

Get-ADTWindowTitle -GetAllWindowTitles

Gets details for all windows with a title.

EXAMPLE 3​

Get-ADTWindowTitle -GetAllWindowTitles | Where-Object { $_.ParentProcess -eq 'WINWORD' }

Get details for all windows belonging to Microsoft Word process with name "WINWORD".

PARAMETERS​

-WindowTitle​

One or more titles of the application window to search for using regex matching.

Type: String[]
Parameter Sets: SearchWinTitle
Aliases:

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

-WindowHandle​

One or more window handles of the application window to search for.

Type: IntPtr[]
Parameter Sets: SearchWinHandle
Aliases:

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

-ParentProcess​

One or more process names of the application window to search for.

Type: String[]
Parameter Sets: SearchParentProcess
Aliases:

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

-GetAllWindowTitles​

Get titles for all open windows on the system.

Type: SwitchParameter
Parameter Sets: GetAllWinTitles
Aliases:

Required: True
Position: Named
Default value: False
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​

None​

You cannot pipe objects to this function.​

OUTPUTS​

PSADT.Types.WindowInfo​

Returns a PSADT.Types.WindowInfo object with the following properties:​

- WindowTitle​

- WindowHandle​

- ParentProcess​

- ParentProcessMainWindowHandle​

- ParentProcessId​

NOTES​

An active ADT session is NOT required to use this function.

Function does not work in SYSTEM context unless launched with "psexec.exe -s -i" to run it as an interactive process under the SYSTEM account.

Tags: psadt
Website: https://psappdeploytoolkit.com
Copyright: (C) 2025 PSAppDeployToolkit Team (Sean Lillis, Dan Cunningham, Muhammad Mashwani, Mitch Richters, Dan Gough).
License: https://opensource.org/license/lgpl-3-0

https://psappdeploytoolkit.com/docs/reference/functions/Get-ADTWindowTitle