Module used for management of wireless profiles.
This module leverages the native WiFi functions. I wanted to learn more about interoperability and have a PowerShell (not using netsh.exe) way to view passwords of WiFi profiles so I decided to work on this in my free time. Any feedback on how this module can be improved is welcome.
Drop the root folder in your PSModulePath, remove the branch name (ex. -dev )from the folder, and PowerShell should find the module.
- Get-WiFiProfile Retrieves the information of a WiFi profile.
- Set-WiFiProfile Overwrites a existent WiFi profile.
- New-WiFiProfile Creates a new WiFi profile.
- Remove-WiFiProfile Deletes a WiFi profile.
- Get-WiFiAvailableNetwork Retrieves the list of available networks on a wireless LAN interface.
- Connect-WiFiProfile Attempts to connect to a specific network.
- Search-WiFiNetwork Requests a scan for available wifi networks.
- Set-WiFiInterface Toggles the software wifi radio state on/off.
- ProfileName: The name of the WiFi profile. If not specified, The function will return all profiles.
- WiFiAdapterName: Specifies the name of the wireless network adapter on the machine. This is used to obtain the Guid of the interface. The default value is 'Wi-Fi'
- ClearKey: Specifies if the password of the profile is to be returned.
- ProfileName: The name of the WiFi profile to modify.
- ConnectionMode: Indicates whether connection to the wireless LAN should be automatic ("auto") or initiated ("manual") by user. The default is "auto".
- Authentication: Specifies the authentication method to be used to connect to the wireless LAN. ('open', 'shared', 'WPA', 'WPAPSK', 'WPA2', 'WPA2PSK', 'WPA3SAE', 'WPA3ENT192', 'OWE')
- Encryption: Sets the data encryption to use to connect to the wireless LAN. ('none', 'WEP', 'TKIP', 'AES', 'GCMP256')
- Password: The network key or passpharse of the wireless profile in the form of a secure string.
- ConnectHiddenSSID: Specifies whether the profile can connect to networks which does not broadcast SSID. The default is false.
- EAPType: (Only 802.1X) Specifies the type of 802.1X EAP. You can select "PEAP"(aka MSCHAPv2) or "TLS".
- ServerNames: (Only 802.1X) Specifies the server that will be connect to validate certification.
- TrustedRootCA: (Only 802.1X) Specifies the certificate thumbprint of the Trusted Root CA.
- XmlProfile: The XML representation of the profile.
- ProfileName: The name of the new WiFi profile.
- ConnectionMode: Indicates whether connection to the wireless LAN should be automatic ("auto") or initiated ("manual") by user. The default is "auto".
- Authentication: Specifies the authentication method to be used to connect to the wireless LAN. ('open', 'shared', 'WPA', 'WPAPSK', 'WPA2', 'WPA2PSK', 'WPA3SAE', 'WPA3ENT192', 'OWE')
- Encryption: Sets the data encryption to use to connect to the wireless LAN. ('none', 'WEP', 'TKIP', 'AES', 'GCMP256')
- Password: The network key or passpharse of the wireless profile in the form of a secure string.
- XmlProfile: The XML representation of the profile.
- ProfileName: The name of the profile to be deleted. Profile names are case-sensitive.
- WiFiAdapterName: Specifies the name of the wireless network adapter on the machine. This is used to obtain the Guid of the interface. The default value is 'Wi-Fi'
- WiFiAdapterName: Specifies the name of the wireless network adapter on the machine. This is used to obtain the Guid of the interface. The default value is 'Wi-Fi'
- ProfileName: The name of the profile to be connected. Profile names are case-sensitive.
- ConnectionMode: Specifies the mode of the connection. Valid values are Profile,TemporaryProfile,DiscoveryProfile,DiscoveryUnsecure, and Auto.
- Dot11BssType: A value that indicates the BSS type of the network. If a profile is provided, this BSS type must be the same as the one in the profile.
- WiFiAdapterName: Specifies the name of the wireless network adapter on the machine. This is used to obtain the Guid of the interface. The default value is 'Wi-Fi'
- WiFiAdapterName: Specifies the name of the wireless network adapter on the machine. This is used to obtain the Guid of the interface. The default value is 'Wi-Fi'
- WiFiAdapterName: Specifies the name of the wireless network adapter on the machine. This is used to obtain the Guid of the interface. The default value is 'Wi-Fi'
- State: Specifies the state of the wifi radio. Valid values are on/off.
PS C:\>Get-WiFiProfile -ProfileName TestWiFi
ProfileName : TestWiFi
ConnectionMode : auto
Authentication : WPA2PSK
Encryption : AES
Password :
PS C:\>Get-WiFiProfile -ProfileName TestWiFi -ClearKey
ProfileName : TestWiFi
ConnectionMode : auto
Authentication : WPA2PSK
Encryption : AES
Password : password1
PS C:\>Remove-WiFiProfile -ProfileName FreeWifi
PS C:\>$password = Read-Host -AsSecureString
**********
PS C:\>Set-WiFiProfile -ProfileName MyNetwork -ConnectionMode auto -Authentication WPA2PSK -Encryption AES -Password $password
PS C:\>$templateProfileXML = @"
<?xml version="1.0"?>
<WLANProfile xmlns="http://www.microsoft.com/networking/WLAN/profile/v1">
<name>MyNetwork</name>
<SSIDConfig>
<SSID>
<name>MyNetwork</name>
</SSID>
</SSIDConfig>
<connectionType>ESS</connectionType>
<connectionMode>manual</connectionMode>
<MSM>
<security>
<authEncryption>
<authentication>WPA2PSK</authentication>
<encryption>AES</encryption>
<useOneX>false</useOneX>
</authEncryption>
<sharedKey>
<keyType>passPhrase</keyType>
<protected>false</protected>
<keyMaterial>password1</keyMaterial>
</sharedKey>
</security>
</MSM>
</WLANProfile>
"@
PS C:\>Set-WiFiProfile -XmlProfile $templateProfileXML
PS C:\>$password = Read-Host -AsSecureString
**********
PS C:\>New-WiFiProfile -ProfileName MyNetwork -ConnectionMode auto -Authentication WPA2PSK -Encryption AES -Password $password
PS C:\>New-WiFiProfile -ProfileName OneXNetwork -ConnectionMode auto -Authentication WPA2 -Encryption AES -EAPType PEAP -TrustedRootCA '041101cca5b336a9c6e50d173489f5929e1b4b00'
PS C:\>Get-WiFiAvailableNetwork
SSID SignalStength SecurityEnabled dot11DefaultAuthAlgorithm dot11DefaultCipherAlgorithm
---- ------------- --------------- ------------------------- ---------------------------
63 True DOT11_AUTH_ALGO_RSNA_PSK DOT11_CIPHER_ALGO_CCMP
gogoinflight 63 False DOT11_AUTH_ALGO_80211_OPEN DOT11_CIPHER_ALGO_NONE
PS C:\> $password = Read-Host -AsSecureString
************
PS C:\> New-WiFiProfile -ProfileName MyNetwork -ConnectionMode auto -Authentication WPA2PSK -Encryption AES -Password $password
The operation was successful.
PS C:\> Connect-WiFiProfile -ProfileName MyNetwork
- Added Set-WiFiInterface to allow toggling the wifi adapter on/off.
- Added private function Get-WiFiInterface contributed by @jimcroft
- Added Search-WifiNetwork.
- Add support for WPA3 and Wi-Fi Enhanced Open contributed by @mkht
- Added support for create IEEE 802.1X EAP network profile.
- Added Connect-WiFiProfile. Add new scaffolding.
- Added Get-WiFiAvailableNetwork. Moved code that enables Windows 7 compatibility to a function.
- Added New-WiFiProfile
- Added Set-WiFiProfile
- Added formating
- Initial released with the following functions
- Get-WiFiProfile
- Remove-WiFiProfile