Test-ADDSReadOnlyDomainControllerAccountCreation
Test-ADDSReadOnlyDomainControllerAccountCreation
Runs the prerequisites (only) for adding a read-only domain controller (RODC) account.
Syntax
Parameter Set: ADDSReadOnlyDomainControllerAccount
Test-ADDSReadOnlyDomainControllerAccountCreation -DomainControllerAccountName <String> -DomainName <String> -SiteName <String> [-AllowPasswordReplicationAccountName <String[]> ] [-Credential <PSCredential> ] [-DelegatedAdministratorAccountName <String> ] [-DenyPasswordReplicationAccountName <String[]> ] [-Force] [-InstallDns] [-NoGlobalCatalog] [-ReplicationSourceDC <String> ] [ <CommonParameters>]
Detailed Description
The Test-ADDSReadOnlyDomainControllerAccountCreation cmdlet runs the prerequisite checks (only) which would be performed if you were to add a read-only domain controller (RODC) account in Active Directory using the Add-ADDSReadOnlyDomainControllerAccount cmdlet. It differs from using the -WhatIf parameter with the Add-ADDSReadOnlyDomainControllerAccount cmdlet in that instead of summarizing the changes that would occur during the account creation process, this cmdlet actually tests whether those changes are possible given the current environment.
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. The default is automatically computed based on the 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 fully writable domain controller to use in creating the RODC account in Active Directory.
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. 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.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
<mandatory> |
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 (https://go.microsoft.com/fwlink/p/?LinkID=113216).
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.
Examples
-------------------------- EXAMPLE 1 --------------------------
Description
-----------
Runs the prerequisites (only) 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.
C:\PS>Test-ADDSReadOnlyDomainControllerAccountCreation -DomainControllerAccuntName RODC1 -DomainName corp.contoso.com -SiteName NorthAmerica