WifiConnectionAPI

Author(s)

• Tvanleeuwen

Tags

wifi wi-fi radio connectivity automation networkadapter wpa2 wpa3 entrerprise 8021x 802.1x user password eap radius bssid ssid winrt

Functions

Get-RadioState Set-RadioState Get-WifiDeviceInformation Get-WiFiAvailableAdapter Get-WifiConnectionProfile Remove-WifiConnectionProfile Get-WifiAvailableNetworks Search-WifiNetworks Get-WifiCurrentConnection Disconnect-WifiNetwork Connect-WiFiNetwork Request-LocationPermission

Dependencies

This module has no dependencies.

Release Notes

Minor Update V2.3.0.0

Location Access Requirement:

For the module to function properly, access to location-aware desktop apps is required. Without this, the script may not work correctly.

New Function – Request-LocationPermission:

A new function, Request-LocationPermission, has been implemented to check if PowerShell has the necessary access to the system’s location services.

This function will be called internally by other functions to prevent failures related to location access.

Minor Update V2.2.0.0

Bug Fixes: Resolved multiple issues for smoother operation.

Cancel Support: Added the ability to interrupt Search and Connection commands with Ctrl+C.

Minor Update V2.1.1.0

Autocompleter Fix: The SSID and BSSID autocompleter now works properly even when the radio is off.

Minor Update V2.1.0.0

Changes to the Await Function:

Timeout for the Await function has been adjusted. The default is now 10 seconds, but it's customizable between 1 and 60 seconds.

You can adjust the timeout at function call with the -TimeoutMS parameter.
Example:

Await-Function -TimeoutMS 12345

New Features:

Wi-Fi Reconnection Options:

The Connect-WifiNetwork cmdlet now allows you to choose between automatic and manual reconnection using the -WifiReconnectionKind parameter.

Automatic is the default.
Example:

Connect-WifiNetwork -ssid "WifiNetworkName" -WifiReconnectionKind Manual

Network Adapter Filtering:

You can now filter available Wi-Fi networks by a specific network adapter with the -DeviceName parameter.
Example:

Get-WifiAvailableNetworks -DeviceName "Your Adapter Name"

Multi-Adapter Support:

Supports targeting specific Wi-Fi adapters with the -Index parameter, allowing you to specify which adapter to use for connecting.

Intelligent Connection:

The cmdlet will now automatically connect to available Windows profiles, saving time.

Enhanced User Experience (UX):

Tab-completion now works for hardware names, making it easier to use.

Network Cache Update:

A new function has been added to Search-WiFiNetworks to update the cached list of available networks, ensuring up-to-date information.

Hidden Network Support:

You can now connect to hidden Wi-Fi networks using the -Hidden flag.

When connecting to a hidden SSID, you must manually specify the SSID.
Example:

Connect-WifiNetwork -Hidden -bssid 11:22:33:44:55:66 -ssid "YourHiddenSSID"

The -BSSID parameter can be used to target specific access points, especially useful in areas with multiple access points or dual-band routers.

Remarks:

The BSSID allows targeting specific access points, making it easier to control network selection in complex environments.

Hidden Network Support and BSSID functionality help provide more control over your Wi-Fi connections, especially in crowded or multi-router settings.