Add-WindowsFeature
Applies To: Windows Server 2008 R2, Windows Storage Server 2008 R2
Add-WindowsFeature
The Add-WindowsFeature cmdlet allows you to install specified roles, role services, and features on a computer that is running Windows Server 2008 R2.
Note
The Add-WindowsFeature cmdlet has been replaced, starting with Windows Server 2012, by the Install-WindowsFeature cmdlet. For more information about Install-WindowsFeature in Windows Server 2012, see Install-WindowsFeature. For more information about Install-WindowsFeature in Windows Server 2012 R2, see Install-WindowsFeature.
Syntax
Add-WindowsFeature [-Name] <string[]> [-IncludeAllSubFeature] [-logPath <string>] [-WhatIf] [-Restart] [-Concurrent] [<CommonParameters>]
Name
IncludeAllSubFeature
logPath
WhatIf
Restart
Concurrent
Detailed Description
The Add-WindowsFeature cmdlet allows you to install specified roles, role services, and features on a computer that is running Windows Server 2008 R2. The Add-WindowsFeature cmdlet functions similarly to the Add Roles Wizard and Add Features Wizard that you can start from the Server Manager UI. As in those wizards, you can add more than one role, role service, or feature per session, and all roles, role services, or features that are required by those Windows features you want to install are added automatically. 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 install by using the Add-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.
Default Value:
Data Type:
Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
true |
required |
Variable Length? |
variableLength |
|
Accept wildcard characters? |
false |
globbing |
Accept Pipeline Input? |
true (ByValue) |
pipelineInput |
Position? |
1 |
position |
Value Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
true |
required |
Variable Length? |
variableLength |
IncludeAllSubFeature
Specifies the installation of all subordinate services and features along with the parent role, role service, or feature named in the Name parameter.
Default Value:
Data Type:
Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
false |
required |
Variable Length? |
variableLength |
|
Accept wildcard characters? |
false |
globbing |
Accept Pipeline Input? |
false |
pipelineInput |
Position? |
named |
position |
Value Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
required |
|
Variable Length? |
variableLength |
logPath
Specifies a name and location for the log file, other than the default, %windir%\logs\ServerManager.log.
Default Value:
Data Type:
Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
false |
required |
Variable Length? |
variableLength |
|
Accept wildcard characters? |
false |
globbing |
Accept Pipeline Input? |
false |
pipelineInput |
Position? |
named |
position |
Value Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
true |
required |
Variable Length? |
variableLength |
WhatIf
Displays any operations that are specified for the Add-WindowsFeature cmdlet; for example, displays the Windows features that are also installed because the role, role service, or feature you want to install is dependent upon them.
Default Value:
Data Type:
Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
false |
required |
Variable Length? |
variableLength |
|
Accept wildcard characters? |
false |
globbing |
Accept Pipeline Input? |
false |
pipelineInput |
Position? |
named |
position |
Value Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
required |
|
Variable Length? |
variableLength |
Restart
Restarts the computer automatically when installation is complete, if restarting is required by the roles or features installed.
Default Value:
Data Type:
Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
false |
required |
Variable Length? |
variableLength |
|
Accept wildcard characters? |
false |
globbing |
Accept Pipeline Input? |
false |
pipelineInput |
Position? |
named |
position |
Value Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
required |
|
Variable Length? |
variableLength |
Concurrent
Allows concurrent instances of the Server Manager Add-WindowsFeature or Remove-WindowsFeature cmdlets to be running at the same time. Do not add this parameter unless you are installing roles, role services, or features that are downloaded separately from Windows Server 2008 R2, and you want to install Windows features on which the downloaded technology depends at the same time. The use of this switch is not recommended. This switch is intended for out-of-band feature(s) to install their dependencies.
Default Value:
Data Type:
Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
false |
required |
Variable Length? |
variableLength |
|
Accept wildcard characters? |
false |
globbing |
Accept Pipeline Input? |
false |
pipelineInput |
Position? |
named |
position |
Value Attributes
| Name | Value | PSMAML Attribute |
|---|---|---|
Required? |
required |
|
Variable Length? |
variableLength |
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 installed in a single session.
Examples
-------- Example 1 ----------
Command Prompt:
Add-WindowsFeature Telnet-Server,Telnet-Client
Install both Telnet Server and Telnet Client.
-------- Example 2 ----------
Command Prompt:
Get-WindowsFeature Web-* | Add-WindowsFeature
Install all Web features.