GenXdev.Webbrowser
A Windows PowerShell module that allows you to run scripts against your casual desktop webbrowser-tab
* ✅ full controll of the webbrowser with the 'wbctrl' cmdlet
* ✅ retreiving and manipulating of webbrowser-tab DOM nodes with 'wl' cmdlet
* ✅ evaluating javascript-strings, javascript-files in opened webbrowser-tab
* ✅ adding html script tags, by url, to opened webbrowser-tabs, for normal javascript files or modules
* ✅ evaluating scripts, with support for async patterns, like promises
* ✅ evaluating asynchronous scripts, with support for yielded PowerShell pipeline returns
* ✅ exporting of favourites/bookmarks from Microsoft Edge, Google Chrome or Firefox
* ✅ launching of default browser, Microsoft Edge, Google Chrome or Firefox
* ✅ launching of webbrowser with full control of window positioning
* ✅ launching of webbrowser with a large set of options
In your PowerShell profile script,
you can set a global variable named DefaultSecondaryMonitor.
This allows you to setup your prefered webbrowser launch monitor.
e.g.
# Disable default placement of browser window
Set-Variable -Name DefaultSecondaryMonitor -Value -1 -Scope Global
# Place browser windows by default on 3th monitor (0 = Primary monitor, 1 = first, 2 = second, etc)
Set-Variable -Name DefaultSecondaryMonitor -Value 3 -Scope Global
-------------------------- EXAMPLE 1 --------------------------
PS C:\> Invoke-WebbrowserEvaluation "document.title = 'hello world'"
-------------------------- EXAMPLE 2 --------------------------
PS C:\>
# Synchronizing data
Select-WebbrowserTab;
$Global:Data = @{ files= (Get-ChildItem *.* -file | % FullName)};
[int] $number = Invoke-WebbrowserEvaluation "
document.body.innerHTML = JSON.stringify(data.files);
data.title = document.title;
return 123;
";
Write-Host "
Document title : $($Global:Data.title)
return value : $Number
";
-------------------------- EXAMPLE 3 --------------------------
PS C:\>
# Support for promises
Select-WebbrowserTab;
Invoke-WebbrowserEvaluation "
let myList = [];
return new Promise((resolve) => {
let i = 0;
let a = setInterval(() => {
myList.push(++i);
if (i == 10) {
clearInterval(a);
resolve(myList);
}
}, 1000);
});
"
-------------------------- EXAMPLE 4 --------------------------
PS C:\>
# Support for promises and more
# this function returns all rows of all tables/datastores of all databases of indexedDb in the selected tab
# beware, not all websites use indexedDb, it could return an empty set
Select-WebbrowserTab;
Set-WebbrowserTabLocation "https://www.youtube.com/"
Start-Sleep 3
$AllIndexedDbData = Invoke-WebbrowserEvaluation "
// enumerate all indexedDB databases
for (let db of await indexedDB.databases()) {
// request to open database
let openRequest = await indexedDB.open(db.name);
// wait for eventhandlers to be called
await new Promise((resolve,reject) => {
openRequest.onsuccess = resolve;
openRequest.onerror = reject
});
// obtain reference
let openedDb = openRequest.result;
// initialize result
let result = { DatabaseName: db.name, Version: db.version, Stores: [] }
// itterate object store names
for (let i = 0; i < openedDb.objectStoreNames.length; i++) {
// reference
let storeName = openedDb.objectStoreNames[i];
// start readonly transaction
let tr = openedDb.transaction(storeName);
// get objectstore handle
let store = tr.objectStore(storeName);
// request all data
let getRequest = store.getAll();
// await result
await new Promise((resolve,reject) => {
getRequest.onsuccess = resolve;
getRequest.onerror = reject;
});
// add result
result.Stores.push({ StoreName: storeName, Data: getRequest.result});
}
// stream this database contents to the PowerShell pipeline, and continue
yield result;
}
";
$AllIndexedDbData | Out-Host
-------------------------- EXAMPLE 5 --------------------------
PS C:\>
# Support for yielded pipeline results
Select-WebbrowserTab;
Invoke-WebbrowserEvaluation "
for (let i = 0; i < 10; i++) {
await (new Promise((resolve) => setTimeout(resolve, 1000)));
yield i;
}
";
-------------------------- EXAMPLE 6 --------------------------
PS C:\> Get-ChildItem *.js | Invoke-WebbrowserEvaluation -Edge
-------------------------- EXAMPLE 7 --------------------------
PS C:\> ls *.js | et -e
Install-Module "GenXdev.Webbrowser"
Import-Module "GenXdev.Webbrowser"Update-Module| Command | aliases | Description |
|---|---|---|
| Approve-FirefoxDebugging | Configures Firefox's debugging and standalone app mode features. | |
| Clear-WebbrowserTabSiteApplicationData | clearsitedata | Clears all browser storage data for the current tab in Edge or Chrome. |
| Close-Webbrowser | wbc | Closes one or more webbrowser instances selectively. |
| Close-WebbrowserTab | ct, closetab | Closes the currently selected webbrowser tab. |
| Export-BrowserBookmarks | Exports browser bookmarks to a JSON file. | |
| Find-BrowserBookmark | bookmarks | Finds bookmarks from one or more web browsers. |
| Get-BrowserBookmark | gbm | Returns all bookmarks from installed web browsers. |
| Get-ChromeRemoteDebuggingPort | get-chromeport | Returns the configured remote debugging port for Google Chrome. |
| Get-ChromiumRemoteDebuggingPort | get-browserdebugport | Returns the remote debugging port for the system's default Chromium browser. |
| Get-ChromiumSessionReference | Gets a serializable reference to the current browser tab session. | |
| Get-DefaultWebbrowser | Returns the configured default web browser for the current user. | |
| Get-EdgeRemoteDebuggingPort | Returns the configured remote debugging port for Microsoft Edge browser. | |
| Get-Webbrowser | Returns a collection of installed modern web browsers. | |
| Get-WebbrowserTabDomNodes | wl | Queries and manipulates DOM nodes in the active browser tab using CSS selectors. |
| Import-BrowserBookmarks | Imports bookmarks from a file or collection into a web browser. | |
| Invoke-WebbrowserEvaluation | eval, et | Executes JavaScript code in a selected web browser tab. |
| Open-BrowserBookmarks | sites | Opens browser bookmarks that match specified search criteria. |
| Open-Webbrowser | wb | Opens one or more webbrowser instances. |
| Select-WebbrowserTab | st, select-browsertab | Selects a browser tab for automation in Chrome or Edge. |
| Set-BrowserVideoFullscreen | fsvideo | Maximizes the first video element found in the current browser tab. |
| Set-RemoteDebuggerPortInBrowserShortcuts | Updates browser shortcuts to enable remote debugging ports. | |
| Set-WebbrowserTabLocation | lt, nav | Navigates the current webbrowser tab to a specified URL. |
| Show-WebsiteInAllBrowsers | show-urlinallbrowsers | Opens a URL in multiple browsers simultaneously in a mosaic layout. |
| Command | aliases | Description |
|---|---|---|
| AssureTypes | ||
| Close-PlaywrightDriver | Closes a Playwright browser instance and removes it from the global cache. | |
| Connect-PlaywrightViaDebuggingPort | Connects to an existing browser instance via debugging port. | |
| Get-PlaywrightDriver | Creates or retrieves a configured Playwright browser instance. | |
| Get-PlaywrightProfileDirectory | Gets the Playwright browser profile directory for persistent sessions. | |
| Resume-WebbrowserTabVideo | Resumes video playback in a YouTube browser tab. | |
| Stop-WebbrowserVideos | wbsst | Pauses video playback in all active browser sessions. |
| Unprotect-WebbrowserTab | wbctrl | Takes control of a selected web browser tab for interactive manipulation. |
| Update-PlaywrightDriverCache | Maintains the Playwright browser instance cache by removing stale entries. |
NAME Approve-FirefoxDebugging
SYNOPSIS Configures Firefox's debugging and standalone app mode features.
SYNTAX Approve-FirefoxDebugging []
DESCRIPTION Enables remote debugging and standalone app mode (SSB) capabilities in Firefox by modifying user preferences in the prefs.js file of all Firefox profile directories. This function updates or adds required debugging preferences to enable development tools and remote debugging while disabling connection prompts.
PARAMETERS This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS System.Void
-------------------------- EXAMPLE 1 --------------------------
PS > Approve-FirefoxDebugging
Enables remote debugging and SSB features across all Firefox profiles found in
the current user's AppData directory.
RELATED LINKS
NAME Clear-WebbrowserTabSiteApplicationData
SYNOPSIS Clears all browser storage data for the current tab in Edge or Chrome.
SYNTAX Clear-WebbrowserTabSiteApplicationData [-Edge] [-Chrome] []
DESCRIPTION The Clear-WebbrowserTabSiteApplicationData cmdlet executes a JavaScript snippet that clears various types of browser storage for the current tab, including: - Local storage - Session storage - Cookies - IndexedDB databases - Cache storage - Service worker registrations
PARAMETERS -Edge [] Specifies to clear data in Microsoft Edge browser.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chrome [<SwitchParameter>]
Specifies to clear data in Google Chrome browser.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
-------------------------- EXAMPLE 1 --------------------------
PS > Clear-WebbrowserTabSiteApplicationData -Edge
Clears all browser storage data in the current Edge tab.
-------------------------- EXAMPLE 2 --------------------------
PS > clearsitedata -Chrome
Clears all browser storage data in the current Chrome tab using the alias.
RELATED LINKS
NAME Close-Webbrowser
SYNOPSIS Closes one or more webbrowser instances selectively.
SYNTAX Close-Webbrowser [[-Edge]] [[-Chrome]] [[-Chromium]] [[-Firefox]] [[-IncludeBackgroundProcesses]] []
Close-Webbrowser [[-All]] [[-IncludeBackgroundProcesses]] [<CommonParameters>]
DESCRIPTION Provides granular control over closing web browser instances. Can target specific browsers (Edge, Chrome, Firefox) or close all browsers. Supports closing both main windows and background processes.
PARAMETERS -Edge [] Closes all Microsoft Edge browser instances.
Required? false
Position? 1
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chrome [<SwitchParameter>]
Closes all Google Chrome browser instances.
Required? false
Position? 2
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chromium [<SwitchParameter>]
Closes the default Chromium-based browser (Edge or Chrome).
Required? false
Position? 3
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Firefox [<SwitchParameter>]
Closes all Firefox browser instances.
Required? false
Position? 4
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-All [<SwitchParameter>]
Closes all detected modern browser instances.
Required? false
Position? 1
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-IncludeBackgroundProcesses [<SwitchParameter>]
Also closes background processes and tasks for the selected browsers.
Required? false
Position? 5
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
-------------------------- EXAMPLE 1 --------------------------
PS > Close-Webbrowser -Chrome -Firefox -IncludeBackgroundProcesses
# Closes all Chrome and Firefox instances including background processes
-------------------------- EXAMPLE 2 --------------------------
PS > wbc -a -bg
# Closes all browser instances including background processes using aliases
RELATED LINKS
NAME Close-WebbrowserTab
SYNOPSIS Closes the currently selected webbrowser tab.
SYNTAX Close-WebbrowserTab [-Edge] [-Chrome] []
DESCRIPTION Closes the currently selected webbrowser tab using ChromeDriver's CloseAsync() method. If no tab is currently selected, the function will automatically attempt to select the last used tab before closing it.
PARAMETERS -Edge []
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chrome [<SwitchParameter>]
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
-------------------------- EXAMPLE 1 --------------------------
PS > Close-WebbrowserTab
Closes the currently active browser tab
-------------------------- EXAMPLE 2 --------------------------
PS > ct
Uses the alias to close the currently active browser tab
RELATED LINKS
NAME Export-BrowserBookmarks
SYNOPSIS Exports browser bookmarks to a JSON file.
SYNTAX Export-BrowserBookmarks [-OutputFile] [-Chrome] [-Edge] [-Firefox] []
DESCRIPTION The Export-BrowserBookmarks cmdlet exports bookmarks from a specified web browser (Microsoft Edge, Google Chrome, or Mozilla Firefox) to a JSON file. Only one browser type can be specified at a time. The bookmarks are exported with full preservation of their structure and metadata.
PARAMETERS -OutputFile The path to the JSON file where the bookmarks will be saved. The path will be expanded to a full path before use.
Required? true
Position? 1
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chrome [<SwitchParameter>]
Switch parameter to export bookmarks from Google Chrome browser.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Edge [<SwitchParameter>]
Switch parameter to export bookmarks from Microsoft Edge browser.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Firefox [<SwitchParameter>]
Switch parameter to export bookmarks from Mozilla Firefox browser.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
-------------------------- EXAMPLE 1 --------------------------
PS > Export-BrowserBookmarks -OutputFile "C:\MyBookmarks.json" -Edge
-------------------------- EXAMPLE 2 --------------------------
PS > Export-BrowserBookmarks "C:\MyBookmarks.json" -Chrome
RELATED LINKS
NAME Find-BrowserBookmark
SYNOPSIS Finds bookmarks from one or more web browsers.
SYNTAX Find-BrowserBookmark [[-Queries] <String[]>] [-Edge] [-Chrome] [-Firefox] [-Count ] [-PassThru] []
DESCRIPTION Searches through bookmarks from Microsoft Edge, Google Chrome, or Mozilla Firefox. Returns bookmarks that match one or more search queries in their name, URL, or folder path. If no queries are provided, returns all bookmarks from the selected browsers.
PARAMETERS -Queries <String[]> One or more search terms to find matching bookmarks. Matches are found in the bookmark name, URL, or folder path using wildcard pattern matching.
Required? false
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Aliases
Accept wildcard characters? true
-Edge [<SwitchParameter>]
Switch to include Microsoft Edge bookmarks in the search.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chrome [<SwitchParameter>]
Switch to include Google Chrome bookmarks in the search.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Firefox [<SwitchParameter>]
Switch to include Mozilla Firefox bookmarks in the search.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Count <Int32>
Maximum number of results to return. Must be a positive integer.
Default is 99999999.
Required? false
Position? named
Default value 99999999
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-PassThru [<SwitchParameter>]
Switch to return complete bookmark objects instead of just URLs. Each bookmark
object contains Name, URL, and Folder properties.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
-------------------------- EXAMPLE 1 --------------------------
PS > Find-BrowserBookmark -Query "github" -Edge -Chrome -Count 10
# Searches Edge and Chrome bookmarks for "github", returns first 10 URLs
-------------------------- EXAMPLE 2 --------------------------
PS > bookmarks powershell -e -ff -PassThru
# Searches Edge and Firefox bookmarks for "powershell", returns full objects
RELATED LINKS
NAME Get-BrowserBookmark
SYNOPSIS Returns all bookmarks from installed web browsers.
SYNTAX Get-BrowserBookmark [[-Chrome]] [[-Edge]] []
Get-BrowserBookmark [[-Chrome]] [[-Edge]] [[-Firefox]] [<CommonParameters>]
DESCRIPTION Retrieves bookmarks from Microsoft Edge, Google Chrome, or Mozilla Firefox browsers installed on the system. The function can filter by browser type and returns detailed bookmark information including name, URL, folder location, and timestamps.
PARAMETERS -Chrome [] Retrieves bookmarks specifically from Google Chrome browser.
Required? false
Position? 1
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Edge [<SwitchParameter>]
Retrieves bookmarks specifically from Microsoft Edge browser.
Required? false
Position? 2
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Firefox [<SwitchParameter>]
Retrieves bookmarks specifically from Mozilla Firefox browser.
Required? false
Position? 3
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS System.Object[]
-------------------------- EXAMPLE 1 --------------------------
PS > Get-BrowserBookmark -Edge | Format-Table Name, URL, Folder
Returns Edge bookmarks formatted as a table showing name, URL and folder.
-------------------------- EXAMPLE 2 --------------------------
PS > gbm -Chrome | Where-Object URL -like "*github*"
Returns Chrome bookmarks filtered to only show GitHub-related URLs.
RELATED LINKS
NAME Get-ChromeRemoteDebuggingPort
SYNOPSIS Returns the configured remote debugging port for Google Chrome.
SYNTAX Get-ChromeRemoteDebuggingPort []
DESCRIPTION Retrieves and manages the remote debugging port configuration for Google Chrome. The function first checks for a custom port number stored in $Global:ChromeDebugPort. If not found or invalid, it defaults to port 9222. The port number is then stored globally for use by other Chrome automation functions.
PARAMETERS This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS System.Int32 Returns the configured Chrome debugging port number.
-------------------------- EXAMPLE 1 --------------------------
PS > $port = Get-ChromeRemoteDebuggingPort
Write-Host "Chrome debug port: $port"
-------------------------- EXAMPLE 2 --------------------------
PS > $port = Get-ChromePort
Write-Host "Chrome debug port: $port"
RELATED LINKS
NAME Get-ChromiumRemoteDebuggingPort
SYNOPSIS Returns the remote debugging port for the system's default Chromium browser.
SYNTAX Get-ChromiumRemoteDebuggingPort [-Chrome] [-Edge] []
DESCRIPTION Detects whether Microsoft Edge or Google Chrome is the default browser and returns the appropriate debugging port number. If Chrome is the default browser, returns the Chrome debugging port. Otherwise returns the Edge debugging port (also used when no default browser is detected).
PARAMETERS -Chrome []
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Edge [<SwitchParameter>]
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS [int] The remote debugging port number for the detected browser.
-------------------------- EXAMPLE 1 --------------------------
PS > # Get debugging port using full command name
Get-ChromiumRemoteDebuggingPort
-------------------------- EXAMPLE 2 --------------------------
PS > # Get debugging port using alias
Get-BrowserDebugPort
RELATED LINKS
NAME Get-ChromiumSessionReference
SYNOPSIS Gets a serializable reference to the current browser tab session.
SYNTAX Get-ChromiumSessionReference []
DESCRIPTION Returns a hashtable containing debugger URI, port, and session data for the current browser tab. This reference can be used with Select-WebbrowserTab -ByReference to reconnect to the same tab, especially useful in background jobs or across different PowerShell sessions.
The function validates the existence of an active chrome session and ensures
the browser controller is still running before returning the session reference.
PARAMETERS This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS System.Collections.Hashtable
-------------------------- EXAMPLE 1 --------------------------
PS > # Get a reference to the current chrome tab session
$sessionRef = Get-ChromiumSessionReference
-------------------------- EXAMPLE 2 --------------------------
PS > # Store the reference and use it later to reconnect
$ref = Get-ChromiumSessionReference
Select-WebbrowserTab -ByReference $ref
RELATED LINKS
NAME Get-DefaultWebbrowser
SYNOPSIS Returns the configured default web browser for the current user.
SYNTAX Get-DefaultWebbrowser []
DESCRIPTION Retrieves information about the system's default web browser by querying the Windows Registry. Returns a hashtable containing the browser's name, description, icon path, and executable path. The function checks both user preferences and system-wide browser registrations to determine the default browser.
PARAMETERS This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS System.Collections.Hashtable with keys: Name, Description, Icon, Path
NOTES
Requires Windows 10 or later operating system
-------------------------- EXAMPLE 1 --------------------------
PS > # Get detailed information about the default browser
Get-DefaultWebbrowser | Format-List
-------------------------- EXAMPLE 2 --------------------------
PS > # Launch the default browser with a specific URL
$browser = Get-DefaultWebbrowser
& $browser.Path https://www.github.com/
RELATED LINKS
NAME Get-EdgeRemoteDebuggingPort
SYNOPSIS Returns the configured remote debugging port for Microsoft Edge browser.
SYNTAX Get-EdgeRemoteDebuggingPort []
DESCRIPTION Retrieves the remote debugging port number used for connecting to Microsoft Edge browser's debugging interface. If no custom port is configured via the global variable $Global:EdgeDebugPort, returns the default port 9223. The function validates any custom port configuration and falls back to the default if invalid.
PARAMETERS This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS System.Int32 Returns the port number to use for Edge remote debugging
NOTES
The function ensures $Global:EdgeDebugPort is always set to the returned value
for consistency across the session.
-------------------------- EXAMPLE 1 --------------------------
PS > Get-EdgeRemoteDebuggingPort
Returns the configured debug port (default 9223 if not configured)
RELATED LINKS
NAME Get-Webbrowser
SYNOPSIS Returns a collection of installed modern web browsers.
SYNTAX Get-Webbrowser []
DESCRIPTION Discovers and returns details about modern web browsers installed on the system. Retrieves information including name, description, icon path, executable path and default browser status by querying the Windows registry. Only returns browsers that have the required capabilities registered in Windows.
PARAMETERS This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS System.Collections.Hashtable[] Returns an array of hashtables containing browser details: - Name: Browser application name - Description: Browser description - Icon: Path to browser icon - Path: Path to browser executable - IsDefaultBrowser: Boolean indicating if this is the default browser
NOTES
Requires Windows 10 or later Operating System
-------------------------- EXAMPLE 1 --------------------------
PS > Get-Webbrowser | Select-Object Name, Description | Format-Table
-------------------------- EXAMPLE 2 --------------------------
PS > # Get just the default browser
Get-Webbrowser | Where-Object { $_.IsDefaultBrowser }
RELATED LINKS
NAME Get-WebbrowserTabDomNodes
SYNOPSIS Queries and manipulates DOM nodes in the active browser tab using CSS selectors.
SYNTAX Get-WebbrowserTabDomNodes [-QuerySelector] <String[]> [[-ModifyScript] ] [-Edge] [-Chrome] [-Page ] [-ByReference ] [-NoAutoSelectTab] []
DESCRIPTION Uses browser automation to find elements matching a CSS selector and returns their HTML content or executes custom JavaScript on each matched element. This function is useful for web scraping and browser automation tasks.
PARAMETERS -QuerySelector <String[]> CSS selector string to find matching DOM elements. Uses standard CSS selector syntax like '#id', '.class', 'tag', etc.
Required? true
Position? 1
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-ModifyScript <String>
JavaScript code to execute on each matched element. The code runs as an async
function with parameters:
- e: The matched DOM element
- i: Index of the element (0-based)
- n: Complete NodeList of matching elements
- modifyScript: The script being executed
Required? false
Position? 2
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Edge [<SwitchParameter>]
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chrome [<SwitchParameter>]
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Page <Object>
Required? false
Position? named
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-ByReference <PSObject>
Required? false
Position? named
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-NoAutoSelectTab [<SwitchParameter>]
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
-------------------------- EXAMPLE 1 --------------------------
PS > # Get HTML of all header divs
Get-WebbrowserTabDomNodes -QuerySelector "div.header"
-------------------------- EXAMPLE 2 --------------------------
PS > # Pause all videos on the page
wl "video" "e.pause()"
RELATED LINKS
NAME Import-BrowserBookmarks
SYNOPSIS Imports bookmarks from a file or collection into a web browser.
SYNTAX Import-BrowserBookmarks [-Chrome] [-Edge] [-Firefox] [-WhatIf] [-Confirm] []
Import-BrowserBookmarks [[-InputFile] <String>] [-Chrome] [-Edge] [-Firefox] [-WhatIf] [-Confirm] [<CommonParameters>]
Import-BrowserBookmarks [[-Bookmarks] <Array>] [-Chrome] [-Edge] [-Firefox] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION Imports bookmarks into Microsoft Edge or Google Chrome from either a CSV file or a collection of bookmark objects. The bookmarks are added to the browser's bookmark bar or specified folders. Firefox import is not currently supported.
PARAMETERS -InputFile The path to a CSV file containing bookmarks to import. The CSV should have columns for Name, URL, Folder, DateAdded, and DateModified.
Required? false
Position? 1
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Bookmarks <Array>
An array of bookmark objects to import. Each object should have properties for
Name, URL, Folder, DateAdded, and DateModified.
Required? false
Position? 1
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chrome [<SwitchParameter>]
Switch to import bookmarks into Google Chrome.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Edge [<SwitchParameter>]
Switch to import bookmarks into Microsoft Edge.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Firefox [<SwitchParameter>]
Switch to indicate Firefox as target (currently not supported).
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Required? false
Position? named
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Required? false
Position? named
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
-------------------------- EXAMPLE 1 --------------------------
PS > Import-BrowserBookmarks -InputFile "C:\MyBookmarks.csv" -Edge
Imports bookmarks from the CSV file into Microsoft Edge.
-------------------------- EXAMPLE 2 --------------------------
PS > $bookmarks = @(
@{
Name = "Microsoft";
URL = "https://microsoft.com";
Folder = "Tech"
}
)
Import-BrowserBookmarks -Bookmarks $bookmarks -Chrome
Imports a collection of bookmarks into Google Chrome.
RELATED LINKS
NAME Invoke-WebbrowserEvaluation
SYNOPSIS Executes JavaScript code in a selected web browser tab.
SYNTAX Invoke-WebbrowserEvaluation [[-Scripts] <Object[]>] [-Inspect] [-NoAutoSelectTab] [-Edge] [-Chrome] [-Page ] [-ByReference ] []
DESCRIPTION Executes JavaScript code in a selected browser tab with support for async/await, promises, and data synchronization between PowerShell and the browser context. Can execute code from strings, files, or URLs.
PARAMETERS -Scripts <Object[]> JavaScript code to execute. Can be string content, file paths, or URLs. Accepts pipeline input.
Required? false
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Aliases
Accept wildcard characters? false
-Inspect [<SwitchParameter>]
Adds debugger statement before executing to enable debugging.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-NoAutoSelectTab [<SwitchParameter>]
Prevents automatic tab selection if no tab is currently selected.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Edge [<SwitchParameter>]
Selects Microsoft Edge browser for execution.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chrome [<SwitchParameter>]
Selects Google Chrome browser for execution.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Page <Object>
Browser page object for execution when using ByReference mode.
Required? false
Position? named
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-ByReference <PSObject>
Session reference object when using ByReference mode.
Required? false
Position? named
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
NOTES
Requires the Windows 10+ Operating System
-------------------------- EXAMPLE 1 --------------------------
PS > # Execute simple JavaScript
Invoke-WebbrowserEvaluation "document.title = 'hello world'"
-------------------------- EXAMPLE 2 --------------------------
PS>
# Synchronizing data
Select-WebbrowserTab -Force;
$Global:Data = @{ files= (Get-ChildItem *.* -file | % FullName)};
[int] $number = Invoke-WebbrowserEvaluation "
document.body.innerHTML = JSON.stringify(data.files);
data.title = document.title;
return 123;
";
Write-Host "
Document title : $($Global:Data.title)
return value : $Number
";
-------------------------- EXAMPLE 3 --------------------------
PS>
# Support for promises
Select-WebbrowserTab -Force;
Invoke-WebbrowserEvaluation "
let myList = [];
return new Promise((resolve) => {
let i = 0;
let a = setInterval(() => {
myList.push(++i);
if (i == 10) {
clearInterval(a);
resolve(myList);
}
}, 1000);
});
"
-------------------------- EXAMPLE 4 --------------------------
PS>
# Support for promises and more
# this function returns all rows of all tables/datastores of all databases of indexedDb in the selected tab
# beware, not all websites use indexedDb, it could return an empty set
Select-WebbrowserTab -Force;
Set-WebbrowserTabLocation "https://www.youtube.com/"
Start-Sleep 3
$AllIndexedDbData = Invoke-WebbrowserEvaluation "
// enumerate all indexedDB databases
for (let db of await indexedDB.databases()) {
// request to open database
let openRequest = await indexedDB.open(db.name);
// wait for eventhandlers to be called
await new Promise((resolve,reject) => {
openRequest.onsuccess = resolve;
openRequest.onerror = reject
});
// obtain reference
let openedDb = openRequest.result;
// initialize result
let result = { DatabaseName: db.name, Version: db.version, Stores: [] }
// itterate object store names
for (let i = 0; i < openedDb.objectStoreNames.length; i++) {
// reference
let storeName = openedDb.objectStoreNames[i];
// start readonly transaction
let tr = openedDb.transaction(storeName);
// get objectstore handle
let store = tr.objectStore(storeName);
// request all data
let getRequest = store.getAll();
// await result
await new Promise((resolve,reject) => {
getRequest.onsuccess = resolve;
getRequest.onerror = reject;
});
// add result
result.Stores.push({ StoreName: storeName, Data: getRequest.result});
}
// stream this database contents to the PowerShell pipeline, and continue
yield result;
}
";
$AllIndexedDbData | Out-Host
-------------------------- EXAMPLE 5 --------------------------
PS>
# Support for yielded pipeline results
Select-WebbrowserTab -Force;
Invoke-WebbrowserEvaluation "
for (let i = 0; i < 10; i++) {
await (new Promise((resolve) => setTimeout(resolve, 1000)));
yield i;
}
";
-------------------------- EXAMPLE 6 --------------------------
PS>Get-ChildItem *.js | Invoke-WebbrowserEvaluation -Edge
-------------------------- EXAMPLE 7 --------------------------
PS>ls *.js | et -e
RELATED LINKS
NAME Open-BrowserBookmarks
SYNOPSIS Opens browser bookmarks that match specified search criteria.
SYNTAX Open-BrowserBookmarks [[-Queries] <String[]>] [[-Count] ] [-Edge] [-Chrome] [-Firefox] [-OpenInEdge] [-OpenInChrome] [-OpenInFirefox] [-Monitor ] [-Private] [-Force] [-FullScreen] [-Width ] [-Height ] [-X ] [-Y ] [-Left] [-Right] [-Top] [-Bottom] [-Centered] [-ApplicationMode] [-NoBrowserExtensions] [-AcceptLang ] [-RestoreFocus] [-NewWindow] []
DESCRIPTION Searches bookmarks across Microsoft Edge, Google Chrome, and Mozilla Firefox browsers based on provided search queries. Opens matching bookmarks in the selected browser with configurable window settings and browser modes.
PARAMETERS -Queries <String[]> Search terms used to filter bookmarks by title or URL.
Required? false
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Aliases
Accept wildcard characters? false
-Count <Int32>
Maximum number of bookmarks to open (default 50).
Required? false
Position? 2
Default value 50
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Edge [<SwitchParameter>]
Use Microsoft Edge browser bookmarks as search source.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chrome [<SwitchParameter>]
Use Google Chrome browser bookmarks as search source.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Firefox [<SwitchParameter>]
Use Mozilla Firefox browser bookmarks as search source.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-OpenInEdge [<SwitchParameter>]
Open found bookmarks in Microsoft Edge browser.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-OpenInChrome [<SwitchParameter>]
Open found bookmarks in Google Chrome browser.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-OpenInFirefox [<SwitchParameter>]
Open found bookmarks in Mozilla Firefox browser.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Monitor <Int32>
Specifies target monitor: 0=default, -1=discard, -2=secondary monitor.
Required? false
Position? named
Default value -1
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Private [<SwitchParameter>]
Opens bookmarks in private/incognito browsing mode.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Force [<SwitchParameter>]
Forces enabling of debugging port, stops existing browser instances if needed.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-FullScreen [<SwitchParameter>]
Opens browser windows in fullscreen mode.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Width <Int32>
Sets initial browser window width in pixels.
Required? false
Position? named
Default value -1
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Height <Int32>
Sets initial browser window height in pixels.
Required? false
Position? named
Default value -1
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-X <Int32>
Sets initial browser window X position.
Required? false
Position? named
Default value -999999
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Y <Int32>
Sets initial browser window Y position.
Required? false
Position? named
Default value -999999
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Left [<SwitchParameter>]
Places browser window on left side of screen.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Right [<SwitchParameter>]
Places browser window on right side of screen.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Top [<SwitchParameter>]
Places browser window on top of screen.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Bottom [<SwitchParameter>]
Places browser window on bottom of screen.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Centered [<SwitchParameter>]
Centers browser window on screen.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-ApplicationMode [<SwitchParameter>]
Hides browser controls for clean app-like experience.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-NoBrowserExtensions [<SwitchParameter>]
Prevents loading of browser extensions.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-AcceptLang <String>
Sets browser accept-language HTTP header.
Required? false
Position? named
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-RestoreFocus [<SwitchParameter>]
Restores PowerShell window focus after opening bookmarks.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-NewWindow [<SwitchParameter>]
Creates new browser window instead of reusing existing one.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
-------------------------- EXAMPLE 1 --------------------------
PS > Open-BrowserBookmarks -Queries "github" -Edge -OpenInChrome -Count 5
-------------------------- EXAMPLE 2 --------------------------
PS > sites gh -e -och -c 5
RELATED LINKS
NAME Open-Webbrowser
SYNOPSIS Opens one or more webbrowser instances.
SYNTAX Open-Webbrowser [[-Url] <String[]>] [-Private] [-Force] [-Edge] [-Chrome] [-Chromium] [-Firefox] [-All] [-Monitor ] [-FullScreen] [-Width ] [-Height ] [-X ] [-Y ] [-Left] [-Right] [-Top] [-Bottom] [-Centered] [-ApplicationMode] [-NoBrowserExtensions] [-DisablePopupBlocker] [-AcceptLang ] [-RestoreFocus] [-NewWindow] [-PassThru] []
DESCRIPTION Opens one or more webbrowsers in a configurable manner, using commandline switches to control window position, size, and browser-specific features.
PARAMETERS -Url <String[]> The URL or URLs to open in the browser. Can be provided via pipeline.
Required? false
Position? 1
Default value
Accept pipeline input? true (ByValue)
Aliases
Accept wildcard characters? false
-Private [<SwitchParameter>]
Opens in incognito/private browsing mode.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Force [<SwitchParameter>]
Forces debugging port enabled, stopping existing browser processes if needed.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Edge [<SwitchParameter>]
Opens URLs in Microsoft Edge.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chrome [<SwitchParameter>]
Opens URLs in Google Chrome.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chromium [<SwitchParameter>]
Opens URLs in Microsoft Edge or Google Chrome, depending on default browser.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Firefox [<SwitchParameter>]
Opens URLs in Firefox.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-All [<SwitchParameter>]
Opens URLs in all registered modern browsers.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Monitor <Int32>
The monitor to use (0=default, -1=discard, -2=configured secondary).
Required? false
Position? named
Default value -2
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-FullScreen [<SwitchParameter>]
Opens browser in fullscreen mode.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Width <Int32>
Initial width of browser window.
Required? false
Position? named
Default value -1
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Height <Int32>
Initial height of browser window.
Required? false
Position? named
Default value -1
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-X <Int32>
Initial X position of browser window.
Required? false
Position? named
Default value -999999
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Y <Int32>
Initial Y position of browser window.
Required? false
Position? named
Default value -999999
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Left [<SwitchParameter>]
Places browser window on left side of screen.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Right [<SwitchParameter>]
Places browser window on right side of screen.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Top [<SwitchParameter>]
Places browser window on top of screen.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Bottom [<SwitchParameter>]
Places browser window on bottom of screen.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Centered [<SwitchParameter>]
Places browser window in center of screen.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-ApplicationMode [<SwitchParameter>]
Hides browser controls.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-NoBrowserExtensions [<SwitchParameter>]
Prevents loading of browser extensions.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-DisablePopupBlocker [<SwitchParameter>]
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-AcceptLang <String>
Sets browser accept-lang HTTP header.
Required? false
Position? named
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-RestoreFocus [<SwitchParameter>]
Restores PowerShell window focus after opening browser.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-NewWindow [<SwitchParameter>]
Creates new browser window instead of reusing existing one.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-PassThru [<SwitchParameter>]
Returns browser process object.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
NOTES
Requires the Windows 10+ Operating System
This cmdlet was mend to be used, interactively.
It performs some strange tricks to position windows, including invoking alt-tab keystrokes.
It's best not to touch the keyboard or mouse, while it is doing that.
For fast launches of multple urls:
SET : -Monitor -1
AND : DO NOT use any of these switches: -X, -Y, -Left, -Right, -Top, -Bottom or -RestoreFocus
For browsers that are not installed on the system, no actions may be performed or errors occur - at all.
-------------------------- EXAMPLE 1 --------------------------
PS > url from parameter
PS> Open-Webbrowser -Chrome -Left -Top -Url "https://genxdev.net/"
urls from pipeline
PS> @("https://genxdev.net/", "https://github.com/genXdev/") | Open-Webbrowser
re-position already open window to primary monitor on right side
PS> Open-Webbrowser -Monitor 0 -right
re-position already open window to secondary monitor, full screen
PS> Open-Webbrowser -Monitor 0
re-position already open window to secondary monitor, left top
PS> Open-Webbrowser -Monitor 0 -Left -Top
PS> wb -m 0 -left -top
RELATED LINKS
NAME Select-WebbrowserTab
SYNOPSIS Selects a browser tab for automation in Chrome or Edge.
SYNTAX Select-WebbrowserTab [[-Id] ] [-Edge] [-Chrome] [-Force] []
Select-WebbrowserTab [-Name] <String> [-Edge] [-Chrome] [-Force] [<CommonParameters>]
Select-WebbrowserTab [-Edge] [-Chrome] -ByReference <PSObject> [-Force] [<CommonParameters>]
DESCRIPTION Manages browser tab selection for automation tasks. Can select tabs by ID, name, or reference. Shows available tabs when no selection criteria are provided. Supports both Chrome and Edge browsers. Handles browser connection and session management.
PARAMETERS -Id Numeric identifier for the tab, shown when listing available tabs.
Required? false
Position? 1
Default value -1
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Name <String>
URL pattern to match when selecting a tab. Selects first matching tab.
Required? true
Position? 1
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? true
-Edge [<SwitchParameter>]
Switch to force selection in Microsoft Edge browser.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chrome [<SwitchParameter>]
Switch to force selection in Google Chrome browser.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-ByReference <PSObject>
Session reference object from Get-ChromiumSessionReference to select specific tab.
Required? true
Position? named
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Force [<SwitchParameter>]
Switch to force browser restart if needed during selection.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS System.String
System.Management.Automation.PSObject
-------------------------- EXAMPLE 1 --------------------------
PS > Select-WebbrowserTab -Id 3 -Chrome -Force
Selects tab ID 3 in Chrome browser, forcing restart if needed.
-------------------------- EXAMPLE 2 --------------------------
PS > st -Name "github.com" -e
Selects first tab containing "github.com" in Edge browser using alias.
RELATED LINKS
NAME Set-BrowserVideoFullscreen
SYNOPSIS Maximizes the first video element found in the current browser tab.
SYNTAX Set-BrowserVideoFullscreen [-WhatIf] [-Confirm] []
DESCRIPTION Executes JavaScript code to locate and maximize the first video element on the current webpage. The video is set to cover the entire viewport with maximum z-index to ensure visibility. Page scrollbars are hidden for a clean fullscreen experience.
PARAMETERS -WhatIf []
Required? false
Position? named
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Required? false
Position? named
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
-------------------------- EXAMPLE 1 --------------------------
PS > Set-BrowserVideoFullscreen
RELATED LINKS
NAME Set-RemoteDebuggerPortInBrowserShortcuts
SYNOPSIS Updates browser shortcuts to enable remote debugging ports.
SYNTAX Set-RemoteDebuggerPortInBrowserShortcuts [-WhatIf] [-Confirm] []
DESCRIPTION Modifies Chrome and Edge browser shortcuts to include remote debugging port parameters. This enables automation scripts to interact with the browsers through their debugging interfaces. Handles both user-specific and system-wide shortcuts.
The function:
- Removes any existing debugging port parameters
- Adds current debugging ports for Chrome and Edge
- Updates shortcuts in common locations (Desktop, Start Menu, Quick Launch)
- Requires administrative rights for system-wide shortcuts
PARAMETERS -WhatIf []
Required? false
Position? named
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Required? false
Position? named
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
NOTES
Requires administrative access to modify system shortcuts.
-------------------------- EXAMPLE 1 --------------------------
PS > Set-RemoteDebuggerPortInBrowserShortcuts
Updates all Chrome and Edge shortcuts with their respective debugging ports.
RELATED LINKS
NAME Set-WebbrowserTabLocation
SYNOPSIS Navigates the current webbrowser tab to a specified URL.
SYNTAX Set-WebbrowserTabLocation [-Url] [-WhatIf] [-Confirm] []
Set-WebbrowserTabLocation [-Url] <String> [-Edge] [-WhatIf] [-Confirm] [<CommonParameters>]
Set-WebbrowserTabLocation [-Url] <String> [-Chrome] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION Sets the location (URL) of the currently selected webbrowser tab. Supports both Edge and Chrome browsers through optional switches. The navigation includes validation of the URL and ensures proper page loading through async operations.
PARAMETERS -Url The target URL for navigation. Accepts pipeline input and must be a valid URL string. This parameter is required.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Aliases
Accept wildcard characters? false
-Edge [<SwitchParameter>]
Switch parameter to specifically target Microsoft Edge browser. Cannot be used
together with -Chrome parameter.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Chrome [<SwitchParameter>]
Switch parameter to specifically target Google Chrome browser. Cannot be used
together with -Edge parameter.
Required? false
Position? named
Default value False
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Required? false
Position? named
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Required? false
Position? named
Default value
Accept pipeline input? false
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
-------------------------- EXAMPLE 1 --------------------------
PS > Set-WebbrowserTabLocation -Url "https://github.com/microsoft" -Edge
-------------------------- EXAMPLE 2 --------------------------
PS > "https://github.com/microsoft" | lt -ch
RELATED LINKS
NAME Show-WebsiteInAllBrowsers
SYNOPSIS Opens a URL in multiple browsers simultaneously in a mosaic layout.
SYNTAX Show-WebsiteInAllBrowsers [-Url] []
DESCRIPTION This function creates a mosaic layout of browser windows by opening the specified URL in Chrome, Edge, Firefox, and a private browsing window. The browsers are arranged in a 2x2 grid pattern: - Chrome: Top-left quadrant - Edge: Bottom-left quadrant - Firefox: Top-right quadrant - Private window: Bottom-right quadrant
PARAMETERS -Url The URL to open in all browsers. Accepts pipeline input and can be specified by position or through properties.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Aliases
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
-------------------------- EXAMPLE 1 --------------------------
PS > Show-WebsiteInAllBrowsers -Url "https://www.github.com"
Opens github.com in four different browsers arranged in a mosaic layout.
-------------------------- EXAMPLE 2 --------------------------
PS > "https://www.github.com" | Show-UrlInAllBrowsers
Uses the function's alias and pipeline input to achieve the same result.
RELATED LINKS