文档中心
v3.4

SequoiaDB 简介

安装部署

数据库实例

分布式引擎

SAC 管控中心

参考手册

常见问题及解答(FAQ)

版本信息

setUserConfigs

名称

setUserConfigs - 修改操作系统用户的配置

语法

System.setUserConfigs(<options>)

类别

System

描述

该函数用于修改操作系统用户的用户组、附加组、用户目录等配置。

参数

options( object,必填

通过参数 options 可以修改用户的属性:

  • name( string ):指定需要修改的用户,该参数必填

    格式:name: "username"

  • gid( string ):指定用户的初始组(主组)

    该参数可以是用户组的组名或组 ID,且指定的用户组必须已存在。如果不指定,则默认创建与参数 name 同名的用户组。

    格式:gid: "groupName"gid: "2003"

  • groups( string ):指定附加组

    该参数可以是用户组的组名或组 ID,且指定的用户组必须已存在。所指定的多个用户组以逗号分隔。

    格式:groups: "groupName1,groupName2,groupName3"groups: "2004,2005,2006"

  • isAppend( boolean ):指定是否追加附加组,默认为 false

    该参数需要配合参数 groups 使用。当指定了 groups 且设置 isAppend 为 true,将会追加该用户的附加组;当指定了 groups 且设置 isAppend 为 false,将会替换原有的附加组。

    格式:isAppend: true

  • isMove( boolean ):指定是否移动到新指定的目录,默认为 false

    该参数为 ture 时必须指定参数 dir 的值。

    格式:isMove: true

  • dir( string ):指定新的用户目录,仅参数 isMove 为 true 时生效

    该参数不能指定已存在的目录。指定的新目录将保留原用户目录的数据,而原用户目录将会被移除。

    格式:dir: "userHomeDir"

返回值

函数执行成功时,无返回值。

函数执行失败时,将抛异常并输出错误信息。

错误

当异常抛出时,可以通过 getLastErrMsg() 获取错误信息或通过 getLastError() 获取错误码。更多错误处理可以参考常见错误处理指南

版本

v3.2 及以上版本

示例

修改指定用户组中 newUser 用户的 home 目录

> System.setUserConfigs({name: "newUser", gid: "groupName", dir: "/home/userName", isMove: true})
回到顶部