Skip to content

Windows Feature Module

Matthew Kelly edited this page Jul 26, 2016 · 2 revisions

The Windows feature module will install, or uninstall, Windows features such as IIS or ASP.NET 3.5. You can also specify to install all of the features sub-modules or management tools.

Properties

Key Type Description Values
ensure string Specifies the type of operation this module will do install, uninstall
includeSubFeatures boolean [Optional] Tells the module to also install all sub-modules of the feature [Default] false
includeManagementTools boolean [Optional] Tells the module to also (un)install all management tools of the feature [Default] false
names string array List of Windows features to manage -

Paint

The following is an example of using the Windows feature type in a paint section:

{
    "paint": [
        {
            "type": "windows-feature",
            "ensure": "install",
            "includeSubFeatures": false,
            "includeManagementTools": true,
            "names": [
                "Web-Server"
            ]
        }
    ]
}

The above will attempt to install Web-Server (IIS), and all of it's management tools, onto the current machine. None of the sub-modules will be installed.

Erase

The following is an example of using the Windows feature type in a erase section:

{
    "erase": [
        {
            "type": "windows-feature",
            "ensure": "uninstall",
            "includeManagementTools": true,
            "names": [
                "Web-Server"
            ]
        }
    ]
}

The above will attempt to uninstall Web-Server (IIS), and all of it's management tools, from the current machine.