{"id":3118,"date":"2013-08-02T00:01:00","date_gmt":"2013-08-02T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2013\/08\/02\/more-messing-around-with-wireless-settings-with-powershell\/"},"modified":"2013-08-02T00:01:00","modified_gmt":"2013-08-02T00:01:00","slug":"more-messing-around-with-wireless-settings-with-powershell","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/more-messing-around-with-wireless-settings-with-powershell\/","title":{"rendered":"More Messing Around with Wireless Settings with PowerShell"},"content":{"rendered":"

Summary<\/strong>: Microsoft Scripting Guy, Ed Wilson, talks about messing around with wireless settings with Windows PowerShell.<\/span><\/p>\n

Microsoft Scripting Guy, Ed Wilson, is here. OK, I will admit it (in case you did not know), I am a geek. I also love my job at Microsoft. I get to play around with Windows PowerShell all day. I have meetings with people who are working on Windows PowerShell, and I attend user groups for Windows PowerShell, and speak at conferences to people who love Windows PowerShell. So what is not to love? Nothing! It is great!<\/p>\n

One of the real treats I have is being on our internal Windows PowerShell discussion alias. Of course, some of the entries on the alias are confidential, but most are not. The writers are a bunch of geeks like me, who love experimenting and pushing the limits of Windows PowerShell. In the early days of Windows PowerShell 1.0 (when it was in beta), I believe someone wrote a song called there must be 50 ways to kill a process. Because Windows PowerShell is so powerful, and because it can leverage so many different technologies, there are quite often many different ways of accomplishing the same task. Which one is best?<\/p>\n

The standard consultant answer may very well apply, but it depends. In all likelihood your Windows PowerShell experience is completely different than mine. I do stuff because it is fun and because I want to learn new things. You are probably working with Windows PowerShell because you have a task to perform, and you are in search of a solution. In that case, the best solution is the one that is easiest, fastest, most powerful, or that uses a technology with which you are already familiar. As you can see, best is certainly relative.<\/p>\n

A few weeks ago I wrote a couple of blog posts that talked about enumerating wireless network connection profiles and cleaning up wireless profiles that are not needed. Also a while back, there was an email on our internal Windows PowerShell discussion alias where one of our engineers mentioned the Windows.Networking.Connectivity.NetworkInformation .NET Framework class. He showed how to use it to get the wireless connection cost and the network cost type. “Hmmmm,” I thought…<\/p>\n

Use the NetworkInformation class to get connection cost info<\/h2>\n

You can find information on MSDN about the NetworkInformation class<\/a>. But in reality, the class methods are pretty straight forward, and they are discoverable via Get-Member<\/strong>. Before using the NetworkInformation class, however, I must load the assembly. This is a bit strange (compared to the way that other assemblies load) so here is the code:<\/p>\n

[<\/span><\/span><\/span>void<\/span><\/span><\/span>][<\/span><\/span><\/span>Windows.Networking.Connectivity.NetworkInformation<\/span><\/span><\/span>,<\/span><\/span><\/span>Windows<\/span><\/span><\/span>,<\/span><\/span><\/span>ContentType<\/span><\/span><\/span>=<\/span><\/span><\/span>WindowsRuntime<\/span><\/span><\/span>] <\/span><\/span><\/span><\/span><\/p>\n

Now I can use the GetConnectionProfiles method to show the profiles on my computer. They appear here:<\/p>\n

PS C:\\> [Windows.Networking.Connectivity.NetworkInformation]::GetConnectionProfiles()<\/p>\n

 <\/p>\n

NetworkAdapter                             NetworkSecuritySettings                    ProfileName                               <\/p>\n

————–                             ———————–                    ———–                              <\/p>\n

Windows.Networking.Connectivity.Network… Windows.Networking.Connectivity.Network… Bluetooth Network Connection              <\/p>\n

Windows.Networking.Connectivity.Network… Windows.Networking.Connectivity.Network… MrEd                                     <\/p>\n

Windows.Networking.Connectivity.Network… Windows.Networking.Connectivity.Network… NOKIA Lumia 920_3303                      <\/p>\n

Windows.Networking.Connectivity.Network… Windows.Networking.Connectivity.Network… Hyatt_Wifi                               <\/p>\n

Windows.Networking.Connectivity.Network… Windows.Networking.Connectivity.Network… A-MSFTWLAN                                <\/p>\n

Windows.Networking.Connectivity.Network… Windows.Networking.Connectivity.Network… KFC Wifi                                 <\/p>\n

Windows.Networking.Connectivity.Network… Windows.Networking.Connectivity.Network… Hyatt                                     <\/p>\n

Windows.Networking.Connectivity.Network… Windows.Networking.Connectivity.Network… Free_WiFi                                <\/p>\n

Windows.Networking.Connectivity.Network… Windows.Networking.Connectivity.Network… STARBUCKS                                <\/p>\n

The trick to using this class in Windows PowerShell does not really show up in the class documentation on MSDN. When calling the class, I need to specify that the Windows.ContentType<\/strong> is equal to WindowsRunTime<\/strong>. This loads the class, and permits me to easily call its methods. I only need to do this once per PowerShell session. After that, it is loaded. Following is where I do that (I cast it to void because I do not need any feedback from loading the assembly):<\/p>\n

[void][Windows.Networking.Connectivity.NetworkInformation,Windows,ContentType=WindowsRuntime]<\/p>\n

Now, I call the GetInternetConnectionProfile<\/strong> method, and I store the returned ConnectionProfile<\/strong> object in the $connectionProfile<\/strong> variable. I now call the GetConnectionCost<\/strong> method. This method returns a ConnectionCost<\/strong> object. From that, I get the NetworkCostType<\/strong> property. Here is the remainder of the script:<\/p>\n

$connectionProfile = [Windows.Networking.Connectivity.NetworkInformation]::GetInternetConnectionProfile()<\/p>\n

$connectionCost = $connectionProfile.GetConnectionCost()<\/p>\n

$networkCostType = $connectionCost.NetworkCostType<\/p>\n

echo $networkCostType<\/p>\n

When I run the script, the following output displays and tells me that my Internet connection is unrestricted:<\/p>\n

\"Image<\/a><\/p>\n

My complete script appears here:<\/p>\n

[<\/span><\/span><\/span>void<\/span><\/span><\/span>][<\/span><\/span><\/span>Windows.Networking.Connectivity.NetworkInformation<\/span><\/span><\/span>,<\/span><\/span><\/span>Windows<\/span><\/span><\/span>,<\/span><\/span><\/span>ContentType<\/span><\/span><\/span>=<\/span><\/span><\/span>WindowsRuntime<\/span><\/span><\/span>]<\/span><\/span><\/span><\/span><\/p>\n

$connectionProfile=<\/span><\/span><\/span>[<\/span><\/span><\/span>Windows.Networking.Connectivity.NetworkInformation<\/span><\/span><\/span>]::<\/span><\/span><\/span>GetInternetConnectionProfile()<\/span><\/span><\/span><\/p>\n

$connectionCost=<\/span><\/span><\/span>$connectionProfile<\/span><\/span><\/span>.<\/span><\/span><\/span>GetConnectionCost()<\/span><\/span><\/span><\/p>\n

$networkCostType=<\/span><\/span><\/span>$connectionCost<\/span><\/span><\/span>.<\/span><\/span><\/span>NetworkCostType<\/span><\/span><\/span><\/p>\n

echo $networkCostType <\/span><\/span><\/span><\/span><\/p>\n

Exploring security settings or network adapter information<\/h2>\n

The properties from the ConnectionProfile<\/strong> object each return additional objects. This is shown here:<\/p>\n

PS C:\\> [Windows.Networking.Connectivity.NetworkInformation]::GetInternetConnectionProfile() | Get-Member -MemberType Property<\/p>\n

 <\/span><\/p>\n

   TypeName: Windows.Networking.Connectivity.ConnectionProfile<\/p>\n

 <\/p>\n

Name                    MemberType Definition                                                                           <\/p>\n

—-                    ———- ———-                                                                            <\/p>\n

NetworkAdapter          Property   Windows.Networking.Connectivity.NetworkAdapter NetworkAdapter {get;}                 <\/p>\n

NetworkSecuritySettings Property   Windows.Networking.Connectivity.NetworkSecuritySettings NetworkSecuritySettings {get;}<\/p>\n

ProfileName             Property   string ProfileName {get;}  <\/p>\n

I can directly access each of the objects by using dotted notation after the method call. For example, I can get the NetworkAdapter<\/strong> information by placing NetworkAdapter<\/strong> at the end of the method call as shown here:<\/p>\n

[Windows.Networking.Connectivity.NetworkInformation]::GetInternetConnectionProfile().NetworkAdapter<\/p>\n

In the image that follows, I explore the NetworkSecuritySettings<\/strong> object and the NetworkAdapter<\/strong> object.  <\/p>\n

\"Image<\/a><\/p>\n

Another way to find stored network connection profiles<\/h2>\n

OK, that is cool. But what I want to do is to look at stored network connection profiles. This is simple—tab expansion even works for this in the ISE. I call the GetConnectionProfiles<\/strong> static method. This technique is shown here: <\/span><\/p>\n

PS C:\\> [Windows.Networking.Connectivity.NetworkInformation]::GetConnectionProfiles()<\/p>\n

 <\/p>\n

NetworkAdapter                             NetworkSecuritySettings                    ProfileName                               <\/p>\n

————–                             ———————–                    ———–                              <\/p>\n

Windows.Networking.Connectivity.Network… Windows.Networking.Connectivity.Network… Bluetooth Network Connection             <\/p>\n

Windows.Networking.Connectivity.Network… Windows.Networking.Connectivity.Network… MrEd                                     <\/p>\n

Windows.Networking.Connectivity.Network… Windows.Networking.Connectivity.Network… NOKIA Lumia 920_3303                     <\/p>\n

Windows.Networking.Connectivity.Network… Windows.Networking.Connectivity.Network… Hyatt_Wifi                               <\/p>\n

Windows.Networking.Connectivity.Network… Windows.Networking.Connectivity.Network… A-MSFTWLAN                               <\/p>\n

Windows.Networking.Connectivity.Network… Windows.Networking.Connectivity.Network… KFC Wifi                                 <\/p>\n

Windows.Networking.Connectivity.Network… Windows.Networking.Connectivity.Network… Hyatt                                    <\/p>\n

Windows.Networking.Connectivity.Network… Windows.Networking.Connectivity.Network… Free_WiFi                                <\/p>\n

Windows.Networking.Connectivity.Network… Windows.Networking.Connectivity.Network… STARBUCKS                               <\/p>\n

That is all there is to using Windows PowerShell to mess around with wireless settings. Join me tomorrow when I will talk about more cool Windows PowerShell stuff.<\/p>\n

I invite you to follow me on Twitter<\/a> and Facebook<\/a>. If you have any questions, send email to me at scripter@microsoft.com<\/a>, or post your questions on the Official Scripting Guys Forum<\/a>. See you tomorrow. Until then, peace.<\/p>\n

Ed Wilson, Microsoft Scripting Guy<\/strong> <\/span><\/p>\n","protected":false},"excerpt":{"rendered":"

Summary: Microsoft Scripting Guy, Ed Wilson, talks about messing around with wireless settings with Windows PowerShell. Microsoft Scripting Guy, Ed Wilson, is here. OK, I will admit it (in case you did not know), I am a geek. I also love my job at Microsoft. I get to play around with Windows PowerShell all day. […]<\/p>\n","protected":false},"author":596,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[66,332,37,3,4,45],"class_list":["post-3118","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-net-framework","tag-network-adapters","tag-networking","tag-scripting-guy","tag-scripting-techniques","tag-windows-powershell"],"acf":[],"blog_post_summary":"

Summary: Microsoft Scripting Guy, Ed Wilson, talks about messing around with wireless settings with Windows PowerShell. Microsoft Scripting Guy, Ed Wilson, is here. OK, I will admit it (in case you did not know), I am a geek. I also love my job at Microsoft. I get to play around with Windows PowerShell all day. […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/3118","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/users\/596"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=3118"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/3118\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media\/87096"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media?parent=3118"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=3118"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=3118"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}