更新用户

更新用户对象的属性。

先决条件

要执行此 API,需要以下范围之一:User.ReadWrite;User.ReadWrite.All;Directory.ReadWrite.All

更新 passwordProfile 属性时,必须有以下范围:Directory.AccessAsUser.All

HTTP 请求

PATCH /users/{id | userPrincipalName}

请求标头

标头
Authorization Bearer {token}。必需。
Content-Type application/json

请求正文

在请求正文中,提供应更新的相关字段的值。请求正文中不包括的现有属性将保留其以前的值,或根据对其他属性值的更改重新计算。为了获得最佳性能,不应包括尚未更改的现有值。

属性 类型 说明
aboutMe String 任意形式的文本输入字段,用于介绍用户自身。
accountEnabled Boolean 启用帐户时为 true,否则为 false。创建用户时此属性是必需的。支持 $filter。
assignedLicenses assignedLicense collection 分配给该用户的许可证。不可为 null。
birthday DateTimeOffset 用户的生日。时间戳类型表示使用 ISO 8601 格式的日期和时间信息,并且始终处于 UTC 时间。例如,2014 年 1 月 1 日午夜 UTC 如下所示:'2014-01-01T00:00:00Z'
city String 用户所在的城市。支持 $filter。
country String 用户所在的国家/地区;例如,“美国”或“英国”。支持 $filter。
department String 用户工作部门的名称。支持 $filter。
displayName String 用户通讯簿中显示的名称。这通常是用户名字、中间名首字母和姓氏的组合。此属性在创建用户时是必需的,并且在更新过程中不能清除。支持 $filter 和 $orderby。
givenName String 用户的名。支持 $filter。
hireDate DateTimeOffset 用户的雇佣日期。时间戳类型表示使用 ISO 8601 格式的日期和时间信息,并且始终处于 UTC 时间。例如,2014 年 1 月 1 日午夜 UTC 如下所示:'2014-01-01T00:00:00Z'
interests String collection 用户介绍自身兴趣的列表。
jobTitle String 用户的职务。支持 $filter。
mailNickname String 用户的邮件别名。创建用户时必须指定此属性。支持 $filter。
mobilePhone String 用户的主要移动电话号码。
mySite String 用户个人网站的 URL。
officeLocation String 用户公司地点的办公室位置。
onPremisesImmutableId String 此属性用于将本地 Active Directory 用户帐户关联到他们的 Azure AD 用户对象。如果对用户的 userPrincipalName (UPN) 属性使用联盟域,必须在创建新用户帐户时指定此属性。重要说明:指定该属性时不能使用 $ 和 **_** 字符。支持 $filter。
passwordPolicies String 指定用户的密码策略。此值是一个枚举,具有一个可能值“DisableStrongPassword”,允许指定比默认策略弱的密码。还可以指定“DisablePasswordExpiration”。可以同时指定这两个策略;例如:“DisablePasswordExpiration、DisableStrongPassword”。
passwordProfile PasswordProfile 指定用户的密码配置文件。配置文件包含用户的密码。创建用户时此属性是必需的。配置文件中的密码必须满足 passwordPolicies 属性指定的最低要求。默认情况下,必须使用强密码。
pastProjects String collection 供用户枚举其过去项目的列表。
postalCode String 用户邮政地址的邮政编码。邮政编码特定于用户所在的国家/地区。在美国,此属性包含邮政编码。
preferredLanguage String 用户的首选语言。应遵循 ISO 639-1 代码;例如“EN-US”。
preferredName String 用户的首选名称。
responsibilities String collection 供用户枚举其职责的列表。
schools String collection 供用户枚举其学习过的学校列表。
skills String collection 供用户枚举其技能的列表。
state String 用户地址中的省/市/自治区或省。支持 $filter。
streetAddress String 用户公司地点的街道地址。
surname String 用户的姓氏。支持 $filter。
usageLocation String 两个字母的国家/地区代码(ISO 标准 3166)。为检查服务在国家/地区的可用性,这对根据法律要求将分配许可证的用户而言是必需的。示例包括:“US”、“JP”和“GB”。不可为 null。支持 $filter。
userPrincipalName String 用户的用户主体名称 (UPN)。UPN 是用户基于 Internet 标准 RFC 822 的 Internet 式登录名。按照惯例,此名称应映射到用户的电子邮件名称。常规格式是 alias@domain,其中,domain 必须位于租户的已验证域集合中。创建用户时此属性是必需的。可从 组织verifiedDomains 属性访问租户的已验证域。支持 $filter 和 $orderby。
userType String 可用于对目录中的用户类型分类的字符串值,例如“成员”和“访客”。支持 $filter。

响应

如果成功,此方法返回 204 No Content 响应代码。

示例

请求

下面是一个请求示例。

PATCH https://graph.microsoft.com/v1.0/me
Content-type: application/json
Content-length: 491

{
  "accountEnabled": true,
  "assignedLicenses": [
    {
      "disabledPlans": [ "bea13e0c-3828-4daa-a392-28af7ff61a0f" ],
      "skuId": "skuId-value"
    }
  ],
  "assignedPlans": [
    {
      "assignedDateTime": "datetime-value",
      "capabilityStatus": "capabilityStatus-value",
      "service": "service-value",
      "servicePlanId": "bea13e0c-3828-4daa-a392-28af7ff61a0f"
    }
  ],
  "businessPhones": [
    "businessPhones-value"
  ],
  "city": "city-value",
  "companyName": "companyName-value"
}
响应

下面是一个响应示例。

HTTP/1.1 204 No Content