{"id":64193,"date":"2007-08-21T01:38:00","date_gmt":"2007-08-21T01:38:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2007\/08\/21\/how-can-i-tell-if-a-wireless-network-adapter-is-connected-to-the-network\/"},"modified":"2007-08-21T01:38:00","modified_gmt":"2007-08-21T01:38:00","slug":"how-can-i-tell-if-a-wireless-network-adapter-is-connected-to-the-network","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/how-can-i-tell-if-a-wireless-network-adapter-is-connected-to-the-network\/","title":{"rendered":"How Can I Tell If a Wireless Network Adapter is Connected to the Network?"},"content":{"rendered":"

\"Hey, \n

Hey, Scripting Guy! How can I tell if a specific wireless network adapter is connected to the network?

— MS <\/P>\"Spacer\"\"Hey,\"Script<\/A> \n

Hey, MS. You know, this is a sad day for the Scripting Guy who writes this column. After 10 days of eating Italian pastries, visiting the ruins of ancient cities, and flitting about Venice on water taxis, well, it\u2019s time to go home. In fact, even as we speak, the Scripting Family is preparing to take one final water taxi ride back to the Marco Polo Airport. And the Scripting Guy who writes this column is preparing to eat one last zeppole: fried dough topped with cinnamon and sugar.<\/P>\n

One last zeppole?<\/I> Excuse us for a moment; the Scripting Guy who writes this column is about to cry.<\/P>\n

Oh, well. You know what they say: all good things must come to an end. Before his Italian vacation comes to an end, however, the Scripting Guy who writes this column has vowed to do two things: eat a few more zeppoles, and show everyone a script that can tell you whether a specific wireless network adapter is connected to the network:<\/P>

strComputer = “.”<\/p>\n
Set objWMIService = GetObject(“winmgmts:\\\\” & strComputer & “\\root\\cimv2”)<\/p>\n
Set colItems = objWMIService.ExecQuery _\n    (“Select * from Win32_NetworkAdapter Where Name = ‘Broadcom 802.11a\/b\/g WLAN'”)<\/p>\n
For Each objItem in colItems\n    Select Case objItem.NetConnectionStatus\n        Case 0 strStatus = “Disconnected”\n        Case 1 strStatus = “Connecting” \n        Case 2 strStatus = “Connected” \n        Case 3 strStatus = “Disconnecting” \n        Case 4 strStatus = “Hardware not present” \n        Case 5 strStatus = “Hardware disabled” \n        Case 6 strStatus = “Hardware malfunction” \n        Case 7 strStatus = “Media disconnected” \n        Case 8 strStatus = “Authenticating” \n        Case 9 strStatus = “Authentication succeeded” \n        Case 10 strStatus = “Authentication failed” \n        Case 11 strStatus = “Invalid address” \n        Case 12 strStatus = “Credentials required”\n    End Select \n    Wscript.Echo “Net Connection Status: ” & strStatus\nNext\n<\/PRE>\n
As you can see, this isn\u2019t a particularly complicated script; as it is, most of the code involves a Select Case statement that converts return values (such as 0<\/I>) into more meaningful string values (such as Disconnected<\/I>). Other than that, there isn\u2019t all that much to it.<\/P>\n
The script starts out by connecting to the WMI service on the local computer. Could we check the status of a network adapter on a remote computer? Sure, but with one caveat. We can definitely attempt<\/I> to connect to the remote computer; to do that we simply assign the name of that computer to the variable strComputer:<\/P>
strComputer = “atl-fs-01”\n<\/PRE>\n
The only catch, of course, is that if this computer has only a single network adapter (the wireless card) and if the wireless card isn\u2019t currently connected then it goes without saying (although we\u2019ll say it anyway) that we won\u2019t be able to connect to that computer, let alone to the WMI service on that computer. At that point we have no way of knowing: 1) whether the computer is running, but not connected to the network, or 2) whether the computer isn\u2019t running at all. Most likely that distinction won\u2019t matter to you, but it\u2019s something to keep in mind, just in case.<\/P>\n
According to MS, their organization has standardized on a single wireless card; that makes it easy to extract information about only that particular network adapter:<\/P>
Set colItems = objWMIService.ExecQuery _\n    (“Select * from Win32_NetworkAdapter Where Name = ‘Broadcom 802.11a\/b\/g WLAN'”)\n<\/PRE>\n
As you probably already figured out for yourself, the preceding line of code retrieves information only about network adapters (instances of the Win32_NetworkAdapter<\/B> class) that have the Name<\/B> value Broadcom 802.11a\/b\/g WLAN<\/I>. What if you use a different wireless card? That\u2019s no problem; just change the name of the card in the WQL query. For example, if your wireless card is named My Wireless Adapter<\/I> then modify the WQL query to look like this:<\/P>
Set colItems = objWMIService.ExecQuery _\n    (“Select * from Win32_NetworkAdapter Where Name = ‘My Wireless Adapter'”)\n<\/PRE>\n
And what if your organization uses all make and manner of wireless adapters? Don\u2019t worry; at the end of this article we\u2019ll show you a script that returns network connection information for all the wireless adapters on a computer, regardless of their name. <\/P>\n
But first, the script we wrote for MS. After we issue our query we get back a recordset containing all the network adapters that have the Name Broadcom 802.11a\/b\/g WLAN<\/I>. From there we set up a For Each loop to loop through this collection. Inside that loop, we use a Select Case<\/B> statement to grab the value of the NetConnectionStatus<\/B> property; this value will be an integer corresponding to one of the following states:<\/P>\n\n<\/THEAD>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
\n
Value<\/B><\/P><\/TD>\n
\n
State<\/B><\/P><\/TD><\/TR>\n
\n
0<\/P><\/TD>\n
\n
Disconnected<\/P><\/TD><\/TR>\n
\n
1<\/P><\/TD>\n
\n
Connecting<\/P><\/TD><\/TR>\n
\n
2<\/P><\/TD>\n
\n
Connected<\/P><\/TD><\/TR>\n
\n
3<\/P><\/TD>\n
\n
Disconnecting<\/P><\/TD><\/TR>\n
\n
4<\/P><\/TD>\n
\n
Hardware not present<\/P><\/TD><\/TR>\n
\n
5<\/P><\/TD>\n
\n
Hardware disabled<\/P><\/TD><\/TR>\n
\n
6<\/P><\/TD>\n
\n
Hardware malfunction<\/P><\/TD><\/TR>\n
\n
7<\/P><\/TD>\n
\n
Media disconnected<\/P><\/TD><\/TR>\n
\n
8<\/P><\/TD>\n
\n
Authenticating<\/P><\/TD><\/TR>\n
\n
9<\/P><\/TD>\n
\n
Authentication succeeded<\/P><\/TD><\/TR>\n
\n
10<\/P><\/TD>\n
\n
Authentication failed<\/P><\/TD><\/TR>\n
\n
11<\/P><\/TD>\n
\n
Invalid address<\/P><\/TD><\/TR>\n
\n
12<\/P><\/TD>\n
\n
Credentials required<\/P><\/TD><\/TR><\/TBODY><\/TABLE>\n
<\/DIV>\n
In our Select Case statement we simply take a peek at the value of NetConnectionStatus and then assign the corresponding state to the variable strStatus. For example, if NetConnectionStatus is equal to 0 then we execute this line of code:<\/P>
Case 0 strStatus = “Disconnected”\n<\/PRE>\n
After that all we have to do is to echo back the connection status, using the value we assigned to the variable strStatus rather than the value of the NetConnectionStatus property:<\/P>
Wscript.Echo “Net Connection Status: ” & strStatus\n<\/PRE>\n
In turn, that means we\u2019ll see a report similar to this:<\/P>
Net Connection status: Authentication succeeded\n<\/PRE>\n
As for a generic script, one that returns the network connection status of all<\/I> the wireless adapters on a computer, well, this following bit of code seems to do the trick:<\/P>
strComputer = “.”<\/p>\n
Set objWMIService = GetObject(“winmgmts:\\\\” & strComputer & “\\root\\wmi”)<\/p>\n
Set colItems = objWMIService.ExecQuery(“Select * From MSNdis_80211_Configuration”)<\/p>\n
For Each objItem in colItems<\/p>\n
    strName = objItem.InstanceName<\/p>\n
    Set objWMIService2 = GetObject(“winmgmts:\\\\” & strComputer & “\\root\\cimv2”)<\/p>\n
    Set colAdapters = objWMIService2.ExecQuery _\n        (“Select * from Win32_NetworkAdapter Where Name = ‘” & strName & “‘”)<\/p>\n
    For Each objAdapter in colAdapters\n        Select Case objAdapter.NetConnectionStatus\n            Case 0 strStatus = “Disconnected”\n            Case 1 strStatus = “Connecting” \n            Case 2 strStatus = “Connected” \n            Case 3 strStatus = “Disconnecting” \n            Case 4 strStatus = “Hardware not present” \n            Case 5 strStatus = “Hardware disabled” \n            Case 6 strStatus = “Hardware malfunction” \n            Case 7 strStatus = “Media disconnected” \n            Case 8 strStatus = “Authenticating” \n            Case 9 strStatus = “Authentication succeeded” \n            Case 10 strStatus = “Authentication failed” \n            Case 11 strStatus = “Invalid address” \n            Case 12 strStatus = “Credentials required”\n        End Select <\/p>\n
        Wscript.Echo strName\n        Wscript.Echo “Net Connection Status: ” & strStatus\n        Wscript.Echo\n    Next\nNext\n<\/PRE>\n
We won\u2019t discuss this in any detail today. Instead, we\u2019ll simply note that we start out by using the following line of code to bind us to the root\\wmi<\/B> namespace:<\/P>
Set objWMIService = GetObject(“winmgmts:\\\\” & strComputer & “\\root\\wmi”)\n<\/PRE>\n
We then select all instances of the MSNdis_80211_Configuration<\/B> class, a class that returns information about all the wireless adapters (including virtual adapters) installed on the computer:<\/P>
Set colItems = objWMIService.ExecQuery(“Select * From MSNdis_80211_Configuration”)\n<\/PRE>\n
For each wireless adapter we grab the value of the InstanceName<\/B> property, store it in a variable named strName, then use this block of code to retrieve information about the actual (physical) network adapters that have that name:<\/P>
Set objWMIService2 = GetObject(“winmgmts:\\\\” & strComputer & “\\root\\cimv2”)<\/p>\n
Set colAdapters = objWMIService2.ExecQuery _\n    (“Select * from Win32_NetworkAdapter Where Name = ‘” & strName & “‘”)\n<\/PRE>\n
We\u2019ll let you try the script on your own to see what happens from there.<\/P>\n
Uh-oh: it looks like our water taxi is here. We\u2019ll see everyone tomorrow, when the Scripting Guy who writes this column returns to work. Is he excited about once again seeing all his colleagues from Microsoft? Let\u2019s put it this way: he\u2019s as excited about seeing them as they are about seeing him.<\/P><\/p>\n","protected":false},"excerpt":{"rendered":"
Hey, Scripting Guy! How can I tell if a specific wireless network adapter is connected to the network?— MS Hey, MS. You know, this is a sad day for the Scripting Guy who writes this column. After 10 days of eating Italian pastries, visiting the ruins of ancient cities, and flitting about Venice on water […]<\/p>\n","protected":false},"author":595,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[34,332,3,5],"class_list":["post-64193","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-hardware","tag-network-adapters","tag-scripting-guy","tag-vbscript"],"acf":[],"blog_post_summary":"
Hey, Scripting Guy! How can I tell if a specific wireless network adapter is connected to the network?— MS Hey, MS. You know, this is a sad day for the Scripting Guy who writes this column. After 10 days of eating Italian pastries, visiting the ruins of ancient cities, and flitting about Venice on water […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/64193","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\/595"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=64193"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/64193\/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=64193"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=64193"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=64193"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}