EDM

Enterprise Device Manager (edm) provides debugging and testing capabilities for device management applications. For example, it can be used to enable or disable extended enterprise device management capabilities.

Environment Setup

Before using this tool, you must obtain the hdc tool and run the hdc shell command.

edm Commands

help Command

# Display the help information.
edm help

enable-admin Command

# Display the help information.
edm enable-admin -h
# Enable the extended enterprise device management capabilities.
edm enable-admin -n <bundleName> -a <abilityName> [-t <adminType>]

Parameters in the enable-admin command

Example

# Enable the EnterpriseAdminExtensionAbility whose bundle name is com.example.mdmsample and class name is EnterpriseAdminAbility.
edm enable-admin -n com.example.mdmsample -a com.example.mdmsample.EnterpriseAdminAbility
# Execution result.
enable-admin success.

disable-admin Command

# Display the help information.
edm disable-admin -h
# Disable the extended enterprise device management capabilities.
edm disable-admin -n <bundleName>

Parameters in the disable-admin command

Example

# Disable the EnterpriseAdminExtensionAbility whose bundle name is com.example.mdmsample.
edm disable-admin -n com.example.mdmsample
# Execution result.
disable-admin success.

Error Messages

error: command requires option

Symptom

bundleName and abilityName are not passed in.

Possible Causes

bundleName and abilityName are not passed in.

Solution

1. If the enable-admin command is used, add the -n <bundle-name> and -a <ability-name> parameters.

2. If the disable-admin command is used, add the -n <bundle-name> parameter.

error: -n, –bundle-name option requires an argument

Symptom

The input value of bundleName is empty.

Possible Causes

The input value of bundleName is empty.

Solution

Check the parameters following -n and add bundleName.

error: -a, –ability-name option requires an argument

Symptom

The input value of abilityName is empty.

Possible Causes

The input value of abilityName is empty.

Solution

Check the parameters following -a and add abilityName.

error: unknown option

Symptom

An unknown parameter is passed in.

Possible Causes

An unknown parameter is passed in.

Solution

Check whether the parameter is in the parameter list.

error: -n <bundle-name> is expected

Symptom

bundleName is not passed in.

Possible Causes

bundleName is not passed in.

Solution

Add -n <bundle-name> to the command.

error: -a <ability-name> is expected

Symptom

abilityName is not passed in.

Possible Causes

abilityName is not passed in.

Solution

Add -a <ability-name> to the command.

error: the administrator ability component is invalid

Symptom

The input value of bundleName or abilityName is incorrect, or the component is not an EnterpriseAdminExtensionAbility.

Possible Causes

1. The bundleName is incorrect.

2. The input abilityName is incorrect.

3. The component is not an EnterpriseAdminExtensionAbility.

Solution

Obtain the bundleName of the application and the abilityName of the EnterpriseAdminExtensionAbility, and pass them to the parameter.

error: failed to enable the administrator application of the device

Symptom

The component fails to be enabled.

Possible Causes

1. The bundleName is incorrect.

2. The component is not an EnterpriseAdminExtensionAbility.

3. An activated EnterpriseAdminExtensionAbility exists.

Solution

1. Obtain the bundleName of the application and the abilityName of the EnterpriseAdminExtensionAbility, and pass them to the parameter.

2. Use an uncontrolled device for debugging.

error: failed to disable the administrator application of the device

Symptom

The component fails to be disabled.

Possible Causes

1. The component is not activated.

2. The component is not activated by running the hdc command.

3. The deactivation fails.

Solution

Obtain the bundleName of the application that can be deactivated by the hdc command and pass the bundleName to the parameter.

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Debugging Tools

harmony 鸿蒙Ability Assistant

harmony 鸿蒙Account Manager

harmony 鸿蒙Advanced Notification Manager

harmony 鸿蒙App Check Tool

harmony 鸿蒙Access Token Manager

harmony 鸿蒙Bundle Manager

harmony 鸿蒙Common Event Manager

harmony 鸿蒙devicedebug

harmony 鸿蒙LLDB