PowerShell Logo Small

Disable-ADOptionalFeature



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

Disables an Active Directory optional feature.

SYNTAX


Disable-ADOptionalFeature [-Identity] <ADOptionalFeature> [-Scope] <ADOptionalFeatureScope> [-Target] <ADEntity> [-AuthType <ADAuthType>]
[-Credential <PSCredential>] [-PassThru [<SwitchParameter>]] [-Server <String>] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
[<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/?LinkID=219295
Enable-ADOptionalFeature
Get-ADOptionalFeature

REMARKS

<

Examples


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

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



Description

-----------

Disable the optional feature (name 'Feature 1') for the forest (NetBIOS name 'fabrikam'). This operation should be performed against the DC
that holds the naming master FSMO role.




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

C:\PS>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



Description

-----------

Disable 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 (FQDN name 'fabrikam.com'). This operation should be performed against the
DC that holds the naming master FSMO role.




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

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



Description

-----------

Disable the optional feature (feature 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 --------------------------

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



Description

-----------

Disable the optional feature (name '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.