This topic has not yet been rated - Rate this topic

Remove-WindowsFeature

Remove-WindowsFeature


The Remove-WindowsFeature cmdlet allows you to remove specified roles,
role services, and features from a computer that is running Windows
Server 2008 R2.

Syntax

Remove-WindowsFeature [-Name] <string[]> [-logPath <string>] [-WhatIf] [-Restart] [-Concurrent] [<CommonParameters>]

Detailed Description


The Remove-WindowsFeature cmdlet allows you to remove specified roles,
role services, and features from a computer that is running Windows
Server 2008 R2. The Remove-WindowsFeature cmdlet functions similarly
to the Remove Roles Wizard and Remove Features Wizard that you can start
from the Server Manager UI. As in those wizards, you can remove more than
one role, role service, or feature per session.

You can find a list of command IDs for all roles, role services, and
features in the topic "Overview of Server Manager Commands" in the Server
Manager Help.

Parameters

-Name


Specifies the command IDs of roles, role services, or features you
want to remove by using the Remove-WindowsFeature cmdlet.
Alternatively, an array of Feature objects will also be accepted.

You can find a list of command IDs for all roles, role services, and
features in the topic "Overview of Server Manager Commands" in the
Server Manager Help.

Attributes

Name Value

Required?

true

Accept wildcard characters?

false

Accept Pipeline Input?

true (ByValue)

Position?

1

-logPath


Specifies a name and location for the log file, other than the default,
%windir%\logs\ServerManager.log.

Attributes

Name Value

Required?

false

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-WhatIf


Displays any operations that are specified for the
Remove-WindowsFeature cmdlet; displays the names of all roles, role
services, or features that are removed.

Attributes

Name Value

Required?

false

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-Restart


Restarts the computer automatically when removal is complete, if
restarting is required by the roles or features that were removed.

Attributes

Name Value

Required?

false

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-Concurrent


Allows concurrent instances of the Server Manager Add-WindowsFeature
or Remove-WindowsFeature cmdlets to be running at the same time.

Attributes

Name Value

Required?

false

Accept wildcard characters?

false

Accept Pipeline Input?

false

Position?

named

-CommonParameter

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see About Common Parameter

Input and Return Types

The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet emits.

Input Type

string[]. Array of strings.

Return Type

Microsoft.Windows.ServerManager.Commands.FeatureOperationResult. FeatureOperationResult object

Notes

The -Confirm parameter is not used by this cmdlet, because multiple roles, role services, or features can be removed in a single session.



Examples

Example 1

Remove-WindowsFeature Telnet-Server,Telnet-Client

Remove both Telnet Server and Telnet Client.

Example 2

Get-WindowsFeature Web-* | Remove-WindowsFeature

Remove all Web features and any other Windows feature(s) that depend on
them.

See Also

Reference

Get-WindowsFeature

Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.