1# acm工具 2 3<!--Kit: Basic Services Kit--> 4<!--Subsystem: Account--> 5<!--Owner: @steven-q--> 6<!--Designer: @JiDong-CS1--> 7<!--Tester: @zhaimengchao--> 8<!--Adviser: @zengyawen--> 9 10Account Manager（账号管理工具，简称acm）是实现账号创建、删除、查询等功能的工具，acm为开发者提供基本的管理本地账号的能力，例如：创建账号、删除账号等。 11 12> **说明：** 13> 14> 在使用本工具前，开发者需要先获取[hdc工具](../dfx/hdc.md)，执行hdc shell。 15 16 17**acm工具命令列表** 18 19| 命令 | 描述 | 20| -------- | -------- | 21| help | 帮助命令，用于显示acm支持的命令信息。 | 22| create | 创建命令，用于创建账号。注：需要root之后才能使用该命令。 | 23| delete | 删除命令，用于删除账号。注：需要root之后才能使用该命令。 | 24| dump | 查询命令，用于查询账号的相关信息。注：需要root之后才能使用该命令。 | 25| switch | 切换命令，用于切换账号。注：需要root之后才能使用该命令。 | 26| deactivate | 注销命令，用于注销账号。注：需要root之后才能使用该命令。 | 27| set | 设置约束命令，用于设置账号的约束。注：需要root之后才能使用该命令。 | 28 29 30## help 31 32**使用方法：** 33 34```bash 35acm help 36``` 37 38**显示信息** 39 40显示acm相关的帮助信息。 41 42 43## create 44 45**使用方法：** 46 47```bash 48# 显示帮助命令 49acm create -h 50# 创建一个指定名字与类型的账号 51acm create -n <accountName> -t <accountType> [-s <shortName>] [-d <disallowed-pre-install-hap-bundles>] [-p <allowed-pre-install-hap-bundles>] 52``` 53 54**显示信息** 55 56当账号创建成功时，显示"create the local account successfully."；当创建失败时，显示相应的失败信息。 57 58**创建命令参数列表** 59 60| 参数 | 描述 | 61| ----------------------------------- | -------------------------- | 62| -h | 可选参数。显示create支持的命令信息。 | 63| -n | 必选参数。指定新账号的名字。 | 64| -t | 必选参数。指定新账号的账号类型。账号类型分为admin（管理员账号）、normal（普通账号）、guest（访客账号）、private（隐私账号）。 | 65| -s | 可选参数。指定新账号的短名。 | 66| -d | 可选参数。指定新账号被禁止的预置应用列表。 | 67| -p | 可选参数。指定新账号被允许的预置应用列表。 | 68 69 70## delete 71 72**使用方法：** 73 74```bash 75# 显示帮助命令 76acm delete -h 77# 删除指定id的账号 78acm delete -i <accountId> 79``` 80 81**显示信息** 82 83当删除账号成功时，显示"delete the local account successfully."；当删除失败时，显示相应的失败信息。 84 85**删除命令参数列表** 86 87| 参数 | 描述 | 88| ----------------------------------- | -------------------------- | 89| -h | 可选参数。显示delete支持的命令信息。 | 90| -i | 必选参数。指定将要删除的账号id。 | 91 92 93## dump 94 95**使用方法：** 96 97```bash 98# 显示帮助命令 99acm dump -h 100# 查询所有账号的信息 101acm dump -a 102# 查询指定账号id的账号信息 103acm dump -i <accountId> 104``` 105 106**显示信息** 107 108当查询成功时，显示相应的账号信息；当查询失败时，显示相应的失败信息。 109 110**查询命令参数列表** 111 112| 参数 | 描述 | 113| ----------------------------------- | -------------------------- | 114| -h | 可选参数。显示dump支持的命令信息。 | 115| -a | 必选参数。表示查询所有账号的账号信息。 | 116| -i | 必选参数。指定账号id，用于查询相应id的账号信息。 | 117 118 119## switch 120 121**使用方法：** 122 123```bash 124# 显示帮助命令 125acm switch -h 126# 切换到指定id的账号 127acm switch -i <accountId> 128``` 129 130**显示信息** 131 132当切换账号成功时，显示"switch the local account successfully."；当切换失败时，显示相应的失败信息。 133 134**切换命令参数列表** 135 136| 参数 | 描述 | 137| ----------------------------------- | -------------------------- | 138| -h | 可选参数。显示switch支持的命令信息。 | 139| -i | 必选参数。指定要切换到的账号的账号id。 | 140 141 142## deactivate 143 144**使用方法：** 145 146```bash 147# 显示帮助命令 148acm deactivate -h 149# 注销所有账号 150acm deactivate -a 151# 注销指定账号id的账号 152acm deactivate -i <accountId> 153``` 154 155**显示信息** 156 157当注销账号成功时，显示"deactivate the local account successfully."；当注销失败时，显示相应的失败信息。 158 159**注销命令参数列表** 160 161| 参数 | 描述 | 162| ----------------------------------- | -------------------------- | 163| -h | 可选参数。显示deactivate支持的命令信息。 | 164| -a | 必选参数。表示注销所有账号。 | 165| -i | 必选参数。指定账号id，用于注销相应id的账号。 | 166 167 168## set 169 170**使用方法：** 171 172```bash 173# 显示帮助命令 174acm set -h 175# 设置指定id的账号的约束 176acm set -i <accountId> -c <constraints> [-e] 177``` 178 179**显示信息** 180 181当约束设置成功时，显示"set constraints for the local account successfully."；当设置失败时，显示相应的失败信息。 182 183**设置约束命令参数列表** 184 185| 参数 | 描述 | 186| ----------------------------------- | -------------------------- | 187| -h | 可选参数。显示set支持的命令信息。 | 188| -i | 必选参数。指定账号id。 | 189| -c | 必选参数。指定要设置的约束集合，集合中每个约束用','分隔。查看约束的详细信息请查询[账号约束列表](../reference/apis-basic-services-kit/js-apis-osAccount.md#系统账号约束列表)。 | 190| -e | 可选参数。(加上/不加上)该选项表示(添加/删除)约束。 | 191