Add-ADDSReadOnlyDomainControllerAccount

Module:

ADDSDeployment Module

Creates a RODC account that can be used to install an RODC in Active Directory.

Syntax

Default (Default)

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

Description

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

Examples

Example 1: Add a RODC account

$HashArguments = @{
    DomainControllerAccountName = "RODC1"
    DomainName                  = "corp.contoso.com"
    SiteName                    = "NorthAmerica"
}
Add-ADDSReadOnlyDomainControllerAccount @HashArguments

This command adds a RODC account to the corp.contoso.com domain using the North America site as the source site for the replication source domain controller.

Parameters

-AllowPasswordReplicationAccountName

Specifies an array 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.

Parameter properties

Type:	String[]
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:	SwitchParameter
Default value:	False
Supports wildcards:	False
DontShow:	False
Aliases:	cf

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-Credential

Specifies the user name and password that corresponds to the account used to install the domain controller. Specify the Get-Credential cmdlet when using this parameter to prompt the user to supply a password.

Parameter properties

Type:	PSCredential
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-DelegatedAdministratorAccountName

Specifies the name of the user or group that installs and administers the RODC.

Parameter properties

Type:	String
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-DenyPasswordReplicationAccountName

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.

Parameter properties

Type:	String[]
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-DomainControllerAccountName

Specifies the name of the RODC account that this cmdlet creates.

Parameter properties

Type:	String
Default value:	<mandatory>
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-DomainName

Specifies the domain name for the user name 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.

Parameter properties

Type:	String
Default value:	<mandatory>
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-Force

Forces the command to run without asking for user confirmation.

Parameter properties

Type:	SwitchParameter
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-InstallDns

Indicates that the cmdlet installs the DNS Server service. If no value is provided, the default behavior is to automatically compute DNS configuration behavior based upon the existing environment.

Parameter properties

Type:	SwitchParameter
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-NoGlobalCatalog

Indicates that the cmdlet does not set the RODC as a global catalog server.

Parameter properties

Type:	SwitchParameter
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-ReplicationSourceDC

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

Parameter properties

Type:	String
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-SiteName

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

Parameter properties

Type:	String
Default value:	<mandatory>
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-SkipPreChecks

Indicates that the cmdlet executes only a base set of validations. 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 ADPrep and Prerequisite Checking Architecture in AD DS Simplified Administration.

Parameter properties

Type:	SwitchParameter
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-WhatIf

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

Parameter properties

Type:	SwitchParameter
Default value:	False
Supports wildcards:	False
DontShow:	False
Aliases:	wi

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

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.

Related Links

• AD DS Simplified Administration
• Install-ADDSDomainController
• Get-Credential