< Back
Get-WindowsFeature
Post
NAME Get-WindowsFeature
SYNOPSIS
Gets information about Windows Server roles, role services, and features that are available for installation and installed on a specified server.
SYNTAX
Get-WindowsFeature [[-Name] <String[]>] [-ComputerName <String>] [-Credential <PSCredential>] [-LogPath <String>] [-Vhd <String>]
[<CommonParameters>]
DESCRIPTION
The Get-WindowsFeature cmdlet gets information about rrsandf_plural that are both available for installation and already installed on a computer
that is running Windows Server 2012 R2 or an offline virtual hard disk (VHD) that is running Windows Server 2012 R2.
PARAMETERS
-ComputerName [<String>]
Specifies a list of available rrsandf_plural from the specified remote computer that is running Windows Server 2012 R2. The parameter accepts
only one computer name. If this parameter is not added, or no computer name is specified, the default target is the local computer. Valid
values for the parameter include a NetBIOS name, an IP address, or a fully qualified domain name (FQDN) of a remote computer.
To use a remote computer????????s IP address as the value of this parameter, your command must include the Credential parameter. The computer must
either be configured for HTTPS transport, or the IP address of the remote computer must be included in the WinRM TrustedHosts list on the
local computer. For information about adding a computer name to the WinRM TrustedHosts list, see How to Add a Computer to the Trusted Host
List in about_Remote_Troubleshooting (http://go.microsoft.com/fwlink/p/?LinkID=135188).
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Credential [<PSCredential>]
Specifies a user account that has access rights to perform this action. If the parameter is not added, or no value is specified, the default
value of this parameter is the current user. Enter a user name in one of the following formats. Quotation marks are optional.
-- "UserName"
-- "Domain\\User"
-- "User@Domain.com"
-- A Credential object returned by the Get-Credential cmdlet.
If a user name is entered, then a prompt for a password is displayed.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-LogPath [<String>]
Specifies a name and path to a log file. Use this parameter if the results of this cmdlet must be stored in a log.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Name [<String[]>]
Specifies an array of command IDs of roles, role services, or features from which this cmdlet returns information.
Required? false
Position? 1
Default value none
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-Vhd [<String>]
Specifies the path to an offline virtual hard drive (VHD). The path can either point to a VHD file, or to a location on which the VHD is
already mounted by using Deployment Image Servicing and Management (DISM) tools.
The VHD can be on a local disk on the target computer, or on a network shared folder. If the VHD is in a network shared folder, then the value
of this parameter is a UNC path to the VHD. In this case, the computer account of the computer that you are using to mount the VHD must have
read and write permissions (Read/Write permissions in the File Sharing dialog box, or Full Control on the Security tab of the folder
Properties dialog box) on the shared folder, or the VHD will not be accessible. Local loopback UNC paths are not supported. Use either of the
following formats for the computer account: DOMAIN\\SERVERNAME$ or SERVERNAME$.
Add the ComputerName parameter to specify the target computer you want to use to mount the VHD. If the ComputerName parameter is not
specified, then the local computer is used. The computer that you are using to mount the VHD must be running Windows Server 2012 R2. Any local
path, such as D:\\myFolder, that is specified by using this parameter is always relative to the target computer.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
System.String[]
OUTPUTS
Microsoft.Windows.ServerManager.Commands.Feature[]
Example 1: Get a list of features that are available and installed on the specified computer
PS C:\\> Get-WindowsFeature -ComputerName "Server1" -Credential "contoso.com\\user1"
This command gets a list of features that are available and installed on the target computer named Server1. The credentials for user user1 in the
Contoso.com domain, a user who has Administrator rights on Server1, are provided.
Example 2: Get a list of features that is available and installed on the specified offline VHD
PS C:\\> Get-WindowsFeature -Vhd "D:\\ps-test\\vhd1.vhd"
This command gets a list of features that is available and installed on the specified offline VHD located at D:\\ps-test\\vhd1.vhd.
Example 3: Get a list of available and installed features by command ID
PS C:\\> Get-WindowsFeature -Name "AD*, Web*"
This command gets a list of available and installed features that have a command ID starting with AD or Web.
Example 4: Get a list of features that is installed on a specific server
PS C:\\> Get-WindowsFeature ????????ComputerName "Server01" | Where Installed
This command gets a list of features that is installed on the server named Server01.
Example 5: Get a list of features on a server that have installation files that are removed
PS C:\\> Get-WindowsFeature ????????ComputerName "Server01" | Where InstallState -Eq Removed
This command gets a list of features on the server named Server01 that have installation files removed from the local side-by-side store, and
require an external file source for installation.
RELATED LINKS
Online Version:
Uninstall-WindowsFeature
Uninstall-WindowsFeature
Enable-ServerManagerStandardUserRemoting
Disable-ServerManagerStandardUserRemoting
SYNOPSIS
Gets information about Windows Server roles, role services, and features that are available for installation and installed on a specified server.
SYNTAX
Get-WindowsFeature [[-Name] <String[]>] [-ComputerName <String>] [-Credential <PSCredential>] [-LogPath <String>] [-Vhd <String>]
[<CommonParameters>]
DESCRIPTION
The Get-WindowsFeature cmdlet gets information about rrsandf_plural that are both available for installation and already installed on a computer
that is running Windows Server 2012 R2 or an offline virtual hard disk (VHD) that is running Windows Server 2012 R2.
PARAMETERS
-ComputerName [<String>]
Specifies a list of available rrsandf_plural from the specified remote computer that is running Windows Server 2012 R2. The parameter accepts
only one computer name. If this parameter is not added, or no computer name is specified, the default target is the local computer. Valid
values for the parameter include a NetBIOS name, an IP address, or a fully qualified domain name (FQDN) of a remote computer.
To use a remote computer????????s IP address as the value of this parameter, your command must include the Credential parameter. The computer must
either be configured for HTTPS transport, or the IP address of the remote computer must be included in the WinRM TrustedHosts list on the
local computer. For information about adding a computer name to the WinRM TrustedHosts list, see How to Add a Computer to the Trusted Host
List in about_Remote_Troubleshooting (http://go.microsoft.com/fwlink/p/?LinkID=135188).
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Credential [<PSCredential>]
Specifies a user account that has access rights to perform this action. If the parameter is not added, or no value is specified, the default
value of this parameter is the current user. Enter a user name in one of the following formats. Quotation marks are optional.
-- "UserName"
-- "Domain\\User"
-- "User@Domain.com"
-- A Credential object returned by the Get-Credential cmdlet.
If a user name is entered, then a prompt for a password is displayed.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-LogPath [<String>]
Specifies a name and path to a log file. Use this parameter if the results of this cmdlet must be stored in a log.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Name [<String[]>]
Specifies an array of command IDs of roles, role services, or features from which this cmdlet returns information.
Required? false
Position? 1
Default value none
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-Vhd [<String>]
Specifies the path to an offline virtual hard drive (VHD). The path can either point to a VHD file, or to a location on which the VHD is
already mounted by using Deployment Image Servicing and Management (DISM) tools.
The VHD can be on a local disk on the target computer, or on a network shared folder. If the VHD is in a network shared folder, then the value
of this parameter is a UNC path to the VHD. In this case, the computer account of the computer that you are using to mount the VHD must have
read and write permissions (Read/Write permissions in the File Sharing dialog box, or Full Control on the Security tab of the folder
Properties dialog box) on the shared folder, or the VHD will not be accessible. Local loopback UNC paths are not supported. Use either of the
following formats for the computer account: DOMAIN\\SERVERNAME$ or SERVERNAME$.
Add the ComputerName parameter to specify the target computer you want to use to mount the VHD. If the ComputerName parameter is not
specified, then the local computer is used. The computer that you are using to mount the VHD must be running Windows Server 2012 R2. Any local
path, such as D:\\myFolder, that is specified by using this parameter is always relative to the target computer.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
System.String[]
OUTPUTS
Microsoft.Windows.ServerManager.Commands.Feature[]
Example 1: Get a list of features that are available and installed on the specified computer
PS C:\\> Get-WindowsFeature -ComputerName "Server1" -Credential "contoso.com\\user1"
This command gets a list of features that are available and installed on the target computer named Server1. The credentials for user user1 in the
Contoso.com domain, a user who has Administrator rights on Server1, are provided.
Example 2: Get a list of features that is available and installed on the specified offline VHD
PS C:\\> Get-WindowsFeature -Vhd "D:\\ps-test\\vhd1.vhd"
This command gets a list of features that is available and installed on the specified offline VHD located at D:\\ps-test\\vhd1.vhd.
Example 3: Get a list of available and installed features by command ID
PS C:\\> Get-WindowsFeature -Name "AD*, Web*"
This command gets a list of available and installed features that have a command ID starting with AD or Web.
Example 4: Get a list of features that is installed on a specific server
PS C:\\> Get-WindowsFeature ????????ComputerName "Server01" | Where Installed
This command gets a list of features that is installed on the server named Server01.
Example 5: Get a list of features on a server that have installation files that are removed
PS C:\\> Get-WindowsFeature ????????ComputerName "Server01" | Where InstallState -Eq Removed
This command gets a list of features on the server named Server01 that have installation files removed from the local side-by-side store, and
require an external file source for installation.
RELATED LINKS
Online Version:
Uninstall-WindowsFeature
Uninstall-WindowsFeature
Enable-ServerManagerStandardUserRemoting
Disable-ServerManagerStandardUserRemoting