Export (0) Print
Expand All

Add-ADDSReadOnlyDomainControllerAccount

Windows Server 2012 R2 and Windows 8.1

Updated: March 26, 2014

Applies To: Windows 8.1, Windows PowerShell 4.0, Windows Server 2012 R2

Add-ADDSReadOnlyDomainControllerAccount

Creates a read-only domain controller (RODC) account that can be used to install an RODC in Active Directory.

Syntax

Parameter Set: ADDSReadOnlyDomainControllerAccount
Add-ADDSReadOnlyDomainControllerAccount -DomainControllerAccountName <String> -DomainName <String> -SiteName <String> [-AllowPasswordReplicationAccountName <String[]> ] [-Credential <PSCredential> ] [-DelegatedAdministratorAccountName <String> ] [-DenyPasswordReplicationAccountName <String[]> ] [-Force] [-InstallDns] [-NoGlobalCatalog] [-ReplicationSourceDC <String> ] [-SkipPreChecks] [-Confirm] [-WhatIf] [ <CommonParameters>]




Detailed Description

The Add-ADDSReadOnlyDomainControllerAccount cmdlet creates a read-only domain controller (RODC) account that can be used to install an RODC in Active Directory.

Parameters

-AllowPasswordReplicationAccountName<String[]>

Specifies the names of user accounts, group accounts, and computer accounts whose passwords can be replicated to this RODC. Use "None" if you want to keep the value empty. By default, only the Allowed RODC Password Replication Group is allowed, and it is originally created empty.


Aliases

none

Required?

false

Position?

named

Default Value

NULL

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Credential<PSCredential>

Specifies the user name and password that corresponds to the account used to install the domain controller. Specify "(get-credential)" when using this parameter to prompt the user to supply a password.


Aliases

none

Required?

false

Position?

named

Default Value

NULL

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DelegatedAdministratorAccountName<String>

Specifies the name of the user or group that will install and administer the RODC.


Aliases

none

Required?

false

Position?

named

Default Value

NULL

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DenyPasswordReplicationAccountName<String[]>

Specifies the names of user accounts, group accounts, and computer accounts whose passwords are not to be replicated to this RODC. Use "None" if you do not want to deny the replication of credentials of any users or computers. By default, Administrators, Server Operators, Backup Operators, Account Operators, and the Denied RODC Password Replication Group are denied. By default, the Denied RODC Password Replication Group includes Cert Publishers, Domain Admins, Enterprise Admins, Enterprise Domain Controllers, Enterprise Read-Only Domain Controllers, Group Policy Creator Owners, the krbtgt account, and Schema Admins.


Aliases

none

Required?

false

Position?

named

Default Value

NULL

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DomainControllerAccountName<String>

Specifies the name of the RODC account that you are creating.


Aliases

none

Required?

true

Position?

named

Default Value

<mandatory>

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DomainName<String>

Specifies the domain name for the user name (account credentials) for the operation. This parameter is required. It also helps to specify the forest where you plan to install the domain controller or create an RODC account.


Aliases

none

Required?

true

Position?

named

Default Value

<mandatory>

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Force

Forces completion of the cmdlet even if issues are found in the process of creating the RODC account.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-InstallDns

Specifies whether the DNS Server service should be installed. If no value is provided, the default behavior is to automatically compute DNS configuration behavior based upon the existing environment.


Aliases

none

Required?

false

Position?

named

Default Value

NULL

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-NoGlobalCatalog

Specifies that the read-only domain controller (RODC) will not be a global catalog server.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ReplicationSourceDC<String>

Specifies the name of the domain controller to be used as the source for replicating to this RODC.


Aliases

none

Required?

false

Position?

named

Default Value

NULL

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-SiteName<String>

Specifies the name of an existing site where you can place the new domain controller.


Aliases

none

Required?

true

Position?

named

Default Value

<mandatory>

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-SkipPreChecks

Specifies that only a base set of validations will be performed when this cmdlet is executed. This behavior is equivalent to the validations that were performed when using Dcpromo.exe in earlier versions of Windows Server to add a 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 located at http://go.microsoft.com/fwlink/?LinkID=237244.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Notes

  • Once you have added the RODC account, you can add an RODC to a server computer by using the Install-ADDSDomainController cmdlet with the -ReadOnlyReplica switch parameter.

  • You can also delegate the ability to attach the server to a non-administrative group or user. If you are deploying RODCs in delegated administration scenarios where the machine accounts are pre-provisioned, creating the RODC account is the first stage of the RODC installation process and needs to be done by a member of the Domain Admins group. In these scenarios, once an administrator uses this cmdlet to add the RODC account in Active Directory Domain Services (AD DS), the second stage of the installation can occur. This involves attaching an actual server computer in a remote location (such as a branch office) that will operate as the RODC for the specified account created using this cmdlet.

Examples

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

Description

-----------

Adds a new read-only domain controller (RODC) account to the corp.contoso.com domain using the North America site as the source site for the replication source domain controller.


PS C:\> Add-ADDSReadOnlyDomainControllerAccount -DomainControllerAccountName RODC1 -DomainName corp.contoso.com -SiteName NorthAmerica

Related topics

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft