windows_feature

Use the windows_feature InSpec audit resource to test features on Windows via the Get-WindowsFeature cmdlet.


Syntax

A windows_feature resource block declares the name of the Windows feature, tests if that feature is installed, and then returns information about that feature:

describe windows_feature('feature_name') do
  it { should be_installed }
end

where

  • ('feature_name') must specify a Windows feature name, such as DHCP Server or IIS-Webserver
  • be_installed is a valid matcher for this resource


Examples

The following examples show how to use this InSpec audit resource.

Test the DHCP Server feature

describe windows_feature('DHCP Server') do
  it{ should be_installed }
end


Matchers

For a full list of available matchers, please visit our matchers page.

be_installed

The be_installed matcher tests if the named Windows feature is installed:

it { should be_installed }