{"id":7031,"date":"2015-03-27T00:01:00","date_gmt":"2015-03-27T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2015\/03\/27\/use-powershell-to-remove-optional-features-from-windows-vhd\/"},"modified":"2019-02-18T10:30:07","modified_gmt":"2019-02-18T17:30:07","slug":"use-powershell-to-remove-optional-features-from-windows-vhd","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/use-powershell-to-remove-optional-features-from-windows-vhd\/","title":{"rendered":"Use PowerShell to Remove Optional Features from Windows VHD"},"content":{"rendered":"

Summary<\/b>: Microsoft Scripting Guy, Ed Wilson, talks about using Windows PowerShell to remove optional features from Windows virtual hard disks.<\/span><\/p>\n

\"Hey, Hey, Scripting Guy! I have a number of virtual machines that have optional features that they do not need, such as Windows Media Player. In fact, the virtual machines are set up with no audio, so having Windows Media Player is sort of a waste. How can I easily remove this feature?<\/p>\n

—CG<\/p>\n

\"Hey, Hello CG,<\/p>\n

Microsoft Scripting Guy, Ed Wilson, is here. This morning started off early. IIS MVP, Teri Donahue<\/a>, stopped by to pick up Teresa’s Surface Pro 2. Teri and Teresa are meeting at an MVP conference in Philly. I had to get a new SIM card for the Surface because the dial-up adapter quit working, and Teri is taking it to Teresa, who is pretty much going through withdraw without her device.<\/p>\n

Not that she is completely deviceless, she had my Surface Pro 2 and her original Surface RT with her, not to mention her Windows Phone, but still she was jonesing without her favorite device. Thanks Teri! Anyway, I took the early morning wake up to head to the gym to get my workout over so I could get back to work answering email sent to scripter@microsoft.com<\/a>.<\/p>\n

CG, speaking of withdrawl…<\/p>\n

It is actually pretty easy to use Windows PowerShell to remove unneeded features from your VHDs. (This technique also works for WIM images.)<\/p>\n

One of the cool things about using the DISM cmdlets is that it permits me to work with optional features in a supportable and reliable method. In the old days, I had to worry about dependencies and hope that I did not break things when I used tools that were designed to shrink Windows images, but that is no longer the case.<\/p>\n

The first thing I do is mount an image that I want to work with to a folder. Here is the code I use:<\/p>\n

$image = "E:\\vms\\vhd\\c1\\c1.vhdx"<\/p>\n

$path = "c:\\image"<\/p>\n

 MD $path<\/p>\n

 Mount-WindowsImage -ImagePath $image -Path $path -Index 1<\/p>\n

After I have my virtual machine mounted to a folder, I use the Get-WindowsOptionalFeature<\/b> to look at the optional features:<\/p>\n

Get-WindowsOptionalFeature -Path $path<\/p>\n

The following image shows the output from this command:<\/p>\n

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

To find related features, use wildcard characters. The following command illustrates finding media-related features:<\/span><\/p>\n

PS C:\\> Get-WindowsOptionalFeature -Path C:\\image -FeatureName *media*<\/p>\n

Feature Name      : MediaPlayback<\/p>\n

Display Name      : Media Features<\/p>\n

Description       : Controls media features such as Windows Media Player and Windows Media Center.<\/span><\/p>\n

Restart Required  : Possible<\/p>\n

State             : Enabled<\/p>\n

Custom Properties :<\/p>\n

                    \\SoftBlockLink : http:\/\/go.microsoft.com\/fwlink?LinkID=153156        <\/span><\/p>\n

Feature Name      : WindowsMediaPlayer<\/p>\n

Display Name      : Windows Media Player<\/p>\n

Description       : Windows Media Player<\/p>\n

Restart Required  : Possible<\/p>\n

State             : Enabled<\/p>\n

Custom Properties :<\/p>\n

                    \\SoftBlockLink : http:\/\/go.microsoft.com\/fwlink?LinkID=140092<\/p>\n

To remove an optional Windows feature, I pipe the results of the Get-WindowsOptionalFeature<\/b> cmdlet to the Disable-WindowsOptionalFeature<\/b> cmdlet. I also use the –Remove<\/b> switch to actually remove the feature and not simply disable the feature. This command is shown here (this is a single-line command that wraps at the pipe character for readability):<\/p>\n

Get-WindowsOptionalFeature -Path C:\\image -FeatureName *media* |<\/p>\n

Disable-WindowsOptionalFeature -Remove<\/p>\n

Now, I put everything together into a script:<\/p>\n

Push-Location<\/p>\n

Set-Location c:\\<\/p>\n

WorkFlow Service-Image<\/p>\n

{<\/p>\n

 $image = "E:\\vms\\vhd\\c1\\c1.vhdx"<\/p>\n

 $path = "c:\\image"<\/p>\n

 MD $path<\/p>\n

  Sequence {<\/p>\n

   Mount-WindowsImage -ImagePath $image -Path $path -Index 1<\/p>\n

   Get-WindowsOptionalFeature -Path C:\\image -FeatureName *media* |<\/p>\n

   Disable-WindowsOptionalFeature -Remove<\/p>\n

   Dismount-WindowsImage -Path $path -Save<\/p>\n

   RD $path -Force<\/p>\n

 } }<\/p>\n

Service-Image<\/p>\n

Pop-Location<\/p>\n

When I run the script, the following output appears:<\/p>\n

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

CG, that is all there is to using Windows PowerShell to remove optional features from virtual machines. Join me tomorrow when I will have a guest blog post by Windows PowerShell MVP, Teresa Wilson. She will talk about plans for the Scripting Guys Ignite booth.<\/span><\/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> <\/span><\/p>\n","protected":false},"excerpt":{"rendered":"

Summary: Microsoft Scripting Guy, Ed Wilson, talks about using Windows PowerShell to remove optional features from Windows virtual hard disks.  Hey, Scripting Guy! I have a number of virtual machines that have optional features that they do not need, such as Windows Media Player. In fact, the virtual machines are set up with no audio, […]<\/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":[51,3,4,45],"class_list":["post-7031","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-getting-started","tag-scripting-guy","tag-scripting-techniques","tag-windows-powershell"],"acf":[],"blog_post_summary":"

Summary: Microsoft Scripting Guy, Ed Wilson, talks about using Windows PowerShell to remove optional features from Windows virtual hard disks.  Hey, Scripting Guy! I have a number of virtual machines that have optional features that they do not need, such as Windows Media Player. In fact, the virtual machines are set up with no audio, […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/7031","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=7031"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/7031\/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=7031"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=7031"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=7031"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}