@ohos.enterprise.systemManager (系统管理)(系统接口)

本模块提供系统管理能力。

说明

本模块首批接口从API version 11开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

本模块接口仅可在Stage模型下使用。

本模块接口仅对设备管理应用开放,需将设备管理应用激活后调用,实现相应功能。

本模块接口均为系统接口。

导入模块

import systemManager from '@ohos.enterprise.systemManager';

systemManager.setNTPServer

setNTPServer(admin: Want, server: string): void

指定设备管理应用设置NTP服务器的策略。

需要权限: ohos.permission.ENTERPRISE_MANAGE_SYSTEM

系统能力: SystemCapability.Customization.EnterpriseDeviceManager

参数:

参数名 类型 必填 说明
admin Want 设备管理应用。
server string NTP服务器地址(以","分隔,如"ntpserver1.com,ntpserver2.com")。

错误码

以下错误码的详细介绍请参见企业设备管理错误码

错误码ID 错误信息
9200001 the application is not an administrator of the device.
9200002 the administrator application does not have permission to manage the device.

示例:

import systemManager from '@ohos.enterprise.systemManager';
import Want from '@ohos.app.ability.Want';
let wantTemp: Want = {
  bundleName: 'com.example.myapplication',
  abilityName: 'EntryAbility',
};
let server: string = "ntpserver.com";
try {
  systemManager.setNTPServer(wantTemp, server);
  console.info('Succeeded in setting NTPserver');
} catch (err) {
  console.error(`Failed to set usb policy. Code is ${err.code}, message is ${err.message}`);
}

systemManager.getNTPServer

getNTPServer(admin: Want): string

指定设备管理应用获取NTP服务器信息。

需要权限: ohos.permission.ENTERPRISE_MANAGE_SYSTEM

系统能力: SystemCapability.Customization.EnterpriseDeviceManager

参数:

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

返回值:

类型 说明
string string对象,返回NTP服务器信息。

错误码

以下错误码的详细介绍请参见企业设备管理错误码

错误码ID 错误信息
9200001 the application is not an administrator of the device.
9200002 the administrator application does not have permission to manage the device.

示例:

import systemManager from '@ohos.enterprise.systemManager';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let wantTemp: Want = {
  bundleName: 'com.example.myapplication',
  abilityName: 'EntryAbility',
};
try {
  systemManager.getNTPServer(wantTemp);
  console.info('Succeeded in getting NTP server');
} catch (err) {
  console.error(`Failed to set usb policy. Code is ${err.code}, message is ${err.message}`);
}

SystemUpdateInfo11+

待更新的系统版本信息。

系统能力: SystemCapability.Customization.EnterpriseDeviceManager

系统接口: 此接口为系统接口。

名称 类型 必填 说明
versionName string 待更新的系统版本名称。
firstReceivedTime number 首次收到系统更新包的时间。
packageType string 待更新的系统更新包类型。