Skip to content

Commit 2ced239

Browse files
authored
Merge pull request MicrosoftDocs#3420 from MicrosoftDocs/main
Publish to live, Tuesday 10:30AM PST, 5/2
2 parents 01ac406 + bb60619 commit 2ced239

File tree

4 files changed

+469
-260
lines changed

4 files changed

+469
-260
lines changed
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,7 @@
11
ADCS
2+
Dcpromo
3+
DSRM
4+
krbtgt
25
NTDS
36
RODC
7+
Sysvol

docset/winserver2022-ps/addsdeployment/Add-ADDSReadOnlyDomainControllerAccount.md

+85-42
Original file line numberDiff line numberDiff line change
@@ -16,34 +16,45 @@ Creates a RODC account that can be used to install an RODC in Active Directory.
1616
## SYNTAX
1717

1818
```
19-
Add-ADDSReadOnlyDomainControllerAccount [-SkipPreChecks] -DomainControllerAccountName <String>
20-
-DomainName <String> -SiteName <String> [-AllowPasswordReplicationAccountName <String[]>]
19+
Add-ADDSReadOnlyDomainControllerAccount [-SkipPreChecks]
20+
-DomainControllerAccountName <String> -DomainName <String>
21+
-SiteName <String> [-AllowPasswordReplicationAccountName <String[]>]
2122
[-Credential <PSCredential>] [-DelegatedAdministratorAccountName <String>]
2223
[-DenyPasswordReplicationAccountName <String[]>] [-NoGlobalCatalog] [-InstallDns]
2324
[-ReplicationSourceDC <String>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
2425
```
2526

2627
## DESCRIPTION
27-
The **Add-ADDSReadOnlyDomainControllerAccount** cmdlet creates a read-only domain controller (RODC) account that can be used to install an RODC in Active Directory.
28+
29+
The `Add-ADDSReadOnlyDomainControllerAccount` cmdlet creates a read-only domain controller (RODC)
30+
account that can be used to install an RODC in Active Directory.
2831

2932
## EXAMPLES
3033

3134
### Example 1: Add a RODC account
32-
```
33-
PS C:\> Add-ADDSReadOnlyDomainControllerAccount -DomainControllerAccountName "RODC1" -DomainName "corp.contoso.com" -SiteName "NorthAmerica"
35+
36+
```powershell
37+
$HashArguments = @{
38+
DomainControllerAccountName = "RODC1"
39+
DomainName = "corp.contoso.com"
40+
SiteName = "NorthAmerica"
41+
}
42+
Add-ADDSReadOnlyDomainControllerAccount @HashArguments
3443
```
3544

36-
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.
45+
This command adds a RODC account to the `corp.contoso.com` domain using the North America site as the
46+
source site for the replication source domain controller.
3747

3848
## PARAMETERS
3949

4050
### -AllowPasswordReplicationAccountName
41-
Specifies an array of user accounts, group accounts, and computer accounts whose passwords can be replicated to this RODC.
42-
Use None if you want to keep the value empty.
43-
By default, only the Allowed RODC Password Replication Group is allowed, and it is originally created empty.
51+
52+
Specifies an array of user accounts, group accounts, and computer accounts whose passwords can be
53+
replicated to this RODC. Use None if you want to keep the value empty. By default, only the Allowed
54+
RODC Password Replication Group is allowed, and it is originally created empty.
4455

4556
```yaml
46-
Type: String[]
57+
Type: System.String[]
4758
Parameter Sets: (All)
4859
Aliases:
4960

@@ -55,10 +66,11 @@ Accept wildcard characters: False
5566
```
5667
5768
### -Confirm
69+
5870
Prompts you for confirmation before running the cmdlet.
5971
6072
```yaml
61-
Type: SwitchParameter
73+
Type: System.Management.Automation.SwitchParameter
6274
Parameter Sets: (All)
6375
Aliases: cf
6476

@@ -70,11 +82,13 @@ Accept wildcard characters: False
7082
```
7183
7284
### -Credential
73-
Specifies the user name and password that corresponds to the account used to install the domain controller.
74-
Specify the **Get-Credential** cmdlet when using this parameter to prompt the user to supply a password.
85+
86+
Specifies the user name and password that corresponds to the account used to install the domain
87+
controller. Specify the `Get-Credential` cmdlet when using this parameter to prompt the user to
88+
supply a password.
7589

7690
```yaml
77-
Type: PSCredential
91+
Type: System.Management.Automation.PSCredential
7892
Parameter Sets: (All)
7993
Aliases:
8094
@@ -86,10 +100,11 @@ Accept wildcard characters: False
86100
```
87101

88102
### -DelegatedAdministratorAccountName
103+
89104
Specifies the name of the user or group that installs and administers the RODC.
90105

91106
```yaml
92-
Type: String
107+
Type: System.String
93108
Parameter Sets: (All)
94109
Aliases:
95110
@@ -101,13 +116,17 @@ Accept wildcard characters: False
101116
```
102117

103118
### -DenyPasswordReplicationAccountName
104-
Specifies the names of user accounts, group accounts, and computer accounts whose passwords are not to be replicated to this RODC.
105-
Use None if you do not want to deny the replication of credentials of any users or computers.
106-
By default, Administrators, Server Operators, Backup Operators, Account Operators, and the Denied RODC Password Replication Group are denied.
107-
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.
119+
120+
Specifies the names of user accounts, group accounts, and computer accounts whose passwords are not
121+
to be replicated to this RODC. Use None if you do not want to deny the replication of credentials of
122+
any users or computers. By default, Administrators, Server Operators, Backup Operators, Account
123+
Operators, and the Denied RODC Password Replication Group are denied. By default, the Denied RODC
124+
Password Replication Group includes Cert Publishers, Domain Admins, Enterprise Admins, Enterprise
125+
Domain Controllers, Enterprise Read-Only Domain Controllers, Group Policy Creator Owners, the krbtgt
126+
account, and Schema Admins.
108127

109128
```yaml
110-
Type: String[]
129+
Type: System.String[]
111130
Parameter Sets: (All)
112131
Aliases:
113132
@@ -119,10 +138,11 @@ Accept wildcard characters: False
119138
```
120139

121140
### -DomainControllerAccountName
141+
122142
Specifies the name of the RODC account that this cmdlet creates.
123143

124144
```yaml
125-
Type: String
145+
Type: System.String
126146
Parameter Sets: (All)
127147
Aliases:
128148
@@ -134,12 +154,13 @@ Accept wildcard characters: False
134154
```
135155

136156
### -DomainName
137-
Specifies the domain name for the user name for the operation.
138-
This parameter is required.
139-
It also helps to specify the forest where you plan to install the domain controller or create an RODC account.
157+
158+
Specifies the domain name for the user name for the operation. This parameter is required. It also
159+
helps to specify the forest where you plan to install the domain controller or create an RODC
160+
account.
140161

141162
```yaml
142-
Type: String
163+
Type: System.String
143164
Parameter Sets: (All)
144165
Aliases:
145166
@@ -151,10 +172,11 @@ Accept wildcard characters: False
151172
```
152173

153174
### -Force
175+
154176
Forces the command to run without asking for user confirmation.
155177

156178
```yaml
157-
Type: SwitchParameter
179+
Type: System.Management.Automation.SwitchParameter
158180
Parameter Sets: (All)
159181
Aliases:
160182
@@ -166,11 +188,12 @@ Accept wildcard characters: False
166188
```
167189

168190
### -InstallDns
169-
Indicates that the cmdlet installs the DNS Server service.
170-
If no value is provided, the default behavior is to automatically compute DNS configuration behavior based upon the existing environment.
191+
192+
Indicates that the cmdlet installs the DNS Server service. If no value is provided, the default
193+
behavior is to automatically compute DNS configuration behavior based upon the existing environment.
171194

172195
```yaml
173-
Type: SwitchParameter
196+
Type: System.Management.Automation.SwitchParameter
174197
Parameter Sets: (All)
175198
Aliases:
176199
@@ -182,10 +205,11 @@ Accept wildcard characters: False
182205
```
183206

184207
### -NoGlobalCatalog
208+
185209
Indicates that the cmdlet does not set the RODC as a global catalog server.
186210

187211
```yaml
188-
Type: SwitchParameter
212+
Type: System.Management.Automation.SwitchParameter
189213
Parameter Sets: (All)
190214
Aliases:
191215
@@ -197,10 +221,11 @@ Accept wildcard characters: False
197221
```
198222

199223
### -ReplicationSourceDC
224+
200225
Specifies the name of the domain controller to be used as the source for replicating to this RODC.
201226

202227
```yaml
203-
Type: String
228+
Type: System.String
204229
Parameter Sets: (All)
205230
Aliases:
206231
@@ -212,10 +237,11 @@ Accept wildcard characters: False
212237
```
213238

214239
### -SiteName
240+
215241
Specifies the name of an existing site where you can place the new domain controller.
216242

217243
```yaml
218-
Type: String
244+
Type: System.String
219245
Parameter Sets: (All)
220246
Aliases:
221247
@@ -227,13 +253,17 @@ Accept wildcard characters: False
227253
```
228254

229255
### -SkipPreChecks
230-
Indicates that the cmdlet executes only a base set of validations.
231-
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.
232-
When this switch parameter is set, it specifies that additional preliminary checks should be bypassed.
233-
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](https://go.microsoft.com/fwlink/?LinkID=237244).
256+
257+
Indicates that the cmdlet executes only a base set of validations. This behavior is equivalent to
258+
the validations that were performed when using `Dcpromo.exe` in earlier versions of Windows Server
259+
to add a domain controller. When this switch parameter is set, it specifies that additional
260+
preliminary checks should be bypassed. For more information on the scope of these additional
261+
preliminary checks that the **ADDSDeployment** module performs by default when using Windows Server
262+
2012, refer to the table in the section ADPrep and Prerequisite Checking Architecture in
263+
[AD DS Simplified Administration](https://go.microsoft.com/fwlink/?LinkID=237244).
234264

235265
```yaml
236-
Type: SwitchParameter
266+
Type: System.Management.Automation.SwitchParameter
237267
Parameter Sets: (All)
238268
Aliases:
239269
@@ -245,11 +275,12 @@ Accept wildcard characters: False
245275
```
246276

247277
### -WhatIf
278+
248279
Shows what would happen if the cmdlet runs.
249280
The cmdlet is not run.
250281

251282
```yaml
252-
Type: SwitchParameter
283+
Type: System.Management.Automation.SwitchParameter
253284
Parameter Sets: (All)
254285
Aliases: wi
255286
@@ -261,15 +292,28 @@ Accept wildcard characters: False
261292
```
262293

263294
### CommonParameters
264-
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).
295+
296+
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
297+
-InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose,
298+
-WarningAction, and -WarningVariable. For more information, see
299+
[about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).
265300

266301
## INPUTS
267302

268303
## OUTPUTS
269304

270305
## NOTES
271-
* 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.
272-
* 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.
306+
307+
- Once you have added the RODC account, you can add an RODC to a server computer by using the
308+
`Install-ADDSDomainController` cmdlet with the `-ReadOnlyReplica` switch parameter.
309+
- You can also delegate the ability to attach the server to a non-administrative group or user. If
310+
you are deploying RODCs in delegated administration scenarios where the machine accounts are
311+
pre-provisioned, creating the RODC account is the first stage of the RODC installation process and
312+
needs to be done by a member of the Domain Admins group. In these scenarios, once an administrator
313+
uses this cmdlet to add the RODC account in Active Directory Domain Services (AD DS), the second
314+
stage of the installation can occur. This involves attaching an actual server computer in a remote
315+
location (such as a branch office) that will operate as the RODC for the specified account created
316+
using this cmdlet.
273317

274318
## RELATED LINKS
275319

@@ -278,4 +322,3 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
278322
[Install-ADDSDomainController](./Install-ADDSDomainController.md)
279323

280324
[Get-Credential](https://go.microsoft.com/fwlink/?LinkID=293936)
281-

0 commit comments

Comments
 (0)