<< Back to Script Library

Add or Remove Windows Features

Adds or Removes Windows Features from Server or Desktop operating systems.
Script in action
Version: 1.10.26
Created: 2020-10-05
Modified: 2020-10-20
Creator: Trentent Tye
Downloads: 27
Tags: features windows
The Script Copy Script Copied to clipboard
<#
    .SYNOPSIS
        Adds or removes Windows Features from Windows Server Operating Systems

    .DESCRIPTION
        Adds or removes Windows Features from Windows Server Operating Systems

    .EXAMPLE
        . .\Add-Or-RemoveWindowsFeatures.ps1 -Workstation False -ComputerName W2019-001 -Source \\DS1813.bottheory.local\fileshare\OS\W2K19\sources\sxs
        Opens a dialog prompting you to select features to add or remove.

    .PARAMETER  <Workstation <string>>
        True if this is a workstation OS or False if this is a Server operating system.

    .PARAMETER  <ComputerName <string>>
        The name of the computer to run this script against

    .PARAMETER  <Source <string>>
        Specify an optional 'source' path for adding new Windows Features. Not required for most features, but it is required when adding .NetFramework 3.5, for example.

    .CONTEXT
        Console

    .MODIFICATION_HISTORY
        Created TTYE : 2020-10-01


    AUTHOR: Trentent Tye
#>

[CmdLetBinding()]
Param (
    [Parameter(Mandatory=$true,HelpMessage='Is this a workstation operating system?')][ValidateNotNullOrEmpty()]              [string]$Workstation = "False",
    [Parameter(Mandatory=$true,HelpMessage='Name of the target machine to add or remove features')][ValidateNotNullOrEmpty()] [string]$ComputerName,
    [Parameter(Mandatory=$false,HelpMessage='Source path for Windows features')]                                              [string]$Source
)


$VerbosePreference = $(if( $PSBoundParameters[ 'verbose' ] ) { $VerbosePreference } else { 'SilentlyContinue' })
$DebugPreference = $(if( $PSBoundParameters[ 'debug' ] ) { $DebugPreference } else { 'SilentlyContinue' })
$ErrorActionPreference = $(if( $PSBoundParameters[ 'erroraction' ] ) { $ErrorActionPreference } else { 'Stop' })
$ProgressPreference = 'SilentlyContinue'
#Set-StrictMode -Version Latest


if (-not(Test-Path env:source)) {
    $source = $null
}

Write-Verbose  -Message "Parameters: Workstation = $workstation `n                     ComputerName = $computerName `n                     Source = $source"


function Display-ToastNotification ([string]$title, [string]$progressTitle, [string]$progressValue, [string]$progressStatus, [string]$progressValueStringOverride, [int]$sequenceID) {
    $app = '{1AC14E77-02E7-4E5D-B744-2EB1AE5198B7}\WindowsPowerShell\v1.0\powershell.exe'
    $null = [Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime] ##need these two nulls to preload the assemblies
    $null = [Windows.Data.Xml.Dom.XmlDocument, Windows.Data.Xml.Dom.XmlDocument, ContentType = WindowsRuntime]
    $Template = [Windows.UI.Notifications.ToastTemplateType]::ToastImageAndText01
    [xml]$ToastTemplate = @"
    <toast launch="app-defined-string" duration="long">
        <visual>
        <binding template="ToastGeneric">
            <text>{title}</text>
            <progress title="{progressTitle}" value="{progressValue}" status="{progressStatus}" valueStringOverride="{progressValueStringOverride}"/>
        </binding>
        </visual>
        <audio silent="true" />
        <actions>
        <action activationType="background" content="OK" arguments="later"/>
        </actions>
    </toast>
"@
    $ToastXml = New-Object -TypeName Windows.Data.Xml.Dom.XmlDocument
    $ToastXml.LoadXml($ToastTemplate.OuterXml)
    $toastNotification = [Windows.UI.Notifications.ToastNotification]::new($ToastXml)
    $toastNotification.Tag   = "ControlUp-SBA-AddRemovePrograms"
    $toastNotification.Group = "AppRemoveProgramsGroup"

    $DataDictionary = New-Object 'system.collections.generic.dictionary[string,string]'
    $DataDictionary.Add("title", "$title")
    $DataDictionary.Add("progressTitle", "$progressTitle")
    $DataDictionary.Add("progressValue", "$progressValue")
    $DataDictionary.Add("progressStatus", "$progressStatus")
    $DataDictionary.Add("progressValueStringOverride", "$progressValueStringOverride")

    $toastNotification.Data = [Windows.UI.Notifications.NotificationData]::new($DataDictionary, $sequenceID)
    $Global:notify = [Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier($app)
    $notify.Show($toastNotification)
}

function Update-ToastNotification ([string]$title, [string]$progressTitle, [string]$progressValue, [string]$progressStatus, [string]$progressValueStringOverride, [int]$sequenceID) {
    $app = '{1AC14E77-02E7-4E5D-B744-2EB1AE5198B7}\WindowsPowerShell\v1.0\powershell.exe'
    $null = [Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime] ##need these two nulls to preload the assemblies
    $null = [Windows.Data.Xml.Dom.XmlDocument, Windows.Data.Xml.Dom.XmlDocument, ContentType = WindowsRuntime]
    $Template = [Windows.UI.Notifications.ToastTemplateType]::ToastImageAndText01
    [xml]$ToastTemplate = @"
    <toast launch="app-defined-string" duration="long">
        <visual>
        <binding template="ToastGeneric">
            <text>{title}</text>
            <progress title="{progressTitle}" value="{progressValue}" status="{progressStatus}" valueStringOverride="{progressValueStringOverride}"/>
        </binding>
        </visual>
        <audio silent="true" />
        <actions>
        <action activationType="background" content="OK" arguments="later"/>
        </actions>
    </toast>
"@
    $ToastXml = New-Object -TypeName Windows.Data.Xml.Dom.XmlDocument
    $ToastXml.LoadXml($ToastTemplate.OuterXml)
    $toastNotification = [Windows.UI.Notifications.ToastNotification]::new($ToastXml)
    $toastNotification.Tag   = "ControlUp-SBA-AddRemovePrograms"
    $toastNotification.Group = "AppRemoveProgramsGroup"
 
    $DataDictionary = New-Object 'system.collections.generic.dictionary[string,string]'
    $DataDictionary.Add("title", "$title")
    $DataDictionary.Add("progressTitle", "$progressTitle")
    $DataDictionary.Add("progressValue", "$progressValue")
    $DataDictionary.Add("progressStatus", "$progressStatus")
    $DataDictionary.Add("progressValueStringOverride", "$progressValueStringOverride")

    $ToastData = [Windows.UI.Notifications.NotificationData]::new($DataDictionary, $sequenceID)
    $null = [Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier($app).Update($ToastData, $toastNotification.Tag,$toastNotification.Group)
}



#Check if it's is a workstation OS and error/exit if true
if ($Workstation -eq "True") {
    Write-Verbose -Message "Desktop operating system detected."
    $features = Invoke-Command -ComputerName $ComputerName -ScriptBlock { Get-WindowsOptionalFeature -Online } | Sort-Object -Property FeatureName
    $selections = $features | Select-Object -Property "FeatureName","State" | Out-GridView -Title "$ComputerName : Add or Remove Windows Features" -PassThru
} else {
    Write-Verbose -Message "Server operating system detected."
    $features = Get-WindowsFeature -ComputerName $ComputerName

    #going to create a custom object so features will sort correctly in out-gridview
    $FeaturesObj = New-Object System.Collections.Generic.List[PSObject]
    $count = 0
    foreach ($feature in $features) {
        $count++

        switch ($feature.Depth) {
            1  { $spaces = "" }
            2  { $spaces = "    " }
            3  { $spaces = "        " }
            4  { $spaces = "            " }
            5  { $spaces = "                " }
        }

        if ($feature.Installed -eq $true) {
            $displayName = "$spaces[X] $($feature.DisplayName)"
        } else {
            $displayName = "$spaces[ ] $($feature.DisplayName)"
        }

        $FeaturesObj.Add(
            [PSCustomObject]@{
                Item = $count
                DisplayName = $displayName
                OriginalName = $feature.DisplayName
                Name = $feature.Name
                InstallState = $feature.InstallState
            }
        )
    }
    $featureGrid = $FeaturesObj | Select-Object -Property Item,DisplayName,Name,InstallState | Out-GridView -Title "$ComputerName : Add or Remove Windows Features" -PassThru
    $selections = New-Object System.Collections.Generic.List[PSObject]
    foreach ($featureSelection in $featureGrid) {
        $selections.Add( $FeaturesObj.Where{$_.Item -eq $featureSelection.Item} )
    }
}

Write-Verbose "$($selections | Format-Table -AutoSize | Out-String)"


$Results = New-Object System.Collections.Generic.List[PSObject]
$Count = 0
$SelectionsCount = ($selections | Measure-Object).Count
$NotificationDisplayed = $false

If ($SelectionsCount -eq 0) {
    Display-ToastNotification -title "ControlUp SBA : Add/Remove Features" -progressTitle "No Features Selected" -progressValue "0.0" -progressStatus "" -progressValueStringOverride "" -sequenceID 0
    Exit 0
}

if ($Workstation -eq "False") {
    ## Server OS Feature Results Object
    foreach ($selection in $selections) {
        Write-Verbose "Feature: $($selection.name)"
        $Count++
        switch -Wildcard ($selection.InstallState) {
            {($_ -eq "Available") -or ($_ -eq "Removed")}{
                if ([string]::IsNullOrEmpty($source)) {
                    if (-not($NotificationDisplayed)) {
                        Display-ToastNotification -title "ControlUp SBA : Add/Remove Features" -progressTitle "$computerName-$($selection.OriginalName)" -progressValue "$([math]::Round($($count/$SelectionsCount),1))" -progressStatus "$($selection.name)" -progressValueStringOverride "$count/$SelectionsCount" -sequenceID 0
                        $NotificationDisplayed = $true
                    } else {
                        Update-ToastNotification -title "ControlUp SBA : Add/Remove Features" -progressTitle "$computerName-$($selection.OriginalName)" -progressValue "$([math]::Round($($count/$SelectionsCount),1))" -progressStatus "$($selection.name)" -progressValueStringOverride "$count/$SelectionsCount" -sequenceID $count
                    }
                    $Result = Add-WindowsFeature -Name $selection.name -ComputerName $ComputerName -ErrorAction SilentlyContinue -ErrorVariable errmsg
                    if ($Result.FeatureResult.Length -eq 0) {
                        $Success = ""
                    } else {
                        $Success = $result.FeatureResult.success
                    }
                    if ($errmsg -ne $null) {
                        Write-Verbose -Message "Error found for $($selection.Name)"
                        $Results.Add(
                            [PSCustomObject]@{
                                DisplayName = $selection.OriginalName
                                FeatureName = $selection.Name
                                RestartNeeded = $Result.RestartNeeded
                                State = $result.exitcode
                                Success = $Success
                            }
                        )
                    } else {
                        Write-Verbose -Message "Adding Result: $($selection.Name) - $($Result.RestartNeeded) - Enabled"
                        $Results.Add(
                            [PSCustomObject]@{
                                DisplayName = $selection.OriginalName
                                FeatureName = $selection.Name
                                RestartNeeded = $Result.RestartNeeded
                                State = $result.exitcode
                                Success = $Success
                            }
                        )
                    }
                } else {
                    if (-not($NotificationDisplayed)) {
                        Display-ToastNotification -title "ControlUp SBA : Add/Remove Features" -progressTitle "$computerName-$($selection.OriginalName)" -progressValue "$([math]::Round($($count/$SelectionsCount),1))" -progressStatus "$($selection.name)" -progressValueStringOverride "$count/$SelectionsCount" -sequenceID 0
                        $NotificationDisplayed = $true
                    } else {
                        Update-ToastNotification -title "ControlUp SBA : Add/Remove Features" -progressTitle "$computerName-$($selection.OriginalName)" -progressValue "$([math]::Round($($count/$SelectionsCount),1))" -progressStatus "$($selection.name)" -progressValueStringOverride "$count/$SelectionsCount" -sequenceID $count
                    }
                    $Result = Add-WindowsFeature -Name $selection.name -Source $Source -ComputerName $ComputerName -ErrorAction SilentlyContinue -ErrorVariable errmsg
                    if ($Result.FeatureResult.Length -eq 0) {
                        $Success = ""
                    } else {
                        $Success = $result.FeatureResult.success
                    }
                    $Results.Add(
                        [PSCustomObject]@{
                            DisplayName = $selection.OriginalName
                            FeatureName = $selection.Name
                            RestartNeeded = $Result.RestartNeeded
                            State = $result.exitcode
                            Success = $Success
                        }
                    )
                }
            }
            "Installed" {
                if (-not($NotificationDisplayed)) {
                    Display-ToastNotification -title "ControlUp SBA : Add/Remove Features" -progressTitle "$computerName-$($selection.OriginalName)" -progressValue "$([math]::Round($($count/$SelectionsCount),1))" -progressStatus "$($selection.name)" -progressValueStringOverride "$count/$SelectionsCount" -sequenceID 0
                    $NotificationDisplayed = $true
                } else {
                    Update-ToastNotification -title "ControlUp SBA : Add/Remove Features" -progressTitle "$computerName-$($selection.OriginalName)" -progressValue "$([math]::Round($($count/$SelectionsCount),1))" -progressStatus "$($selection.name)" -progressValueStringOverride "$count/$SelectionsCount" -sequenceID $count
                }
                $Result = Remove-WindowsFeature -Name $selection.name -ComputerName $ComputerName -Remove -ErrorAction SilentlyContinue -ErrorVariable errmsg
                Write-Verbose "$($result.FeatureResult)"
                if ($Result.FeatureResult.Length -eq 0) {
                    $Success = ""
                } else {
                    $Success = $result.FeatureResult.success
                }
                $Results.Add(
                    [PSCustomObject]@{
                        DisplayName = $selection.OriginalName
                        FeatureName = $selection.Name
                        RestartNeeded = $Result.RestartNeeded
                        State = $result.exitcode
                        Success = $Success
                    }
                )
            }
            "*Pending" {
                if (-not($NotificationDisplayed)) {
                    Display-ToastNotification -title "ControlUp SBA : Add/Remove Features" -progressTitle "$computerName-$($selection.OriginalName)" -progressValue "$([math]::Round($($count/$SelectionsCount),1))" -progressStatus "$($selection.name)" -progressValueStringOverride "$count/$SelectionsCount" -sequenceID 0
                    $NotificationDisplayed = $true
                } else {
                    Update-ToastNotification -title "ControlUp SBA : Add/Remove Features" -progressTitle "$computerName-$($selection.OriginalName)" -progressValue "$([math]::Round($($count/$SelectionsCount),1))" -progressStatus "$($selection.name)" -progressValueStringOverride "$count/$SelectionsCount" -sequenceID $Count
                }
                $Results.Add(
                    [PSCustomObject]@{
                        DisplayName = $selection.OriginalName
                        FeatureName = $selection.Name
                        RestartNeeded = "Yes"
                        State = $selection.InstallState
                        Success = ""
                    }
                )
            }
        }
    }
} else {
    ## Client OS Feature Results Object
    foreach ($selection in $selections) {
    Write-Verbose "Feature: $($selection.FeatureName)"
    $count++
        switch -Wildcard ($selection.State) {
            "Disabled" {
                if ([string]::IsNullOrEmpty($source)) {
                    if (-not($NotificationDisplayed)) {
                        Display-ToastNotification -title "ControlUp SBA : Add/Remove Features" -progressTitle "$computerName" -progressValue "$([math]::Round($($count/$SelectionsCount),1))" -progressStatus "$($selection.FeatureName)" -progressValueStringOverride "$count/$SelectionsCount" -sequenceID 0
                        $NotificationDisplayed = $true
                    } else {
                        Update-ToastNotification -title "ControlUp SBA : Add/Remove Features" -progressTitle "$computerName" -progressValue "$([math]::Round($($count/$SelectionsCount),1))" -progressStatus "$($selection.FeatureName)" -progressValueStringOverride "$count/$SelectionsCount" -sequenceID 0
                    }
                    $Result = Invoke-Command -ComputerName $ComputerName -ScriptBlock { Enable-WindowsOptionalFeature -Online -FeatureName $args[0] -NoRestart } -ArgumentList "$($selection.FeatureName)" -ErrorAction SilentlyContinue -ErrorVariable errmsg 2>$null
                    if ($errmsg -ne $null) {
                        Write-Verbose -Message "Error found for $($selection.FeatureName)"
                        $Results.Add(
                            [PSCustomObject]@{
                                FeatureName = $selection.FeatureName
                                RestartNeeded = ""
                                State = "$errmsg"
                            }
                        )
                    } else {
                        Write-Verbose -Message "Adding Result: $($selection.FeatureName) - $($Result.RestartNeeded) - Enabled"
                        $Results.Add(
                            [PSCustomObject]@{
                                FeatureName = $selection.FeatureName
                                RestartNeeded = $Result.RestartNeeded
                                State = "Enabled"
                            }
                        )
                    }
                } else {
                    if (-not($NotificationDisplayed)) {
                        Display-ToastNotification -title "ControlUp SBA : Add/Remove Features" -progressTitle "$computerName" -progressValue "$([math]::Round($($count/$SelectionsCount),1))" -progressStatus "$($selection.FeatureName)" -progressValueStringOverride "$count/$SelectionsCount" -sequenceID 0
                        $NotificationDisplayed = $true
                    } else {
                        Update-ToastNotification -title "ControlUp SBA : Add/Remove Features" -progressTitle "$computerName" -progressValue "$([math]::Round($($count/$SelectionsCount),1))" -progressStatus "$($selection.FeatureName)" -progressValueStringOverride "$count/$SelectionsCount" -sequenceID 0
                    }
                    $Result = Invoke-Command -ComputerName $ComputerName -ScriptBlock { Enable-WindowsOptionalFeature -Online -FeatureName $args[0] -Source $args[1] -NoRestart } -ArgumentList @("$($selection.FeatureName)","$Source") -ErrorAction SilentlyContinue -ErrorVariable errmsg 2>$null
                    if ($errmsg -ne $null) {
                        Write-Verbose -Message "Error found for $($selection.FeatureName)"
                        $Results.Add(
                            [PSCustomObject]@{
                                FeatureName = $selection.FeatureName
                                RestartNeeded = ""
                                State = "$errmsg"
                            }
                        )
                    } else {
                        $Results.Add(
                            [PSCustomObject]@{
                                FeatureName = $selection.FeatureName
                                RestartNeeded = $Result.RestartNeeded
                                State = "Enabled"
                            }
                        )
                    }
                }
            }
            "Enabled" {
                if (-not($NotificationDisplayed)) {
                        Display-ToastNotification -title "ControlUp SBA : Add/Remove Features" -progressTitle "$computerName" -progressValue "$([math]::Round($($count/$SelectionsCount),1))" -progressStatus "$($selection.FeatureName)" -progressValueStringOverride "$count/$SelectionsCount" -sequenceID 0
                        $NotificationDisplayed = $true
                    } else {
                        Update-ToastNotification -title "ControlUp SBA : Add/Remove Features" -progressTitle "$computerName" -progressValue "$([math]::Round($($count/$SelectionsCount),1))" -progressStatus "$($selection.FeatureName)" -progressValueStringOverride "$count/$SelectionsCount" -sequenceID 0
                    }
                $Result = Invoke-Command -ComputerName $ComputerName -ScriptBlock { Disable-WindowsOptionalFeature -Online -FeatureName $args[0] -Remove -NoRestart } -ArgumentList @("$($selection.FeatureName)") -ErrorAction SilentlyContinue -ErrorVariable errmsg 2>$null
                
                if ($errmsg -ne $null) {
                    Write-Verbose -Message "Error found for $($selection.FeatureName)"
                    $Results.Add(
                        [PSCustomObject]@{
                            FeatureName = $selection.FeatureName
                            RestartNeeded = ""
                            State = "$errmsg"
                        }
                    )
                } else {
                    $Results.Add(
                        [PSCustomObject]@{
                            FeatureName = $selection.FeatureName
                            RestartNeeded = $Result.RestartNeeded
                            State = "Disabled"
                        }
                    )
                }
            }
            "*Pending" {
                if (-not($NotificationDisplayed)) {
                    Display-ToastNotification -title "ControlUp SBA : Add/Remove Features" -progressTitle "$computerName" -progressValue "$([math]::Round($($count/$SelectionsCount),1))" -progressStatus "$($selection.FeatureName)" -progressValueStringOverride "$count/$SelectionsCount" -sequenceID 0
                    $NotificationDisplayed = $true
                } else {
                    Update-ToastNotification -title "ControlUp SBA : Add/Remove Features" -progressTitle "$computerName" -progressValue "$([math]::Round($($count/$SelectionsCount),1))" -progressStatus "$($selection.FeatureName)" -progressValueStringOverride "$count/$SelectionsCount" -sequenceID 0
                }
               
                $Results.Add(
                    [PSCustomObject]@{
                        FeatureName = $selection.FeatureName
                        RestartNeeded = ""
                        State = $Selection.state
                    }
                )
            }
        }
    }
}

$Results | Out-GridView -Title "$ComputerName : Add or Remove Windows Features Results" -Wait