PowerShell Logo Small

Get-ADOptionalFeature



This is the built-in help made by Microsoft for the command 'Get-ADOptionalFeature', in PowerShell version 3 - as retrieved from Windows version 'Microsoft Windows Server 2012 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Gets one or more Active Directory optional features.

SYNTAX


Get-ADOptionalFeature [-AuthType <ADAuthType>] [-Credential <PSCredential>] [-Properties <String[]>] [-ResultPageSize <Int32>] [-ResultSetSize
<Int32>] [-SearchBase <String>] [-SearchScope <ADSearchScope>] [-Server <String>] -Filter <String> [<CommonParameters>]
Get-ADOptionalFeature [-Identity] <ADOptionalFeature> [-AuthType <ADAuthType>] [-Credential <PSCredential>] [-Properties <String[]>] [-Server
<String>] [<CommonParameters>]
Get-ADOptionalFeature [-AuthType <ADAuthType>] [-Credential <PSCredential>] [-Properties <String[]>] [-ResultPageSize <Int32>] [-ResultSetSize
<Int32>] [-SearchBase <String>] [-SearchScope <ADSearchScope>] [-Server <String>] -LDAPFilter <String> [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Get-ADOptionalFeature cmdlet gets an optional feature or performs a search to retrieve multiple optional features from an Active Directory.


The Identity parameter specifies the Active Directory optional feature that you want to get. You can identify an optional feature by its
distinguished name (DN), feature GUID, or object GUID. You can also set the parameter to an optional feature object variable, such as
$<localOptionalFeatureObject> or you can pass an optional feature object through the pipeline to the Identity parameter.


To search for and retrieve more than one optional feature, use the Filter or LDAPFilter parameters. The Filter parameter uses the PowerShell
Expression Language to write query strings for Active Directory. PowerShell Expression Language syntax provides rich type conversion support
for value types received by the Filter parameter. For more information about the Filter parameter syntax, see about_ActiveDirectory_Filter. If
you have existing LDAP query strings, you can use the LDAPFilter parameter.


This cmdlet retrieves a default set of optional feature object properties. To retrieve additional properties use the Properties parameter. For
more information about the how to determine the properties for computer objects, see the Properties parameter description.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkID=219318
Disable-ADOptionalFeature
Enable-ADOptionalFeature

REMARKS

<

Examples


-------------------------- EXAMPLE 1 --------------------------

C:\PS>Get-ADOptionalFeature -Filter *



Description

-----------

Get a list of all the available optional features in the current forest.




-------------------------- EXAMPLE 2 --------------------------

C:\PS>Get-ADOptionalFeature 'Recycle Bin Feature'



Description

-----------

Get the optional feature with the name 'Recycle Bin Feature'.




-------------------------- EXAMPLE 3 --------------------------

C:\PS>Get-ADOptionalFeature 766ddcd8-acd0-445e-f3b9-a7f9b6744f2a



Description

-----------

Get the optional feature with the feature guid '766ddcd8-acd0-445e-f3b9-a7f9b6744f2a'.




-------------------------- EXAMPLE 4 --------------------------

C:\PS>Get-ADOptionalFeature 'Recycle Bin Feature' -server server1:50000



Description

-----------

Get the 'Recycle Bin Feature' optional feature in an AD LDS instance.