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