Manage-WirelssNetworks.psm1

Function Export-WirelessNetworkProfile {
    <#
    .LINK
    https://github.com/si-kotic/Manage-WirelessNetworks
    #>
    Param (
        [Parameter(ValueFromPipeline=$true,Mandatory)]$SSID,
        $Path = $PWD,
        [Switch]$PlaintextPassword
    )
    IF ($SSID.GetType().Name -eq "PSCustomObject") {
        $ssidName = $SSID.SSID
    } ELSEIF ($SSID.GetType().Name -eq "String") {
        $SSID = Get-AvailableWirelessNetworks -SSID $SSID
        $ssidName = $SSID.SSID
    }
    IF ($PlaintextPassword) {
        netsh wlan export profile name=$ssidName folder="$Path" key=clear
    } ELSE {
        netsh wlan export profile name=$ssidName folder="$Path"
    }
}

Function Import-WirelessNetworkProfile {
    <#
    .LINK
    https://github.com/si-kotic/Manage-WirelessNetworks
    #>
    Param (
        [Parameter(Mandatory)]$Profile
    )
    netsh wlan add profile filename="$Profile"
}

Function Get-AvailableWirelessNetworks {
    <#
    .LINK
    https://github.com/si-kotic/Manage-WirelessNetworks
    #>
    Param (
        [Parameter(ValueFromPipeline=$true)]$SSID
    )
    $response = netsh wlan show networks mode=bssid
    $wLANs = $response | Where-Object {$_ -match "^SSID"} | Foreach-Object {
        $report = "" | Select SSID,NetworkType,Authentication,Encryption
        $i = $response.IndexOf($_)
        $report.SSID = $_ -replace "^SSID\s\d+\s:\s",""
        $report.NetworkType = $response[$i+1].Split(":")[1].Trim()
        $report.Authentication = $response[$i+2].Split(":")[1].Trim()
        $report.Encryption = $response[$i+3].Split(":")[1].Trim()
        $report
    }
    IF ($SSID) {
        $wLANs | Where-Object {$_.SSID -eq $SSID}
    } ELSE {
        $wLANs
    }
}

Function ConnectTo-WirelessNetwork {
    <#
    .LINK
    https://github.com/si-kotic/Manage-WirelessNetworks
    #>
    Param (
        [Parameter(ValueFromPipeline=$true,Mandatory)]$SSID,
        $Profile
    )
    IF ($SSID.GetType().Name -eq "PSCustomObject") {
        $ssidName = $SSID.SSID
    } ELSEIF ($SSID.GetType().Name -eq "String") {
        $SSID = Get-AvailableWirelessNetworks -SSID $SSID
        $ssidName = $SSID.SSID
    }
    $wlanProfile = netsh wlan show profiles name=$ssidName
    IF ($wlanProfile -eq ('Profile "' + $ssidName + '" is not found on the system.')) {
        Write-Host "New Wireless Network detected.  Not yet supported" -ForegroundColor Red
    }
    IF ($Profile) {
        netsh wlan connect ssid=$ssidName name=$Profile
    } ELSE {
        netsh wlan connect ssid=$ssidName name=$ssidName
    }
}

Function Get-WirelessNetworkProfiles {
    <#
    .LINK
    https://github.com/si-kotic/Manage-WirelessNetworks
    #>
    Param (
        [Parameter(ValueFromPipeline=$true)]$SSID
    )
    IF ($SSID) {
        IF ($SSID.GetType().Name -eq "PSCustomObject") {
            $ssidName = $SSID.SSID
        } ELSEIF ($SSID.GetType().Name -eq "String") {
            $SSID = Get-AvailableWirelessNetworks -SSID $SSID
            $ssidName = $SSID.SSID
        }
        netsh wlan show profiles name="$ssidName"
    } ELSE {
        $response = netsh wlan show profiles
        $profiles = $response[9..($response.length-1)].Trim() -replace "\s{5}:\s","," | Foreach-Object {
            $report = "" | Select SSID,UserProfile
            $obj = $_.Split(",")
            $report.SSID = $obj[1]
            $report.UserProfile = $obj[0]
            $report
        }
        $profiles
    }
}