概述
当我们部署一套全新的Azure DevOps Server服务器,如果在企业中之前没有应用Active Directory(简称AD,活动目录)作为认证服务器,就需要在AD服务器上为每个用户新建登录账户。新建账户的过程比较简单,参考我之前分享的文档就可以快速为每个用户在AD用户管理控制台上账户;但是,手工创建账户的过程比较繁琐,如果需要创建成百上千的账户,这个工作就会变成管理员的加班工作的噩梦;并且,由于是手工操作,不可避免的导致错误,带来后续潜在的问题。
为了解决创建多个账户的问题,本文介绍使用脚本的方式,批量创建AD账户的方法。使用批量创建AD账户的方法,可以一键创建成百上千的账户,还可以避免创建账户过程中的误操作,是一个事半功倍的方法。
操作方法
- 首先,我们需要收集用户信息。
- 例如在本文的示例中,在创建AD域账户过程中,需要保存下面的几个关键信息:姓名、 部门、 账户、 电话、 邮箱、 密码。
- 我们将收集到的用户信息保存在Excel中,然后将其另存为csv文件,并将其保存在AD服务器的磁盘中,例如本文的示例中我存在AD服务器的C:\temp\create-users.csv。
- 特别注意,csv文档的编码格式需要为ANSI,不要使用默认的UTF-8,如下图所示:
图一:用户示例
图二:保持为csv文件
创建AD组织单元
在AD服务器的“用户和计算机”控制台中,创建号用户所在的组织单元(Ognization Unit,简称OU),如下图:
图三:Active Directory 用户和计算机控制台
编写创建账户的脚本
在AD服务器中,除了可以使用控制台手动创建用账户,还可以使用"dsadd user“工具在命令行窗口中创建账户。
我们在结合bat脚本,就可以编写一个批量创建账户的小程序,程序示例如下:
for /f "tokens=1,2,3,4,5,6 delims=," %a in (C:\temp\users.csv)
do dsadd user
"cn=%a,ou=%b,ou=北京宏软,dc=ads,dc=local"
-samid %c -upn %c@ads.local
-ln %a -tel %d -email %e -display %a -pwd %f
-mustchpwd no -pwdneverexpires yes -disabled no
注意,上面的脚本中,不能有换行回车。
在AD服务器上,使用管理员身份打开命令行窗口,并允许上面的命令,就会自动创建好所有的用户账户,如下图:
当批量创建好域账户后,我们就可以在Azure DevOps Server中使用这些账户,例如赋予用户权限,如下图:
对于不太熟悉bat脚本的同学,我在这里解释一下上面的脚本含义:
-
For /f "tokens=1,2,3,4,5,6 delims=,"
- “tokens=1,2,3,4,5,6” 这段是声明这里有6个变量。分别是%a,%b,%c,%d,%e,%f。分别对应EXCEL表格A,B,C,D,E,F列。
- ”Delims=,”表示分隔符是“,”号。
%a in (C:\temp\users.csv)
这段是表示全部变量的来源。这里就是指变量都是来源于之前保存在C盘的EXCEL的 CSV文件。do dsadd user
这个是添加创建用户命令。"cn=%a,ou=%b,ou=北京宏软,dc=ads,dc=local"
cn表示显示的名称,ou表示创建组织单元的路径。
假设我的OU路径比较深,则我们要把除最后一级OU之前的OU写在执行的命令中。
ou写法:1级ou写在最后面,2级ou写在1级前面,3级写在2级前......依次类推,用逗号隔开。最后的一级OU目录是写在.cvs的文件中的OU。-samid %c -upn %c@ads.local
这句是指所要用户的名称和upn后缀。这个upn的后缀最好和用户名在一块,因为每个用户名不会一样。-
-ln %a -tel %d -email %e -display %a -pwd %f
- ln,是指用户的姓
- tel,电话号码
- display,显示名称
- pwd,密码
mustchpwd no
这个是“首次登录是否修改密码” ,yes是开启,no是关闭。pwdneverexpires yes
这个是“密码永不过期” ,yes是开启 ,no是关闭。disabled no
这个是用户创建之后是不是禁用状态,yes是禁用,no是不禁用。
另外,对于dsadd user工具的参加,下面做一个比较完善的说明
dsadd命令的可使用参数释议:
- UserDN:必需。指定要添加的用户的可分辨名称。如果省略可分辨名称,则将从标准输入 (stdin) 中获取该名称。
- samid SAMName:指定 SAM 名称作为该用户的唯一 SAM 帐户名(例如,Linda)。如果未指定,dsadd 将尝试使用 UserDN 的公用名 (CN) 值的至多前 20 个字符创建 SAM 帐户名。
- upn UPN:指定要添加的用户的用户主体名称(例如,Linda@SZHIT.CLOUD.COM)。
- fn FirstName:指定要添加的用户的名字。
- mi Initial:指定要添加的用户的中间名首字母。
- ln LastName:指定要添加的用户的姓氏。
- display DisplayName:指定要添加的用户的显示名。
- empid EmployeeID:指定要添加的用户的雇员 ID。
- pwd {Password | *}:指定将用户密码设置为 Password 或 *。如果设置为 *,将提示您输入用户密码。
- desc Description:指定要添加的用户的描述。
- memberof GroupDN ...:指定希望用户加入的组的可分辨名称。
- office Office:指定要添加的用户的办公室位置。
- tel PhoneNumber:指定要添加的用户的电话号码。
- email Email:指定要添加的用户的电子邮件地址。
- hometel HomePhoneNumber:指定要添加的用户的家庭电话号码。
- pager PagerNumber:指定要添加的用户的寻呼机号码。
- mobile CellPhoneNumber:指定要添加的用户的移动电话号码。
- fax FaxNumber:指定要添加的用户的传真号码。
- iptel IPPhoneNumber:指定要添加的用户的 IP 电话号码。
- webpg WebPage:指定要添加的用户的 Web 页的 URL。
- title Title:指定要添加的用户的称谓。
- dept Department:指定要添加的用户的部门。
- company Company:指定要添加的用户的公司信息。
- mgr ManagerDN:指定要添加的用户的管理器的可分辨名称。
- hmdir HomeDirectory:指定要添加的用户的主目录位置。如果 HomeDirectory 是作为通用命名约定 (UNC) 路径给出,则必须使用 -hmdrv 参数指定要映射到此路径的驱动器号。
- hmdrv DriveLetter::指定要添加的用户的主目录驱动器号(例如,E:)。
- profile ProfilePath:指定要添加的用户的配置文件路径。
- loscr ScriptPath:指定要添加的用户的登录脚本路径。
- mustchpwd {yes | no}:指定用户是否必须在下次登录时更改其密码(yes 必须更改,no 不必更改)。默认情况下,用户不必更改密码 (no)。
- canchpwd {yes | no}:指定用户是否可以更改其密码(yes 可以更改,no 根本不能更改)。默认情况下,允许用户更改密码 (yes)。如果 -mustchpwd 参数的值为 yes,则该参数的值必须为 yes。
- reversiblepwd {yes | no}:指定是否应使用可逆加密来存储用户密码(yes 表示应该,no 表示不应该)。默认情况下,用户不能使用可逆加密 (no)。
- pwdneverexpires {yes | no}
指定用户密码是否永不过期(yes 表示是,no 表示不是)。默认情况下,用户密码会过期 (no)。 - acctexpires NumberOfDays
指定从今天算起用户帐户将到期的天数。0 值表示将今天的结束时间设置为到期时间。正值表示将将来的时间设置为到期时间。负值表示将以前的时间设置为到期时间。值 never 将帐户设置为永不过期。例如,0 值表示该帐户在今天结束时过期。值 -5 表示该帐户 5 天前就已经到期,并将以前的时间设置为到期日期。值 5 表示该帐户将在 5 天后到期。 - disabled {yes | no}
指定是否禁用用户帐户登录(yes 禁用登录,no 允许登录)。默认情况下,启用用户帐户登录 (no)。
{-s Server | -d Domain}
连接到指定的远程服务器或域。默认情况下,计算机与登录域中的域控制器相连接。 - u UserName:
指定用户要用于登录到远程服务器的用户名。默认情况下,-u 使用用户登录时的用户名。您可以使用下列任一格式指定用户名:
用户名(例如 Linda)
域\用户名(例如 SZHIT\Linda)
用户主体名称 (UPN)(例如 Linda@SZHIT.CLOUD.COM) - p {Password | *}:指定使用密码或 * 登录到远程服务器。如果键入 *,将提示您输入密码。
- q:将所有输出降低为标准输出(安静模式)。
如果需要,你还可以从微软Azure DevOps Server 的在线文档,查询更多的权威资料,也欢迎通过下面的联系方式与我沟通,相互学习,相互提高!
https://www.cnblogs.com/danzhang
Azure DevOps MVP 张洪君