PowerShell Logo Small

Get-ADOptionalFeature



This is the built-in help made by Microsoft for the command 'Get-ADOptionalFeature', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 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 {Negotiate | Basic}] [-Credential <PSCredential>] [-Properties <String[]>] [-ResultPageSize <Int32>] [-ResultSetSize <Int32>] [-SearchBase
<String>] [-SearchScope {Base | OneLevel | Subtree}] [-Server <String>] -Filter <String> [<CommonParameters>]
Get-ADOptionalFeature [-Identity] <ADOptionalFeature> [-AuthType {Negotiate | Basic}] [-Credential <PSCredential>] [-Properties <String[]>] [-Server <String>]
[<CommonParameters>]
Get-ADOptionalFeature [-AuthType {Negotiate | Basic}] [-Credential <PSCredential>] [-Properties <String[]>] [-ResultPageSize <Int32>] [-ResultSetSize <Int32>] [-SearchBase
<String>] [-SearchScope {Base | OneLevel | Subtree}] [-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, type Get-Help 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/p/?linkid=291035
Disable-ADOptionalFeature
Enable-ADOptionalFeature

REMARKS

<

Examples


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

PS C:\>Get-ADOptionalFeature -Filter *



This commands gets a list of all the available optional features in the current forest.




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

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



This command gets the optional feature with the name Recycle Bin Feature.




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

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



This command gets the optional feature with the feature GUID 766ddcd8-acd0-445e-f3b9-a7f9b6744f2a.




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

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



This command gets the Recycle Bin Feature optional feature in an AD LDS instance.