Uninstall-ADDSDomainController

Windows Server 2012 R2 and Windows 8.1

Uninstall-ADDSDomainController

Uninstalls a domain controller in Active Directory.

Sintaxis

Parameter Set: ADDSDomainControllerUninstall
Uninstall-ADDSDomainController [-Credential <PSCredential> ] [-DemoteOperationMasterRole] [-DnsDelegationRemovalCredential <PSCredential> ] [-Force] [-IgnoreLastDCInDomainMismatch] [-IgnoreLastDnsServerForZone] [-LastDomainControllerInDomain] [-LocalAdministratorPassword <SecureString> ] [-NoRebootOnCompletion] [-RemoveApplicationPartitions] [-RemoveDnsDelegation] [-RetainDCMetadata] [-SkipPreChecks] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ADDSDomainControllerUninstallForceRemoval
Uninstall-ADDSDomainController -ForceRemoval [-Credential <PSCredential> ] [-DemoteOperationMasterRole] [-Force] [-LocalAdministratorPassword <SecureString> ] [-NoRebootOnCompletion] [-SkipPreChecks] [-Confirm] [-WhatIf] [ <CommonParameters>]




Descripción detallada

The Uninstall-ADDSDomainController cmdlet uninstalls a domain controller in Active Directory.

Parámetros

-Credential<PSCredential>

Specifies the user name and password that corresponds to the account used to install the domain controller. To prompt the user to supply a password, use "(Get-Credential)" in place of an existing PSCredential type. This causes Windows PowerShell to prompt the user to enter credentials using the Windows security login UI.


Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

NULL

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-DemoteOperationMasterRole

Indicates that (forced) demotion should continue even if an operations master role is discovered on domain controller from which AD DS is being removed.


Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

NULL

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-DnsDelegationRemovalCredential<PSCredential>

Specifies the account credentials (user name and password) to use when you create or remove the DNS delegation. If you do not specify a value, the account credentials that you specify for the AD DS installation or removal are used to remove the DNS delegation. As an alternative, you can specify the asterisk (*) to prompt the user to enter credentials.


Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Force

When this parameter is specified any warnings that might normally appear during the uninstallation and removal of the domain controller will be suppressed to allow the cmdlet to complete its operation. This parameter can be useful to include when scripting uninstallation.


Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-ForceRemoval

Forces the removal of a domain controller. Use this parameter to force the uninstall of AD DS if you need to remove the domain controller and do not have connectivity to other domain controllers within the domain topology.


Alias

ninguno

¿Requerido?

true

¿Posición?

named

Valor predeterminado

NULL

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-IgnoreLastDCInDomainMismatch

Used in conjunction with -LastDomainControllerInDomain. This parameter specifies whether the Windows PowerShell ignores any inconsistency that it detects with the value that you specify for -LastDomainControllerInDomain. For example, if you specify -LastDomainControllerInDomain but Windows PowerShell detects that there is actually another active domain controller in the domain, you can specify -IgnoreLastDCInDomainMismatch to have Windows PowerShell continue the removal of AD DS from the domain controller despite the inconsistency that it has detected. Similarly, if you do not specify -LastDomainControllerInDomain but Windows PowerShell cannot detect that another domain controller is in the domain, you can specify -IgnoreLastDCInDomainMismatch to have Windows PowerShell continue to remove AD DS from the domain controller.


Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

NULL

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-IgnoreLastDnsServerForZone

Specifies whether to continue the removal of AD DS despite the fact that the domain controller is the last DNS server for one or more of the Active Directory-integrated DNS zones that it hosts.


Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-LastDomainControllerInDomain

Specifies whether the computer from which AD DS is being removed is the last domain controller in the domain.


Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

NULL

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-LocalAdministratorPassword<SecureString>

Specifies a local administrator account password when AD DS is removed from a domain controller. In earlier releases, where uninstall of AD DS was done using Dcpromo.exe for demotion, the default was to allow an empty password for this setting. In Windows PowerShell, the ADDS Deployment module requires that a non-empty password string value be assigned. If a value is not provided for this parameter, you will be prompted to enter a value for the password at the Windows PowerShell prompt. The password value must be a secure string.

If this parameter is not specified, the cmdlet prompts you to enter and confirm a masked password. This is the preferred usage when running the cmdlet interactively. If additionally there are no other arguments specified with the cmdlet, you will be prompted to enter a masked password for this parameter but no confirmation of the password entered will be made (which is not recommended as it could allow a mistyped password to be configured). Another available advanced option is to use the ConvertTo-SecureString cmdlet and specify the password string inline as unmasked console input, which is also not a recommended security best practice in production deployments.


Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

<mandatory>

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-NoRebootOnCompletion

Specifies whether to not restart the computer upon completion, regardless of success. (By default, reboot upon completion occurs when this cmdlet is used and this parameter is omitted.) As a general rule, Microsoft support recommends that you not use this parameter except for testing or troubleshooting purposes because once configuration has completed the server will not function correctly as either a member server or a DC until it is rebooted.


Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

NULL

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-RemoveApplicationPartitions

Specifies whether to remove application partitions during the removal of AD DS from a domain controller.


Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

NULL

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-RemoveDnsDelegation

Specifies whether to preserve DNS delegations that point to this DNS server from the parent DNS zone.

By default, this parameter is set to FALSE, which means DNS delegations that point to this server from the parent DNS zone will not be retained after uninstallation of the domain controller. This setting corresponds to the earlier Dcpromo.exe parameter default of /RemoveDNSDelegation:Yes.


Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-RetainDCMetadata

If this parameter is used it indicates that metadata from the domain controller should be preserved after uninstallation is completed.


Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

FALSE

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-SkipPreChecks

Indicates that only a base set of validations will be performed. This behavior is equivalent to the validations that were performed when using Dcpromo.exe in earlier versions of Windows Server to add a new domain controller. When this switch parameter is set, it specifies that additional preliminary checks should be bypassed. For more information on the scope of these additional preliminary checks that the ADDSDeployment module performs by default when using Windows Server 2012, refer to the table in the section “Prerequisite Checking” in the Understand and Troubleshoot AD DS Simplified Administration in Windows Server 2012 guide (http://go.microsoft.com/fwlink/?LinkID=237244).


Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Confirm

Solicita confirmación antes de ejecutar el cmdlet.


¿Requerido?

false

¿Posición?

named

Valor predeterminado

falso

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.


¿Requerido?

false

¿Posición?

named

Valor predeterminado

falso

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

<CommonParameters>

Este cmdlet admite los siguientes parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, consulte about_CommonParameters (http://go.microsoft.com/fwlink/p/?LinkID=113216).

Entradas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet.

Salidas

El tipo de resultado es el tipo de objetos que emite el cmdlet.

Ejemplos

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

Description

-----------

Removes AD DS from an additional domain controller in a domain and causes the user to be prompted to set and confirm the local Administrator password prior to completing the removal process.


PS C:\> Uninstall-ADDSDomainController

Temas relacionados

Adiciones de comunidad

AGREGAR
Mostrar: