{"id":5023,"date":"2012-09-05T00:01:00","date_gmt":"2012-09-05T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2012\/09\/05\/use-powershell-3-0-to-stop-network-adapters-on-windows-8\/"},"modified":"2012-09-05T00:01:00","modified_gmt":"2012-09-05T00:01:00","slug":"use-powershell-3-0-to-stop-network-adapters-on-windows-8","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/use-powershell-3-0-to-stop-network-adapters-on-windows-8\/","title":{"rendered":"Use PowerShell 3.0 to Stop Network Adapters on Windows 8"},"content":{"rendered":"

Summary<\/b>: Microsoft Scripting Guy, Ed Wilson, shows how to use Windows PowerShell 3.0 to stop network adapters on Windows 8.<\/p>\n

Microsoft Scripting Guy, Ed Wilson, is here. The other day a customer asked me, “Is it a Microsoft requirement that all their consultants can’t be more than five miles from a coffee house?” Perhaps a little bit of background is in order. I was onsite with a large Microsoft premier customer, delivering a Windows PowerShell class. Their TAM, Robert, is one of my good friends at Microsoft, and I have worked with him for over a decade. Because I miss my teapot and my stash of teas, I developed the habit of stopping by the coffee house after lunch and getting a large cup of green tea—they actually have a pretty nice green tea with spearmint and lemon grass in it. They had no monkey-picked and no jasmine; but after all, it is a coffee house and not a tearoom. I was happy with what I could obtain. I looked around, and all of the Microsoft people (there were other consultants working on various projects as well) had similar looking large cups of coffee. And thus the question. Although both Microsoft and this particular coffee house chain are based in Seattle, as far as I know, there is no other relationship—and most certainly, there is no proximity-based requirement.<\/p>\n

Stopping network adapters<\/h2>\n

Windows Vista introduced the ability to stop a network adapter by using the Win32_NetworkAdapter WMI class. In the following example, I use the Get-CimClass<\/b> cmdlet from Windows PowerShell 3.0 to return cimclassmethods<\/b> from the Win32_NetworkAdapter WMI class. I use the dotted notation and automatic foreach<\/b> technique to pipe the resulting class methods to Where-Object<\/b> (?<\/b> is the alias), where I use the simplified Where-Object<\/b> syntax from Windows PowerShell 3.0 to find only the implemented cimclassmethods<\/b>. (For more information about these types of Windows PowerShell 3.0 syntax tricks, see My Five Favorite PowerShell 3.0 Tips and Tricks<\/a>.) <\/i>The Win32_NetworkAdapter class methods are shown here.<\/p>\n

PS C:\\> (Get-CimClass win32_networkadapter).cimclassmethods | ? qualifiers -match implemented<\/p>\n

 <\/p>\n

Name                            ReturnType Parameters           Qualifiers<\/p>\n

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

Enable                              UInt32 {}                   {Implemented, Map…<\/p>\n

Disable                             UInt32 {}                   {Implemented, Map…<\/p>\n

In Windows 8 and Windows Server 2012, I can use Windows PowerShell 3.0 to stop or to start a network adapter by using one of the CIM commands. Of course, the function wraps the WMI class, but it also makes things really easy. The netadapter<\/b> <\/i>functions are shown here (gcm<\/b> is an alias for the Get-Command<\/b> cmdlet.)<\/p>\n

PS C:\\> gcm -Noun netadapter | select name, modulename<\/p>\n

 <\/p>\n

Name                                       ModuleName<\/p>\n

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

Disable-NetAdapter                         NetAdapter<\/p>\n

Enable-NetAdapter                          NetAdapter<\/p>\n

Get-NetAdapter                             NetAdapter<\/p>\n

Rename-NetAdapter                          NetAdapter<\/p>\n

Restart-NetAdapter                         NetAdapter<\/p>\n

Set-NetAdapter                             NetAdapter<\/p>\n

Note   <\/b>To enable or disable network adapters requires admin rights. Therefore, you must start the Windows PowerShell console with an account that has rights to perform the task.<\/p>\n

The various network adapters on my laptop are shown in the image that follows.<\/p>\n

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

I do not like having enabled, disconnected network adapters. Instead, I prefer to only enable the network adapter that I am using. (There are a number of reasons for this, such as simplified routing tables, performance issues, and security concerns.) In the past, I wrote a script. Now I only need to use a Windows PowerShell command. If I only want to disable the non-connected network adapters, the command is easy. It is shown here.<\/p>\n

Get-NetAdapter | ? status -ne up | Disable-NetAdapter<\/p>\n

The problem with the previous command is that it prompts as shown in the following image. This is not much fun when there are multiple network adapters to disable.<\/p>\n

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

To suppress the prompt, I need to supply $false<\/b> to the –confirm<\/b> parameter. This is shown here.<\/p>\n

Get-NetAdapter | ? status -ne up | Disable-NetAdapter -Confirm:$false<\/p>\n

A quick check in Control Panel shows the disconnected adapters are now disabled. This appears here.<\/p>\n

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

If I want to enable a specific network adapter, I use the Enable-Network<\/b> adapter. I can specify by name as shown here.<\/p>\n

Enable-NetAdapter -Name ethernet -Confirm:$false<\/p>\n

If I do not want to type the adapter name, I can use the Get-NetAdapter<\/b> cmdlet to retrieve a specific network adapter and then enable it as shown here.<\/p>\n

Get-NetAdapter -Name vethernet* | ? status -eq disabled | Enable-NetAdapter -Confirm:$false<\/p>\n

It is also possible to use wildcard characters with the Get-NetAdapter<\/b> to retrieve multiple adapters, and pipe them directly to the Disable-NetAdapter<\/b> cmdlet. The following code permits the confirmation prompts so that I can selectively enable or disable the adapter as I wish.<\/p>\n

PS C:\\> Get-NetAdapter -Name vethernet* | Disable-NetAdapter<\/p>\n

 <\/p>\n

Confirm<\/p>\n

Are you sure you want to perform this action?<\/p>\n

Disable-NetAdapter ‘vEthernet (InternalSwitch)’<\/p>\n

[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help<\/p>\n

(default is “Y”):y<\/p>\n

 <\/p>\n

Confirm<\/p>\n

Are you sure you want to perform this action?<\/p>\n

Disable-NetAdapter ‘vEthernet (ExternalSwitch)’<\/p>\n

[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help<\/p>\n

(default is “Y”):n<\/p>\n

That is about it for now. 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<\/b> <\/p>\n","protected":false},"excerpt":{"rendered":"

Summary: Microsoft Scripting Guy, Ed Wilson, shows how to use Windows PowerShell 3.0 to stop network adapters on Windows 8. Microsoft Scripting Guy, Ed Wilson, is here. The other day a customer asked me, “Is it a Microsoft requirement that all their consultants can’t be more than five miles from a coffee house?” Perhaps a little bit […]<\/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":[34,37,362,3,367,45],"class_list":["post-5023","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-hardware","tag-networking","tag-powershell-3","tag-scripting-guy","tag-windows-8","tag-windows-powershell"],"acf":[],"blog_post_summary":"

Summary: Microsoft Scripting Guy, Ed Wilson, shows how to use Windows PowerShell 3.0 to stop network adapters on Windows 8. Microsoft Scripting Guy, Ed Wilson, is here. The other day a customer asked me, “Is it a Microsoft requirement that all their consultants can’t be more than five miles from a coffee house?” Perhaps a little bit […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/5023","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=5023"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/5023\/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=5023"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=5023"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=5023"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}