Active Directory · Risk: Low · Documentation Verified
Last verified: 2026-10-26
Microsoft ADDSDeployment reference: Runs the prerequisites for adding a RODC account. The syntax and selected example below are adapted from the pinned Windows Server 2025 reference. Module availability, target configuration and delegated permissions determine whether it can run in your environment. Documentation and parameter text: Microsoft, CC BY 4.0; formatting adapted by Cmdlet World. No execution testing is claimed.
Use an account with the target resource permissions documented for Test-ADDSReadOnlyDomainControllerAccountCreation. Modifying administrative cmdlets may require elevation or delegated administration. This catalog does not assert that ordinary users can execute the command.
Supported environments
Windows / ADDSDeployment · Windows Server 2025 documentation; feature/module prerequisites apply
Parameters
-AllowPasswordReplicationAccountName
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.
-Credential
Specifies the user name and password that corresponds to the account used to install the domain controller. Use the Get-Credential cmdlet to prompt the user to supply a password.
-DelegatedAdministratorAccountName
Specifies the name of the user or group that installs and administer the RODC.
-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.
-DomainControllerAccountName (required)
Specifies the name of the RODC account that this cmdlet creates.
-DomainName (required)
Specifies the domain name for the user name for the operation. This parameter is required. You should specify the forest where you plan to install the domain controller or create an RODC account.
-Force
Forces the command to run without asking for user confirmation.
-InstallDns
Indicates that the cmdlet installs the DNS Server service. The default is automatically computed based on the environment.
-NoGlobalCatalog
Indicates that the RODC is not a global catalog server.
-ReplicationSourceDC
Specifies the name of the fully writable domain controller to use in the creation of the RODC account in Active Directory.
-SiteName (required)
Specifies the name of an existing site where you can place the new domain controller. The default value depends on the type of installation. For a new forest, the default is Default-First-Site-Name. For all other installations, the default is the site that is associated with the subnet that includes the IP address of this server. If no such site exists, the default is the site of the replication source domain controller.
Prerequisites
Windows with the ADDSDeployment module and the Windows feature or management tools that provide it. Confirm target connectivity and version compatibility using the linked Microsoft reference.
Security considerations
This is a read-oriented cmdlet; protect any sensitive results and check the documented effects of your selected parameters.
Examples
Example 1: Test adding an RODC account to confirm it is possible
This command runs the prerequisites for adding an RODC account to the corp.contoso.com domain that would use the North America site as the source site for the replication source domain controller. Source: Microsoft, CC BY 4.0; transcript prompt/output removed. This example was not executed.