PowerShell Logo Small

Disable-ADOptionalFeature



This is the built-in help made by Microsoft for the command 'Disable-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

Disables an Active Directory optional feature.

SYNTAX


Disable-ADOptionalFeature [-Identity] <ADOptionalFeature> [-Scope] {Unknown | ForestOrConfigurationSet | Domain} [-Target] <ADEntity> [-AuthType {Negotiate | Basic}]
[-Credential <PSCredential>] [-PassThru] [-Server <String>] [-Confirm] [-WhatIf] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Disable-ADOptionalFeature disables an Active Directory optional feature that is associated with a particular Domain Mode or Forest Mode.


The Identity parameter specifies the Active Directory optional feature that you want to disable. 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. For example, you can use the Get-ADOptionalFeature cmdlet to retrieve an optional feature object and then pass the object
through the pipeline to the Disable-ADOptionalFeature cmdlet.


The Scope parameter specifies the scope at which the optional feature is disabled. Possible values for this parameter are Domain and Forest.


The Target parameter specifies the domain or forest on which the optional feature is disabled. You can identify the domain or forest by its fully-qualified domain name
(FQDN), NetBIOS name, or the distinguished name (DN) of the domain naming context (domain NC).



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/p/?linkid=291012
Enable-ADOptionalFeature
Get-ADOptionalFeature

REMARKS

<

Examples


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

PS C:\> Disable-ADOptionalFeature -Identity 'Feature 1' -Scope ForestOrConfigurationSet -Target 'fabrikam' -Server DC1



This command disables the optional feature, named Feature 1, for the forest that has the NetBIOS name fabrikam. This operation should be performed against the DC that holds
the naming master FSMO role.




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

PS C:\>Disable-ADOptionalFeature -Identity 'CN=Feature 1,CN=Optional Features,CN=Directory Service,CN=Windows NT,CN=Services,CN=Configuration,DC=fabrikam,DC=com' -Scope
ForestOrConfigurationSet -Target 'fabrikam.com' -Server DC1



This command disables the optional feature, dn 'CN=Feature 1,CN=Optional Features,CN=Directory Service,CN=Windows NT,CN=Services,CN=Configuration,DC=fabrikam,DC=com, for
the forest, named fabrikam.com. This operation should be performed against the DC that holds the naming master FSMO role.




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

PS C:\>Disable-ADOptionaFeature -Identity '54ec6e43-75a8-445b-aa7b-346a1e096659' -Scope Domain -Target 'DC=fabrikam,DC=com' -Server DC1



This command disables the optional feature that has the GUID 54ec6e43-75a8-445b-aa7b-346a1e096659 for the domain, dn DC=ntdev,DC=fabrikam,DC=com'. This operation should be
performed against the DC that holds the naming master FSMO role.




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

PS C:\>Disable-ADOptionalFeature -Identity 'Feature 1' -Scope ForestOrConfigurationSet -Target 'CN=Configuration,CN={0241853A-6BBF-48AA-8AE0-9C35D0C91B7B}' -Server
server1:50000



This command disables the optional feature, Feature 1, for the AD LDS instance, dn 'CN=Configuration,CN={0241853A-6BBF-48AA-8AE0-9C35D0C91B7B}'. This operation should be
performed against the AD LDS instance that holds the naming master FSMO role.