Source code of Windows XP (NT5)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

1027 lines
47 KiB

  1. ;//+-------------------------------------------------------------------------
  2. ;//
  3. ;// Microsoft Windows
  4. ;//
  5. ;// Copyright (C) Microsoft Corporation, 2000 - 2000
  6. ;//
  7. ;// File: usage.mc
  8. ;// Author: micretz
  9. ;//--------------------------------------------------------------------------
  10. MessageId=1
  11. SymbolicName=USAGE_DSMOD
  12. Language=English
  13. Description: This tool's commands modify existing objects in the directory. The dsmod commands:
  14. dsmod computer - modifies an existing computer in the directory.
  15. dsmod contact - modifies an existing contact in the directory.
  16. dsmod group - modifies an existing group in the directory.
  17. dsmod ou - modifies an existing organizational unit in the directory.
  18. dsmod server - modifies an existing domain controller in the directory.
  19. dsmod user - modifies an existing user in the directory.
  20. For help on a specific command, type "dsmod <ObjectType> /?" where <ObjectType> is
  21. one of the supported object types shown above. For example, dsmod ou /?.
  22. Remarks:
  23. The dsmod commands support piping of input to allow you to pipe results from the dsquery commands as input to the dsmod commands and modify the objects found by the dsquery commands.
  24. Examples:
  25. To find all users in the organizational unit (OU) "ou=Marketing,dc=microsoft,dc=com"
  26. and add them to the Marketing Staff group:
  27. dsquery user startnode "ou=Marketing,dc=microsoft,dc=com" |
  28. dsmod group "cn=Marketing Staff,ou=Marketing,dc=microsoft,dc=com" -addmbr
  29. Directory Service command-line tools help:
  30. dsadd /? - help for adding objects.
  31. dsget /? - help for displaying objects.
  32. dsmod /? - help for modifying objects.
  33. dsmove /? - help for moving objects.
  34. dsquery /? - help for finding objects matching search criteria.
  35. dsrm /? - help for deleting objects.
  36. .
  37. MessageId=2
  38. SymbolicName=USAGE_DSMOD_USER
  39. Language=English
  40. Description: Modifies an existing user in the directory.
  41. Syntax: dsmod user <ObjectDN ...>
  42. [-upn <UPN>]
  43. [-fn <FirstName>]
  44. [-mi <Initial>]
  45. [-ln <LastName>]
  46. [-display <DisplayName>]
  47. [-empid <EmployeeID>]
  48. [-pwd {<Password> | *}]
  49. [-desc <Description>]
  50. [-office <Office>]
  51. [-tel <Phone#>]
  52. [-email <Email>]
  53. [-hometel <HomePhone#>]
  54. [-pager <Pager#>]
  55. [-mobile <CellPhone#>]
  56. [-fax <Fax#>]
  57. [-iptel <IPPhone#>]
  58. [-webpg <WebPage>]
  59. [-title <Title>]
  60. [-dept <Department>]
  61. [-company <Company>]
  62. [-mgr <Manager>]
  63. [-hmdir <HomeDir>]
  64. [-hmdrv <DriveLtr>:]
  65. [-profile <ProfilePath>]
  66. [-loscr <ScriptPath>]
  67. [-mustchpwd {yes | no}]
  68. [-canchpwd {yes | no}]
  69. [-reversiblepwd {yes | no}]
  70. [-pwdneverexpires {yes | no}]
  71. [-acctexpires <NumDays>]
  72. [-disabled {yes | no}]
  73. [{-s <Server> | -d <Domain>}]
  74. [-u <UserName>]
  75. [-p {<Password> | *}]
  76. [-C]
  77. [-q]
  78. Parameters:
  79. Value Description
  80. <ObjectDN ...> Required/stdin. Distinguished names (DNs)
  81. of one or more users to modify.
  82. If target objects are omitted they
  83. will be taken from standard input (stdin)
  84. to support piping of output from another command
  85. to input of this command.
  86. -upn <UPN> Sets the UPN value to <UPN>.
  87. -fn <FirstName> Sets user first name to <FirstName>.
  88. -mi <Initial> Sets user middle initial to <Initial>.
  89. -ln <LastName> Sets user last name to <LastName>.
  90. -display <DisplayName> Sets user display name to <DisplayName>.
  91. -empid <EmployeeID> Sets user employee ID to <EmployeeID>.
  92. -pwd {<Password> | *} Resets user password to <Password>. If *, then
  93. you are prompted for a password.
  94. -desc <Description> Sets user description to <Description>.
  95. -office <Office> Sets user office location to <Office>.
  96. -tel <Phone#> Sets user telephone# to <Phone#>.
  97. -email <Email> Sets user e-mail address to <Email>.
  98. -hometel <HomePhone#> Sets user home phone# to <HomePhone#>.
  99. -pager <Pager#> Sets user pager# to <Pager#>.
  100. -mobile <CellPhone#> Sets user mobile# to <CellPhone#>.
  101. -fax <Fax#> Sets user fax# to <Fax#>.
  102. -iptel <IPPhone#> Sets user IP phone# to <IPPhone#>.
  103. -webpg <WebPage> Sets user web page URL to <WebPage>.
  104. -title <Title> Sets user title to <Title>.
  105. -dept <Department> Sets user department to <Department>.
  106. -company <Company> Sets user company info to <Company>.
  107. -mgr <Manager> Sets user's manager to <Manager>.
  108. -hmdir <HomeDir> Sets user home directory to <HomeDir>. If this is
  109. UNC path, then a drive letter to be mapped to
  110. this path must also be specified through -hmdrv.
  111. -hmdrv <DriveLtr>: Sets user home drive letter to <DriveLtr>:
  112. -profile <ProfilePath> Sets user's profile path to <ProfilePath>.
  113. -loscr <ScriptPath> Sets user's logon script path to <ScriptPath>.
  114. -mustchpwd {yes | no} Sets whether the user must change his password (yes)
  115. or not (no) at his next logon.
  116. -canchpwd {yes | no} Sets whether the user can change his password (yes)
  117. or not (no). This setting should be "yes"
  118. if the -mustchpwd setting is "yes".
  119. -reversiblepwd {yes | no}
  120. Sets whether the user password should be stored using
  121. reversible encryption (yes) or not (no).
  122. -pwdneverexpires {yes | no}
  123. Sets whether the user's password never expires (yes)
  124. or not (no).
  125. -acctexpires <NumDays> Sets user account to expire in <NumDays> days from
  126. today. A value of 0 sets expiration at the end of today.
  127. A positive value sets expiration in the future.
  128. A negative value sets expiration in the past.
  129. A string value of "never" sets the account
  130. to never expire.
  131. -disabled {yes | no} Sets whether the user account is disabled (yes)
  132. or not (no).
  133. {-s <Server> | -d <Domain>}
  134. -s <Server> connects to the domain controller (DC)
  135. with name <Server>. Default: local system.
  136. -d <Domain> connects to a DC in domain <Domain>.
  137. Default: a DC in the logon domain.
  138. -u <UserName> Connect as <UserName>. Default: the logged in user.
  139. -p <Password> Password for the user <UserName>. If * then prompt for pwd.
  140. -C Continuous operation mode. Reports errors but continues with
  141. next object in argument list when multiple target objects
  142. are specified. Without this option, the command exits
  143. on first error.
  144. -q Quiet mode: suppress all output to standard output.
  145. Remarks:
  146. If a value that you supply contains spaces, use quotation marks
  147. around the text (for example, "CN=John Smith,CN=Users,DC=microsoft,DC=com").
  148. If you enter multiple values, the values must be separated by spaces
  149. (for example, a list of distinguished names).
  150. The special token $username$ (case insensitive) may be used to place the SAM account name in the value of a parameter. For example, if the target user DN is CN=Jane Doe,CN=users,CN=microsoft,CN=com and the SAM account name attribute is "janed," the -hmdir parameter can have the following substitution:
  151. -hmdir \users\$username$\home
  152. The value of the -hmdir parameter is modified to the following value:
  153. - hmdir \users\janed\home
  154. Examples:
  155. To reset a user's password:
  156. dsmod user "CN=John Doe,CN=Users,DC=microsoft,DC=com"
  157. -pwd A1b2C3d4 -mustchpwd yes
  158. To reset multiple user passwords to a common password
  159. and force them to change their passwords the next time they logon:
  160. dsmod user "CN=John Doe,CN=Users,DC=microsoft,DC=com" "CN=Jane Doe,CN=Users,DC=microsoft,DC=com" -pwd A1b2C3d4 -mustchpwd yes
  161. To disable multiple user accounts at the same time:
  162. dsmod user "CN=John Doe,CN=Users,DC=microsoft,DC=com" "CN=Jane Doe,CN=Users,DC=microsoft,DC=com" -disabled yes
  163. To modify the profile path of multiple users to a common path using the $username$ token:
  164. dsmod user "CN=John Doe,CN=Users,DC=microsoft,DC=com" "CN=Jane Doe,CN=Users,DC=microsoft,DC=com" -profile \users\$username$\profile
  165. See also:
  166. dsmod computer /? - help for modifying an existing computer in the directory.
  167. dsmod contact /? - help for modifying an existing contact in the directory.
  168. dsmod group /? - help for modifying an existing group in the directory.
  169. dsmod ou /? - help for modifying an existing ou in the directory.
  170. dsmod server /? - help for modifying an existing domain controller in the directory.
  171. dsmod user /? - help for modifying an existing user in the directory.
  172. Directory Service command-line tools help:
  173. dsadd /? - help for adding objects.
  174. dsget /? - help for displaying objects.
  175. dsmod /? - help for modifying objects.
  176. dsmove /? - help for moving objects.
  177. dsquery /? - help for finding objects matching search criteria.
  178. dsrm /? - help for deleting objects.
  179. .
  180. MessageId=3
  181. SymbolicName=USAGE_DSMOD_COMPUTER
  182. Language=English
  183. Description: Modifies an existing computer in the directory.
  184. Syntax: dsmod computer <ObjectDN ...>
  185. [-desc <Description>]
  186. [-loc <Location>]
  187. [-disabled {yes | no}]
  188. [-reset]
  189. [{-s <Server> | -d <Domain>}]
  190. [-u <UserName>]
  191. [-p {<Password> | *}]
  192. [-C]
  193. [-q]
  194. Parameters:
  195. Value Description
  196. <ObjectDN ...> Required/stdin. Distinguished names (DNs) of one
  197. or more computers to modify.
  198. If target objects are omitted they
  199. will be taken from standard input (stdin)
  200. to support piping of output from another command
  201. to input of this command.
  202. -desc <Description> Sets computer description to <Description>.
  203. -loc <Location> Sets the location of the computer object to <Location>.
  204. -disabled {yes | no} Sets whether the computer account is disabled (yes)
  205. or not (no).
  206. -reset Resets computer account.
  207. {-s <Server> | -d <Domain>}
  208. -s <Server> connects to the domain controller (DC) with name
  209. <Server>. Default: local system.
  210. -d <Domain> connects to a DC in domain <Domain>.
  211. Default: a DC in the logon domain.
  212. -u <UserName> Connect as <UserName>. Default: the logged in user.
  213. -p <Password> Password for the user <UserName>. If * then prompt for pwd.
  214. -C Continuous operation mode. Reports errors but continues with
  215. next object in argument list when multiple target objects
  216. are specified. Without this option, the command exits
  217. on first error.
  218. -q Quiet mode: suppress all output to standard output.
  219. Remarks:
  220. If a value that you supply contains spaces, use quotation marks
  221. around the text (for example, "CN=DC2,OU=Domain Controllers,DC=microsoft,DC=com").
  222. If you enter multiple values, the values must be separated by spaces
  223. (for example, a list of distinguished names).
  224. Examples:
  225. To disable multiple computer accounts:
  226. dsmod computer CN=MemberServer1,CN=Computers,DC=microsoft,DC=com
  227. CN=MemberServer2,CN=Computers,DC=microsoft,DC=com
  228. -disabled yes
  229. To reset multiple computer accounts:
  230. dsmod computer CN=MemberServer1,CN=Computers,DC=microsoft,DC=com
  231. CN=MemberServer2,CN=Computers,DC=microsoft,DC=com -reset
  232. See also:
  233. dsmod computer /? - help for modifying an existing computer in the directory.
  234. dsmod contact /? - help for modifying an existing contact in the directory.
  235. dsmod group /? - help for modifying an existing group in the directory.
  236. dsmod ou /? - help for modifying an existing ou in the directory.
  237. dsmod server /? - help for modifying an existing domain controller in the directory.
  238. dsmod user /? - help for modifying an existing user in the directory.
  239. Directory Service command-line tools help:
  240. dsadd /? - help for adding objects.
  241. dsget /? - help for displaying objects.
  242. dsmod /? - help for modifying objects.
  243. dsmove /? - help for moving objects.
  244. dsquery /? - help for finding objects matching search criteria.
  245. dsrm /? - help for deleting objects.
  246. .
  247. MessageId=4
  248. SymbolicName=USAGE_DSMOD_GROUP
  249. Language=English
  250. Description: Modifies an existing group in the directory.
  251. The are two variations of this command.
  252. The first variation allows you to modify the properties
  253. of multiple groups. The second variation allows
  254. you to modify the members of a single group.
  255. Syntax: dsmod group <ObjectDN ...>
  256. [-samid <SAMName>]
  257. [-desc <Description>]
  258. [-secgrp {yes | no}]
  259. [-scope {l | g | u}]
  260. [{-s <Server> | -d <Domain>}]
  261. [-u <UserName>]
  262. [-p {<Password> | *}]
  263. [-C]
  264. [-q]
  265. dsmod group <ObjectDN>
  266. {-addmbr | -rmmbr | -chmbr}
  267. <Member ...>
  268. [{-s <Server> | -d <Domain>}]
  269. [-u <UserName>]
  270. [-p {<Password> | *}]
  271. [-C]
  272. [-q]
  273. Parameters:
  274. Value Description
  275. <ObjectDN ...> Required/stdin. Distinguished names (DNs) of
  276. one or more groups to modify.
  277. Applies to both instruction sets for this command.
  278. If target objects are omitted they
  279. will be taken from standard input (stdin)
  280. to support piping of output from another command
  281. to input of this command.
  282. -samid <SAMName> Sets the SAM account name of group to <SAMName>.
  283. -desc <Description> Sets group description to <Description>.
  284. -secgrp {yes | no} Sets the group type to security (yes)
  285. or non-security (no).
  286. -scope {l | g | u} Sets the scope of group to local (l),
  287. global (g), or universal (u).
  288. <ObjectDN> Required. DN of group to modify.
  289. This target object must precede the
  290. -addmbr, -rmmbr, and -chmbr parameters.
  291. {-addmbr | -rmmbr | -chmbr}
  292. -addmbr adds members to the group.
  293. -rmmbr removes members from the group.
  294. -chmbr changes (replaces) the complete list of
  295. members in the group.
  296. <Member ...> Required/stdin. Space-separated list
  297. of members to add to, delete from,
  298. or replace in the group.
  299. If these target objects are omitted, they
  300. will be taken from standard input (stdin)
  301. to support piping of output from another command
  302. to input of this command.
  303. These target objects must follow the
  304. -addmbr, -rmmbr, and -chmbr parameters.
  305. {-s <Server> | -d <Domain>}
  306. -s <Server> connects to the domain controller (DC) with name
  307. <Server>. Default: local system.
  308. -d <Domain> connects to a DC in domain <Domain>.
  309. Default: a DC in the logon domain.
  310. -u <UserName> Connect as <UserName>. Default: the logged in user.
  311. -p <Password> Password for the user <UserName>. If * then prompt for pwd.
  312. -C Continuous operation mode. Reports errors but continues with
  313. next object in argument list when multiple target objects
  314. are specified. Without this option, the command exits
  315. on first error.
  316. -q Quiet mode: suppress all output to standard output.
  317. Remarks:
  318. If a value that you supply contains spaces, use quotation marks
  319. around the text (for example, "CN=USA Sales,OU=Distribution Lists,DC=microsoft,DC=com").
  320. If you enter multiple values, the values must be separated by spaces
  321. (for example, a list of distinguished names).
  322. Examples:
  323. To convert the group type of several groups from "security" to "non-security":
  324. dsmod group "CN=US INFO,OU=Distribution Lists,DC=microsoft,DC=com" "CN=CANADA INFO,OU=Distribution Lists,DC=microsoft,DC=com" "CN=MEXICO INFO,OU=Distribution Lists,DC=microsoft,DC=com" -secgrp no
  325. To add three new members to the group "CN=US INFO,OU=Distribution Lists,DC=microsoft,DC=com":
  326. dsmod group "CN=US INFO,OU=Distribution Lists,DC=microsoft,DC=com" -addmbr
  327. "CN=John Smith,CN=Users,DC=microsoft,DC=com" CN=Datacenter,OU=Distribution Lists,DC=microsoft,DC=com "CN=Jane Smith,CN=Users,DC=microsoft,DC=com"
  328. To add all users from the OU "Marketing" to the exisitng group "Marketing Staff":
  329. dsquery user -startnode ou=Marketing,dc=microsoft,dc=com | dsmod group "cn=Marketing Staff,ou=Marketing,dc=microsoft,dc=com" -addmbr
  330. To delete two members from the exisitng group "CN=US INFO,OU=Distribution Lists,DC=microsoft,DC=com":
  331. dsmod group "CN=US INFO,OU=Distribution Lists,DC=microsoft,DC=com" -rmmbr "CN=John Smith,CN=Users,DC=microsoft,DC=com" CN=Datacenter,OU=Distribution Lists,DC=microsoft,DC=com
  332. See also:
  333. dsmod computer /? - help for modifying an existing computer in the directory.
  334. dsmod contact /? - help for modifying an existing contact in the directory.
  335. dsmod group /? - help for modifying an existing group in the directory.
  336. dsmod ou /? - help for modifying an existing ou in the directory.
  337. dsmod server /? - help for modifying an existing domain controller in the directory.
  338. dsmod user /? - help for modifying an existing user in the directory.
  339. Directory Service command-line tools help:
  340. dsadd /? - help for adding objects.
  341. dsget /? - help for displaying objects.
  342. dsmod /? - help for modifying objects.
  343. dsmove /? - help for moving objects.
  344. dsquery /? - help for finding objects matching search criteria.
  345. dsrm /? - help for deleting objects.
  346. .
  347. MessageId=7
  348. SymbolicName=USAGE_DSMOD_OU
  349. Language=English
  350. Description: Modifies an existing organizational unit in the
  351. directory.
  352. Syntax: dsmod ou <ObjectDN ...>
  353. [-desc <Description>]
  354. [{-s <Server> | -d <Domain>}]
  355. [-u <UserName>]
  356. [-p {<Password> | *}]
  357. [-C]
  358. [-q]
  359. Parameters:
  360. Value Description
  361. <ObjectDN ...> Required/stdin. Distinguished names (DNs)
  362. of one or more organizational units (OUs) to modify.
  363. If target objects are omitted they
  364. will be taken from standard input (stdin)
  365. to support piping of output from another command
  366. to input of this command.
  367. -desc <Description> Sets OU description to <Description>.
  368. {-s <Server> | -d <Domain>}
  369. -s <Server> connects to the domain controller (DC) with name
  370. <Server>. Default: local system.
  371. -d <Domain> connects to a DC in domain <Domain>.
  372. Default: a DC in the logon domain.
  373. -u <UserName> Connect as <UserName>. Default: the logged in user.
  374. -p <Password> Password for the user <UserName>. If * then prompt for pwd.
  375. -C Continuous operation mode. Reports errors but continues with
  376. next object in argument list when multiple target objects
  377. are specified. Without this option, the command exits
  378. on first error.
  379. -q Quiet mode: suppress all output to standard output.
  380. Remarks:
  381. If a value that you supply contains spaces, use quotation marks
  382. around the text (for example, "OU=Domain Controllers,DC=microsoft,DC=com").
  383. If you enter multiple values, the values must be separated by spaces
  384. (for example, a list of distinguished names).
  385. Examples:
  386. To change the description of several OUs at the same time:
  387. dsmod ou "OU=Domain Controllers,DC=microsoft,DC=com" "OU=Resources,DC=microsoft,DC=com" "OU=troubleshooting,DC=microsoft,DC=com" -desc "This is a test OU"
  388. See also:
  389. dsmod computer /? - help for modifying an existing computer in the directory.
  390. dsmod contact /? - help for modifying an existing contact in the directory.
  391. dsmod group /? - help for modifying an existing group in the directory.
  392. dsmod ou /? - help for modifying an existing ou in the directory.
  393. dsmod server /? - help for modifying an existing domain controller in the directory.
  394. dsmod user /? - help for modifying an existing user in the directory.
  395. Directory Service command-line tools help:
  396. dsadd /? - help for adding objects.
  397. dsget /? - help for displaying objects.
  398. dsmod /? - help for modifying objects.
  399. dsmove /? - help for moving objects.
  400. dsquery /? - help for finding objects matching search criteria.
  401. dsrm /? - help for deleting objects.
  402. .
  403. MessageId=8
  404. SymbolicName=USAGE_DSMOD_CONTACT
  405. Language=English
  406. Description: Modify an existing contact in the directory.
  407. Syntax: dsmod contact <ObjectDN ...>
  408. [-fn <FirstName>]
  409. [-mi <Initial>]
  410. [-ln <LastName>]
  411. [-display <DisplayName>]
  412. [-desc <Description>]
  413. [-office <Office>]
  414. [-tel <Phone#>]
  415. [-email <Email>]
  416. [-hometel <HomePhone#>]
  417. [-pager <Pager#>]
  418. [-mobile <CellPhone#>]
  419. [-fax <Fax#>]
  420. [-iptel <IPPhone#>]
  421. [-title <Title>]
  422. [-dept <Department>]
  423. [-company <Company>]
  424. [{-s <Server> | -d <Domain>}]
  425. [-u <UserName>]
  426. [-p {<Password> | *}]
  427. [-C]
  428. [-q]
  429. Parameters:
  430. Value Description
  431. <ObjectDN ...> Required/stdin. Distinguished names (DNs)
  432. of one or more contacts to modify.
  433. If target objects are omitted they
  434. will be taken from standard input (stdin)
  435. to support piping of output from another
  436. command to input of this command.
  437. -fn <FirstName> Sets contact first name to <FirstName>.
  438. -mi <Initial> Sets contact middle initial to <Initial>.
  439. -ln <LastName> Sets contact last name to <LastName>.
  440. -display <DisplayName> Sets contact display name to <DisplayName>.
  441. -desc <Description> Sets contact description to <Description>.
  442. -office <Office> Sets contact office location to <Office>.
  443. -tel <Phone#> Sets contact telephone# to <Phone#>.
  444. -email <Email> Sets contact e-mail address to <Email>.
  445. -hometel <HomePhone#> Sets contact home phone# to <HomePhone#>.
  446. -pager <Pager#> Sets contact pager# to <Pager#>.
  447. -mobile <CellPhone#> Sets contact mobile# to <CellPhone#>.
  448. -fax <Fax#> Sets contact fax# to <Fax#>.
  449. -iptel <IPPhone#> Sets contact IP phone# to <IPPhone#>.
  450. -title <Title> Sets contact title to <Title>.
  451. -dept <Department> Sets contact department to <Department>.
  452. -company <Company> Sets contact company info to <Company>.
  453. {-s <Server> | -d <Domain>}
  454. -s <Server> connects to the domain controller (DC)
  455. with name <Server>. Default: local system.
  456. -d <Domain> connects to a DC in domain <Domain>.
  457. Default: a DC in the logon domain.
  458. -u <UserName> Connect as <UserName>. Default: the logged in user.
  459. -p <Password> Password for the user <UserName>. If * then prompt for pwd.
  460. -C Continuous operation mode. Reports errors but continues with
  461. next object in argument list when multiple target objects
  462. are specified. Without this option, the command exits
  463. on first error.
  464. -q Quiet mode: suppress all output to standard output.
  465. Remarks:
  466. If a value that you supply contains spaces, use quotation marks
  467. around the text (for example, "CN=John Smith,OU=Contacts,DC=microsoft,DC=com").
  468. If you enter multiple values, the values must be separated by spaces
  469. (for example, a list of distinguished names).
  470. Examples:
  471. To set the company information of multiple contacts:
  472. dsmod contact "CN=John Doe,OU=Contacts,DC=microsoft,DC=com" "CN=Jane Doe,OU=Contacts,DC=microsoft,DC=com" -company microsoft
  473. See also:
  474. dsmod computer /? - help for modifying an existing computer in the directory.
  475. dsmod contact /? - help for modifying an existing contact in the directory.
  476. dsmod group /? - help for modifying an existing group in the directory.
  477. dsmod ou /? - help for modifying an existing ou in the directory.
  478. dsmod server /? - help for modifying an existing domain controller in the directory.
  479. dsmod user /? - help for modifying an existing user in the directory.
  480. Directory Service command-line tools help:
  481. dsadd /? - help for adding objects.
  482. dsget /? - help for displaying objects.
  483. dsmod /? - help for modifying objects.
  484. dsmove /? - help for moving objects.
  485. dsquery /? - help for finding objects matching search criteria.
  486. dsrm /? - help for deleting objects.
  487. .
  488. MessageId=9
  489. SymbolicName=USAGE_DSMOD_SUBNET
  490. Language=English
  491. Description: Modifies an existing subnet in the directory.
  492. Syntax: dsmod subnet <Name ...>
  493. [-desc <Description>]
  494. [-loc <Location>]
  495. [-site <SiteName>]
  496. [{-s <Server> | -d <Domain>}]
  497. [-u <UserName>]
  498. [-p {<Password> | *}]
  499. [-C]
  500. [-q]
  501. Parameters:
  502. Value Description
  503. <Name ...> Required/stdin. Name of one or more subnets to modify.
  504. If target objects are omitted they
  505. will be taken from standard input (stdin)
  506. to support piping of output from another
  507. command to input of this command.
  508. -desc <Description> Sets subnet description to <Description>.
  509. -loc <Location> Sets subnet location to <Location>.
  510. -site <SiteName> Sets the associated site for the subnet to <SiteName>.
  511. {-s <Server> | -d <Domain>}
  512. -s <Server> connects to the domain controller (DC) with name
  513. <Server>. Default: local system.
  514. -d <Domain> connects to a DC in domain <Domain>.
  515. Default: a DC in the logon domain.
  516. -u <UserName> Connect as <UserName>. Default: the logged in user.
  517. -p <Password> Password for the user <UserName>. If * then prompt for pwd.
  518. -C Continuous operation mode. Reports errors but continues with
  519. next object in argument list when multiple target objects
  520. are specified. Without this option, the command exits
  521. on first error.
  522. -q Quiet mode: suppress all output to standard output.
  523. Remarks:
  524. If a value that you supply contains spaces, use quotation marks
  525. around the text (for example, "CN=John Smith,CN=Users,DC=microsoft,DC=com").
  526. If you enter multiple values, the values must be separated by spaces
  527. (for example, a list of distinguished names).
  528. Examples:
  529. To modify the descriptions for the subnet "123.56.15.0/24":
  530. dsget subnet "123.56.15.0/24" -desc "test lab"
  531. See also:
  532. dsmod computer /? - help for modifying an existing computer in the directory.
  533. dsmod contact /? - help for modifying an existing contact in the directory.
  534. dsmod group /? - help for modifying an existing group in the directory.
  535. dsmod ou /? - help for modifying an existing ou in the directory.
  536. dsmod server /? - help for modifying an existing domain controller in the directory.
  537. dsmod user /? - help for modifying an existing user in the directory.
  538. Directory Service command-line tools help:
  539. dsadd /? - help for adding objects.
  540. dsget /? - help for displaying objects.
  541. dsmod /? - help for modifying objects.
  542. dsmove /? - help for moving objects.
  543. dsquery /? - help for finding objects matching search criteria.
  544. dsrm /? - help for deleting objects.
  545. .
  546. MessageId=10
  547. SymbolicName=USAGE_DSMOD_SITE
  548. Language=English
  549. Descripton: Modifies an existing site in the directory.
  550. Syntax: dsmod site <Name ...>
  551. [-desc <Description>]
  552. [-autotopology {yes | no}]
  553. [-cachegroups {yes | no}]
  554. [-prefGCsite <SiteName>]
  555. [{-s <Server> | -d <Domain>}]
  556. [-u <UserName>]
  557. [-p {<Password> | *}]
  558. [-C]
  559. [-q]
  560. Parameters:
  561. Value Description
  562. <Name ...> Required/stdin. Name of one or more sites to modify.
  563. If target objects are omitted they
  564. will be taken from standard input (stdin)
  565. to support piping of output from another
  566. command to input of this command.
  567. -desc <Description> Sets site description to <Description>.
  568. -autotopology {yes | no}
  569. Sets whether automatic inter-site topology generation
  570. is enabled (yes) or disabled (no).
  571. Default: yes.
  572. -cachegroups {yes | no}
  573. Sets whether caching of group membership for users
  574. to support GC-less logon is enabled (yes)
  575. or not (no).
  576. Default: no.
  577. This setting is supported only on domain controllers
  578. running post-Windows 2000 releases.
  579. -prefGCsite <SiteName> Sets the preferred GC site to <SiteName> if caching
  580. of groups is enabled via the -cachegroups parameter.
  581. This setting is supported only on domain controllers
  582. running post-Windows 2000 releases.
  583. {-s <Server> | -d <Domain>}
  584. -s <Server> connects to the domain controller (DC) with name
  585. <Server>. Default: local system.
  586. -d <Domain> connects to a DC in domain <Domain>.
  587. Default: a DC in the logon domain.
  588. -u <UserName> Connect as <UserName>. Default: the logged in user.
  589. -p <Password> Password for the user <UserName>. If * then prompt for pwd.
  590. -C Continuous operation mode. Reports errors but continues with
  591. next object in argument list when multiple target objects
  592. are specified. Without this option, the command exits
  593. on first error.
  594. -q Quiet mode: suppress all output to standard output.
  595. Remarks:
  596. If a value that you supply contains spaces, use quotation marks
  597. around the text (for example, "CN=John Smith,CN=Users,DC=microsoft,DC=com").
  598. If you enter multiple values, the values must be separated by spaces
  599. (for example, a list of distinguished names).
  600. See also:
  601. dsmod computer /? - help for modifying an existing computer in the directory.
  602. dsmod contact /? - help for modifying an existing contact in the directory.
  603. dsmod group /? - help for modifying an existing group in the directory.
  604. dsmod ou /? - help for modifying an existing ou in the directory.
  605. dsmod server /? - help for modifying an existing domain controller in the directory.
  606. dsmod user /? - help for modifying an existing user in the directory.
  607. Directory Service command-line tools help:
  608. dsadd /? - help for adding objects.
  609. dsget /? - help for displaying objects.
  610. dsmod /? - help for modifying objects.
  611. dsmove /? - help for moving objects.
  612. dsquery /? - help for finding objects matching search criteria.
  613. dsrm /? - help for deleting objects.
  614. .
  615. MessageId=11
  616. SymbolicName=USAGE_DSMOD_SLINK
  617. Language=English
  618. Description: Modifies an existing site link in the directory.
  619. The are two variations of this command.
  620. The first variation allows you to modify the properties
  621. of multiple site links. The second variation allows
  622. you to modify the sites of a single site link.
  623. Syntax: dsmod slink <Name ...>
  624. [-transport {ip | smtp}]
  625. [-cost <Cost>]
  626. [-replint <ReplInterval>]
  627. [-desc <Description>]
  628. [-autobacksync {yes | no}]
  629. [-notify {yes | no}]
  630. [{-s <Server> | -d <Domain>}]
  631. [-u <UserName>]
  632. [-p {<Password> | *}]
  633. [-C]
  634. [-q]
  635. dsmod slink <Name>
  636. <SiteName ...>
  637. {-addsite | -rmsite | -chsite}
  638. [-transport {ip | smtp}]
  639. [{-s <Server> | -d <Domain>}]
  640. [-u <UserName>]
  641. [-p {<Password> | *}]
  642. [-C]
  643. [-q]
  644. Parameters:
  645. Value Description
  646. <Name ...> Required/stdin. Common name (CN) of one
  647. or more site links to modify.
  648. If target objects are omitted they
  649. will be taken from standard input (stdin)
  650. to support piping of output from another
  651. command to input of this command.
  652. -transport {ip | smtp} Sets site link transport type: IP or SMTP. Default: IP.
  653. -cost <Cost> Sets site link cost to the value <Cost>.
  654. -replint <ReplInterval>
  655. Sets replication interval to <ReplInterval>
  656. minutes.
  657. -desc <Description> Sets site link description to <Description>
  658. -autobacksync yes|no Sets if the two-way sync option should be turned
  659. on (yes) or not (no).
  660. -notify yes|no Sets if notification by source on this link should
  661. be turned on (yes) or off (no).
  662. {-addsite | -rmsite | -chsite}
  663. -addsite adds sites to the site link.
  664. -rmsite removes sites from the site link.
  665. -chsite changes (replaces) the complete list of sites
  666. in the site link.
  667. <Name> Required. CN of sitelink to modify.
  668. <SiteName ...> Required/stdin. List of sites to add to,
  669. delete from, and replace in the site link.
  670. If target objects are omitted they
  671. will be taken from standard input (stdin).
  672. {-s <Server> | -d <Domain>}
  673. -s <Server> connects to the domain controller (DC) with name
  674. <Server>. Default: local system.
  675. -d <Domain> connects to a DC in domain <Domain>.
  676. Default: a DC in the logon domain.
  677. -u <UserName> Connect as <UserName>. Default: the logged in user.
  678. -p <Password> Password for the user <UserName>. If * then prompt for pwd.
  679. -C Continuous operation mode. Reports errors but continues with
  680. next object in argument list when multiple target objects
  681. are specified. Without this option, the command exits
  682. on first error.
  683. -q Quiet mode: suppress all output to standard output.
  684. Remarks:
  685. If a value that you supply contains spaces, use quotation marks
  686. around the text (for example, "CN=John Smith,CN=Users,DC=microsoft,DC=com").
  687. If you enter multiple values, the values must be separated by spaces
  688. (for example, a list of distinguished names).
  689. See also:
  690. dsmod computer /? - help for modifying an existing computer in the directory.
  691. dsmod contact /? - help for modifying an existing contact in the directory.
  692. dsmod group /? - help for modifying an existing group in the directory.
  693. dsmod ou /? - help for modifying an existing ou in the directory.
  694. dsmod server /? - help for modifying an existing domain controller in the directory.
  695. dsmod user /? - help for modifying an existing user in the directory.
  696. Directory Service command-line tools help:
  697. dsadd /? - help for adding objects.
  698. dsget /? - help for displaying objects.
  699. dsmod /? - help for modifying objects.
  700. dsmove /? - help for moving objects.
  701. dsquery /? - help for finding objects matching search criteria.
  702. dsrm /? - help for deleting objects.
  703. .
  704. MessageId=13
  705. SymbolicName=USAGE_DSMOD_SLINKBR
  706. Language=English
  707. Description: Modifies an exsting sitelink bridge in the directory.
  708. The are two variations of this command.
  709. The first variation allows you to modify the properties
  710. of multiple site link bridges. The second variation allows
  711. you to modify the site links of a single site link bridge.
  712. Syntax: dsmod slinkbr <Name ...>
  713. [-transport {ip | smtp}]
  714. [-desc <Description>]
  715. [{-s <Server> | -d <Domain>}]
  716. [-u <UserName>]
  717. [-p {<Password> | *}]
  718. [-C]
  719. [-q]
  720. dsmod slinkbr {-addslink | -rmslink | -chslink}
  721. [-transport {ip | smtp}]
  722. <Name>
  723. <SitelinkName ...>
  724. [{-s <Server> | -d <Domain>}]
  725. [-u <UserName>]
  726. [-p {<Password> | *}]
  727. [-C]
  728. [-q]
  729. Parameters:
  730. Value Description
  731. <Name ...> Required/stdin. Common name (CN) of one or more
  732. site link bridges to modify.
  733. If target objects are omitted they
  734. will be taken from standard input (stdin)
  735. to support piping of output from another
  736. command to input of this command.
  737. -transport {ip | smtp} Sets site link transport type: ip or smtp.
  738. Default: ip.
  739. -desc <Description> Sets site link bridge description to <Description>.
  740. {-addsite | -rmsite | -chsite}
  741. -addsite adds site link bridges to the site.
  742. -rmsite removes site link bridges from the site.
  743. -chsite replaces the complete list of
  744. site link bridges at the site.
  745. <Name> CN of site link bridges to modify.
  746. <SiteName ...> Required/stdin. List of site link bridges to add to,
  747. delete from, and replace in the site.
  748. If target objects are omitted they
  749. will be taken from standard input (stdin)
  750. to support piping of output from another
  751. command to input of this command.
  752. {-s <Server> | -d <Domain>}
  753. -s <Server> connects to the domain controller (DC)
  754. with name <Server>. Default: local system.
  755. -d <Domain> connects to a DC in domain <Domain>.
  756. Default: a DC in the logon domain.
  757. -u <UserName> Connect as <UserName>. Default: the logged in user.
  758. -p <Password> Password for the user <UserName>.
  759. If * then prompt for pwd.
  760. -C Continuous operation mode. Reports errors but
  761. continues with next object in argument list
  762. when multiple target objects are specified.
  763. Without this option, the command exits on first error.
  764. -q Quiet mode: suppress all output to standard output.
  765. Remarks:
  766. If a value that you supply contains spaces, use quotation marks
  767. around the text (for example, "CN=John Smith,CN=Users,DC=microsoft,DC=com").
  768. If you enter multiple values, the values must be separated by spaces
  769. (for example, a list of distinguished names).
  770. See also:
  771. dsmod computer /? - help for modifying an existing computer in the directory.
  772. dsmod contact /? - help for modifying an existing contact in the directory.
  773. dsmod group /? - help for modifying an existing group in the directory.
  774. dsmod ou /? - help for modifying an existing ou in the directory.
  775. dsmod server /? - help for modifying an existing domain controller in the directory.
  776. dsmod user /? - help for modifying an existing user in the directory.
  777. Directory Service command-line tools help:
  778. dsadd /? - help for adding objects.
  779. dsget /? - help for displaying objects.
  780. dsmod /? - help for modifying objects.
  781. dsmove /? - help for moving objects.
  782. dsquery /? - help for finding objects matching search criteria.
  783. dsrm /? - help for deleting objects.
  784. .
  785. MessageId=14
  786. SymbolicName=USAGE_DSMOD_CONN
  787. Language=English
  788. Description: Modifies a replication connection for a DC.
  789. Syntax: dsmod conn <ObjectDN ...>
  790. [-transport {rpc | ip | smtp}]
  791. [-enabled {yes | no}]
  792. [-desc <Description>]
  793. [-manual {yes | no}]
  794. [-autobacksync {yes | no}]
  795. [-notify {yes | no | ""}]
  796. [{-s <Server> | -d <Domain>}]
  797. [-u <UserName>]
  798. [-p {<Password> | *}]
  799. [-C]
  800. [-q]
  801. Parameters:
  802. Value Description
  803. <ObjectDN ...> Required/stdin. Distinguished names (DNs)
  804. of one or more connections to modify.
  805. If target objects are omitted they
  806. will be taken from standard input (stdin)
  807. to support piping of output from another
  808. command to input of this command.
  809. -transport {rpc | ip | smtp}
  810. Sets the transport type for this connection:
  811. rpc, ip or smtp. Default: ip.
  812. -enabled {yes | no} Sets whether the connection is enabled (yes)
  813. or not (no).
  814. -desc <Description> Sets the connection description to <Description>.
  815. -manual {yes | no} Sets the connection to manual control (yes) or
  816. automatic directory service control (no).
  817. -autobacksync {yes | no} Sets the two-way sync option on (yes) or not (no).
  818. -notify {yes | no | ""} Sets the notification by source on (yes),
  819. off (no), or to standard practice ("").
  820. Default: "".
  821. {-s <Server> | -d <Domain>}
  822. -s <Server> connects to the domain controller (DC)
  823. with name <Server>. Default: local system.
  824. -d <Domain> connects to a DC in domain <Domain>.
  825. Default: a DC in the logon domain.
  826. -u <UserName> Connect as <UserName>. Default: the logged in user.
  827. -p <Password> Password for the user <UserName>.
  828. If * then prompt for pwd.
  829. -C Continuous operation mode. Reports errors but
  830. continues with next object in argument list
  831. when multiple target objects are specified.
  832. Without this option, the command exits on first error.
  833. -q Quiet mode: suppress all output to standard output.
  834. Remarks:
  835. If a value that you supply contains spaces, use quotation marks
  836. around the text (for example, "CN=John Smith,CN=Users,DC=microsoft,DC=com").
  837. If you enter multiple values, the values must be separated by spaces
  838. (for example, a list of distinguished names).
  839. See also:
  840. dsmod computer /? - help for modifying an existing computer in the directory.
  841. dsmod contact /? - help for modifying an existing contact in the directory.
  842. dsmod group /? - help for modifying an existing group in the directory.
  843. dsmod ou /? - help for modifying an existing ou in the directory.
  844. dsmod server /? - help for modifying an existing domain controller in the directory.
  845. dsmod user /? - help for modifying an existing user in the directory.
  846. Directory Service command-line tools help:
  847. dsadd /? - help for adding objects.
  848. dsget /? - help for displaying objects.
  849. dsmod /? - help for modifying objects.
  850. dsmove /? - help for moving objects.
  851. dsquery /? - help for finding objects matching search criteria.
  852. dsrm /? - help for deleting objects.
  853. .
  854. MessageId=15
  855. SymbolicName=USAGE_DSMOD_SERVER
  856. Language=English
  857. Description: Modifies properties of a domain controller.
  858. Syntax: dsmod server <ObjectDN ...>
  859. [-desc <Description>]
  860. [-isgc {yes | no}]
  861. [{-s <Server> | -d <Domain>}]
  862. [-u <UserName>]
  863. [-p {<Password> | *}]
  864. [-C]
  865. [-q]
  866. Parameters:
  867. Value Description
  868. <ObjectDN ...> Required/stdin. Distinguished names (DNs)
  869. of one or more servers to modify.
  870. If target objects are omitted they
  871. will be taken from standard input (stdin)
  872. to support piping of output from another
  873. command to input of this command.
  874. -desc <Description>
  875. Sets server description to <Description>.
  876. -isgc {yes | no} Sets whether this server to a global catalog server
  877. (yes) or disables it (no).
  878. {-s <Server> | -d <Domain>}
  879. -s <Server> connects to the domain controller (DC)
  880. with name <Server>. Default: local system.
  881. -d <Domain> connects to a DC in domain <Domain>.
  882. Default: a DC in the logon domain.
  883. -u <UserName> Connect as <UserName>. Default: the logged in user.
  884. -p <Password> Password for the user <UserName>.
  885. If * then prompt for pwd.
  886. -C Continuous operation mode. Reports errors but
  887. continues with next object in argument list
  888. when multiple target objects are specified.
  889. Without this option, the command exits on first error.
  890. -q Quiet mode: suppress all output to standard output.
  891. Remarks:
  892. If a value that you supply contains spaces, use quotation marks
  893. around the text (for example, "CN=My Server,CN=Servers,CN=Site10,
  894. CN=Sites,CN=Configuration,DC=microsoft,DC=com").
  895. If you enter multiple values, the values must be separated by spaces
  896. (for example, a list of distinguished names).
  897. Examples:
  898. To enable the domain controllers CORPDC1 and CORPDC9 to become global catalog servers:
  899. dsmod server "cn=CORPDC1,cn=Servers,cn=site1,cn=sites,cn=configuration,dc=microsoft,dc=com" "cn=CORPDC9,cn=Servers,cn=site2,cn=sites,cn=configuration,dc=microsoft,dc=com" -isgc yes
  900. See also:
  901. dsmod computer /? - help for modifying an existing computer in the directory.
  902. dsmod contact /? - help for modifying an existing contact in the directory.
  903. dsmod group /? - help for modifying an existing group in the directory.
  904. dsmod ou /? - help for modifying an existing ou in the directory.
  905. dsmod server /? - help for modifying an existing domain controller in the directory.
  906. dsmod user /? - help for modifying an existing user in the directory.
  907. Directory Service command-line tools help:
  908. dsadd /? - help for adding objects.
  909. dsget /? - help for displaying objects.
  910. dsmod /? - help for modifying objects.
  911. dsmove /? - help for moving objects.
  912. dsquery /? - help for finding objects matching search criteria.
  913. dsrm /? - help for deleting objects.
  914. .
  915.