企业设备管理


企业设备管理

icon-note.gif 说明: 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

导入模块

import enterpriseDeviceManager from '@ohos.enterpriseDeviceManager';
1

enterpriseDeviceManager.activateAdmin

activateAdmin(admin: Want, enterpriseInfo: EnterpriseInfo, type: AdminType, callback: AsyncCallback<boolean>): void

以异步方法根据给定的包名和类名激活设备管理员应用,使用Callback形式返回是否激活成功。

需要权限: ohos.permission.MANAGE_ADMIN

系统能力: SystemCapability.Customation.EnterpriseDeviceManager

参数

参数名 类型 必填 说明
admin Want 设备管理员应用
enterpriseInfo EnterpriseInfo 设备管理员应用的企业信息
type AdminType 激活的设备管理员类型
callback AsyncCallback<boolean> callback方式返回是否激活成功

示例

let wantTemp = {
	bundleName: "com.example.myapplication",
	abilityName: "com.example.myapplication.MainAbility",
};
let enterpriseInfo = {
	name: "enterprise name",
	description: "enterprise description"
}
enterpriseDeviceManager.activateAdmin(wantTemp, enterpriseInfo, enterpriseDeviceManager.AdminType.ADMIN_TYPE_NORMAL, (error, result) => {
    if (error != null) {
        console.log("error occurs" + error);
        return; 
    }
    console.log(result);
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

enterpriseDeviceManager.activateAdmin

activateAdmin(admin: Want, enterpriseInfo: EnterpriseInfo, type: AdminType): Promise<boolean>

以异步方法根据给定的包名和类名激活设备管理员应用,使用Promise形式返回是否激活成功。

需要权限: ohos.permission.MANAGE_ADMIN

系统能力: SystemCapability.Customation.EnterpriseDeviceManager

参数

参数名 类型 必填 说明
admin Want 设备管理员应用
enterpriseInfo EnterpriseInfo 设备管理员应用的企业信息
type AdminType 激活的设备管理员类型

返回值:

类型 说明
Promise<boolean> Promise形式返回是否激活成功

示例

let wantTemp = {
	bundleName: "com.example.myapplication",
	abilityName: "com.example.myapplication.MainAbility",
};
let enterpriseInfo = {
	name: "enterprise name",
	description: "enterprise description"
}
enterpriseDeviceManager.activateAdmin(wantTemp, enterpriseInfo, enterpriseDeviceManager.AdminType.ADMIN_TYPE_NORMAL)
.then((result) => {
	console.log(result);
}).catch(error => {
	console.log("error occurs" + error);
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14

enterpriseDeviceManager.deactivateAdmin

deactivateAdmin(admin: Want, callback: AsyncCallback<boolean>): void

以异步方法根据给定的包名和类名将设备普通管理员应用去激活,使用Callback形式返回是否去激活成功。

需要权限: ohos.permission.MANAGE_ADMIN

系统能力: SystemCapability.Customation.EnterpriseDeviceManager

参数

参数名 类型 必填 说明
admin Want 普通设备管理员应用
callback AsyncCallback<boolean> callback方式返回是否去激活成功

示例

let wantTemp = {
	bundleName: elementName.bundleName,
	abilityName: elementName.abilityName,
};
enterpriseDeviceManager.deactivateAdmin(wantTemp, (error, result) => {
    if (error != null) {
        console.log("error occurs" + error);
        return; 
    }
    console.log(result);
});
1
2
3
4
5
6
7
8
9
10
11

enterpriseDeviceManager.deactivateAdmin

deactivateAdmin(admin: Want): Promise<boolean>

以异步方法根据给定的包名和类名将设备普通管理员应用去激活,使用Promise形式返回是否去激活成功。

需要权限: ohos.permission.MANAGE_ADMIN

系统能力: SystemCapability.Customation.EnterpriseDeviceManager

参数

参数名 类型 必填 说明
admin Want 普通设备管理员应用

返回值:

类型 说明
Promise<boolean> Promise形式返回是否激活成功

示例

let wantTemp = {
	bundleName: "bundleName",
	abilityName: "abilityName",
};
enterpriseDeviceManager.deactivateAdmin(wantTemp).then((result) => {
	console.log(result);
}).catch(error => {
	console.log("error occurs" + error);
});
1
2
3
4
5
6
7
8
9

enterpriseDeviceManager.deactivateSuperAdmin

deactivateSuperAdmin(bundleName: String, callback: AsyncCallback<boolean>): void

以异步方法根据给定的包名将设备超级管理员应用去激活,使用Callback形式返回是否去激活成功。

系统能力: SystemCapability.Customation.EnterpriseDeviceManager

参数

参数名 类型 必填 说明
bundleName String 超级设备管理员应用的包名
callback AsyncCallback<boolean> callback方式返回是否去激活成功

示例

let bundleName = "com.example.myapplication";
enterpriseDeviceManager.deactivateSuperAdmin(bundleName, (error, result) => {
    if (error != null) {
        console.log("error occurs" + error);
        return; 
    }
    console.log(result);
});
1
2
3
4
5
6
7
8

enterpriseDeviceManager.deactivateSuperAdmin

deactivateSuperAdmin(bundleName: String): Promise<boolean>

以异步方法根据给定的包名将设备超级管理员应用去激活,使用Promise形式返回是否去激活成功。

系统能力: SystemCapability.Customation.EnterpriseDeviceManager

参数

参数名 类型 必填 说明
bundleName String 超级设备管理员应用的包名

返回值:

类型 说明
Promise<boolean> Promise形式返回是否激活成功

示例

let bundleName = "com.example.myapplication";
enterpriseDeviceManager.deactivateSuperAdmin(bundleName).then((result) => {
	console.log(result);
}).catch(error => {
	console.log("error occurs" + error);
});
1
2
3
4
5
6

enterpriseDeviceManager.isAdminAppActive

isAdminAppActive(admin: Want, callback: AsyncCallback<boolean>): void

以异步方法根据给定的包名和类名判断设备管理员应用是否被激活,使用Callback形式返回是否处于激活状态。

系统能力: SystemCapability.Customation.EnterpriseDeviceManager

参数

参数名 类型 必填 说明
admin Want 设备管理员应用
callback AsyncCallback<boolean> callback方式返回是否处于激活状态

示例

let wantTemp = {
	bundleName: elementName.bundleName,
	abilityName: elementName.abilityName,
};
enterpriseDeviceManager.isAdminAppActive(wantTemp, (error, result) => {
    if (error != null) {
        console.log("error occurs" + error);
        return; 
    }
    console.log(result);
});
1
2
3
4
5
6
7
8
9
10
11

enterpriseDeviceManager.isAdminAppActive

isAdminAppActive(admin: Want): Promise<boolean>

以异步方法根据给定的包名和类名判断设备管理员应用是否被激活,使用Promise形式返回是否处于激活状态。

系统能力: SystemCapability.Customation.EnterpriseDeviceManager

参数

参数名 类型 必填 说明
admin Want 设备管理员应用

返回值:

类型 说明
Promise<boolean> Promise形式返回是否处于激活状态

示例

let wantTemp = {
	bundleName: "bundleName",
	abilityName: "abilityName",
};
enterpriseDeviceManager.isAdminAppActive(wantTemp).then((result) => {
	console.log(result);
}).catch(error => {
	console.log("error occurs" + error);
});
1
2
3
4
5
6
7
8
9

enterpriseDeviceManager.isSuperAdmin

isSuperAdmin(bundleName: String, callback: AsyncCallback<boolean>): void

以异步方法根据给定的包名判断设备超级管理员应用是否被激活,使用Callback形式返回是否处于激活状态。

系统能力: SystemCapability.Customation.EnterpriseDeviceManager

参数

参数名 类型 必填 说明
bundleName String 设备管理员应用
callback AsyncCallback<boolean> callback方式返回是否处于激活状态

示例

let bundleName = "com.example.myapplication";
enterpriseDeviceManager.isSuperAdmin(bundleName, (error, result) => {
    if (error != null) {
        console.log("error occurs" + error);
        return; 
    }
    console.log(result);
});
1
2
3
4
5
6
7
8

enterpriseDeviceManager.isSuperAdmin

isSuperAdmin(bundleName: String): Promise<boolean>

以异步方法根据给定的包名判断设备超级管理员应用是否被激活,使用Promise形式返回是否处于激活状态。

系统能力: SystemCapability.Customation.EnterpriseDeviceManager

参数

参数名 类型 必填 说明
bundleName String 超级设备管理员应用

返回值:

类型 说明
Promise<boolean> Promise形式返回是否处于激活状态

示例

let bundleName = "com.example.myapplication";
enterpriseDeviceManager.isSuperAdmin(bundleName).then((result) => {
	console.log(result);
}).catch(error => {
	console.log("error occurs" + error);
});
1
2
3
4
5
6

enterpriseDeviceManager.getDeviceSettingsManager

getDeviceSettingsManager(callback: AsyncCallback<DeviceSettingsManager>): void

获取DeviceSettingsManager对象,使用callback形式返回DeviceSettingsManager对象。

系统能力: SystemCapability.Customation.EnterpriseDeviceManager

参数:

参数名 类型 必填 说明
callback AsyncCallback<DeviceSettingsManager> callback方式返回DeviceSettingsManager对象

示例:

let wantTemp = {
	bundleName: "bundleName",
	abilityName: "abilityName",
};
enterpriseDeviceManager.getDeviceSettingsManager((error, mgr) => {
    if (error != null) {
        console.log("error occurs" + error);
        return; 
    }
    mgr.setDateTime(wantTemp, 1526003846000, (error, value) => { 
        if (error != null) {
            console.log(error);
        } else {
            console.log(value);
        }
    });
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

enterpriseDeviceManager.getDeviceSettingsManager

getDeviceSettingsManager(): Promise<DeviceSettingsManager>

获取DeviceSettingsManager对象,使用Promise形式返回DeviceSettingsManager对象。

系统能力: SystemCapability.Customation.EnterpriseDeviceManager

返回值:

类型 说明
Promise<DeviceSettingsManager> Promise方式返回DeviceSettingsManager对象

示例:

let wantTemp = {
	bundleName: "bundleName",
	abilityName: "abilityName",
};
mgr.getDeviceSettingsManager().then((mgr) => {
    mgr.setDateTime(wantTemp, 1526003846000).then((value) => {
        console.log(value);
    }).catch((error) => {
        console.log(error);
    })
}).catch((error) => {
    console.log(error);
})
1
2
3
4
5
6
7
8
9
10
11
12
13

enterpriseDeviceManager.setEnterpriseInfo

setEnterpriseInfo(admin: Want, enterpriseInfo: EnterpriseInfo, callback: AsyncCallback<boolean>): void

设置设备管理员应用的企业信息,使用callback形式返回是否设置成功。

系统能力: SystemCapability.Customation.EnterpriseDeviceManager

参数:

参数名 类型 必填 说明
admin Want 设备管理员应用
enterpriseInfo EnterpriseInfo 设备管理员应用的企业信息
callback AsyncCallback<boolean> callback方式返回是否设置企业信息成功

示例:

let wantTemp = {
	bundleName: "com.example.myapplication",
	abilityName: "com.example.myapplication.MainAbility",
};
let enterpriseInfo = {
	name: "enterprise name",
	description: "enterprise description"
}
enterpriseDeviceManager.setEnterpriseInfo(wantTemp, enterpriseInfo)
.then((result) => {
	console.log(result);
}).catch(error => {
	console.log("error occurs" + error);
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14

enterpriseDeviceManager.setEnterpriseInfo

setEnterpriseInfo(admin: Want, enterpriseInfo: EnterpriseInfo): Promise<boolean>

设置设备管理员应用的企业信息,使用Promise形式返回是否设置成功。

系统能力: SystemCapability.Customation.EnterpriseDeviceManager

参数:

参数名 类型 必填 说明
admin Want 设备管理员应用
enterpriseInfo EnterpriseInfo 设备管理员应用的企业信息

返回值:

类型 说明
Promise<boolean>; Promise方式返回是否设置企业信息成功

示例:

let wantTemp = {
	bundleName: "com.example.myapplication",
	abilityName: "com.example.myapplication.MainAbility",
};
let enterpriseInfo = {
	name: "enterprise name",
	description: "enterprise description"
}
enterpriseDeviceManager.setEnterpriseInfo(wantTemp, enterpriseInfo)
.then((result) => {
	console.log(result);
}).catch(error => {
	console.log("error occurs" + error);
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14

enterpriseDeviceManager.getEnterpriseInfo

getEnterpriseInfo(admin: Want, callback: AsyncCallback<EnterpriseInfo>): void

获取设备管理员应用的企业信息,使用callback形式返回设备管理员应用的企业信息。

系统能力: SystemCapability.Customation.EnterpriseDeviceManager

参数:

参数名 类型 必填 说明
admin Want 设备管理员应用
callback AsyncCallback<EnterpriseInfo> callback方式返回设备管理员应用的企业信息

示例:

let wantTemp = {
	bundleName: "com.example.myapplication",
	abilityName: "com.example.myapplication.MainAbility",
};
enterpriseDeviceManager.getEnterpriseInfo(wantTemp, (error, result) => {
    if (error != null) {
        console.log("error occurs" + error);
        return; 
    }
    console.log(result.name);
	console.log(result.description);
});
1
2
3
4
5
6
7
8
9
10
11
12

enterpriseDeviceManager.getEnterpriseInfo

getDeviceSettingsManager(admin: Want): Promise<EnterpriseInfo>

获取设备管理员应用的企业信息,使用Promise形式返回设备管理员应用的企业信息。

系统能力: SystemCapability.Customation.EnterpriseDeviceManager

参数:

参数名 类型 必填 说明
admin Want 设备管理员应用

返回值:

类型 说明
Promise<EnterpriseInfo> Promise方式返回设备管理员应用的企业信息对象

示例:

let wantTemp = {
	bundleName: "com.example.myapplication",
	abilityName: "com.example.myapplication.MainAbility",
};
enterpriseDeviceManager.getEnterpriseInfo(wantTemp).then((result) => {
	console.log(result.name);
	console.log(result.description);
}).catch(error => {
	console.log("error occurs" + error);
});
1
2
3
4
5
6
7
8
9
10

EnterpriseInfo

设备管理员应用的企业信息

系统能力: 以下各项对应系统能力均为SystemCapability.Customation.EnterpriseDeviceManager

名称 读写属性 类型 必填 描述
name 只读 string 表示设备管理员应用所属企业的名称。
description 只读 string 表示设备管理员应用所属企业的描述。

AdminType

设备管理员应用的管理员类型。

系统能力: 以下各项对应系统能力均为SystemCapability.Customation.EnterpriseDeviceManager

名称 默认值 说明
ADMIN_TYPE_NORMAL 0x00 普通管理员
ADMIN_TYPE_SUPER 0x01 超级管理员