更新 authorizationPolicy

命名空间:microsoft.graph

更新 authorizationPolicy 对象 的属性。

权限

要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限

权限类型 权限(从最低特权到最高特权)
委派(工作或学校帐户) Policy.ReadWrite.Authorization
委派(个人 Microsoft 帐户) 不支持。
应用程序 Policy.ReadWrite.Authorization

HTTP 请求

PATCH /policies/authorizationPolicy

请求标头

名称 说明
Authorization Bearer {token}。必需。
Content-type application/json. Required.

请求正文

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

属性 类型 说明
allowedToSignUpEmailBasedSubscriptions 布尔 指示用户是否可以注册基于电子邮件的订阅。
allowedToUseSSPR 布尔 指示租户Self-Serve是否可以使用密码重置功能。
allowEmailVerifiedUsersToJoinOrganization 布尔 指示用户是否可以通过电子邮件验证加入租户。
allowInvitesFrom allowInvitesFrom 指示谁可以邀请外部用户加入组织。 可取值为:noneadminsAndGuestInvitersadminsGuestInvitersAndAllMemberseveryoneeveryone 是除美国政府以外的所有云环境的默认设置。 有关详细信息,请参阅此表中的允许
blockMsolPowerShell 布尔 若要禁止使用 MSOL PowerShell,将此属性设置为 true 。 这还将禁止基于用户对 MSOL PowerShell 使用的旧服务终结点的访问。 这不会影响 Azure AD 连接 或 Microsoft Graph。
defaultUserRolePermissions defaultUserRolePermissions 指定默认用户角色的某些可自定义权限。
说明 String 此策略的说明。
displayName String 此策略的显示名称。
guestUserRoleId Guid 表示应授予来宾用户的角色的角色 templateId。 当前支持以下角色:用户角色 () 、来宾用户 () 和受限来宾用户 a0b1b346-4d3e-4e8b-98f8-753987be4970 10dae51f-b6af-4016-8d66-8c2a99b929b3 2af84b1e-32c8-42b7-82bc-daa82404023b () 。

响应

如果成功,此方法返回 204 No Content 响应代码。它不在响应正文中返回任何内容。

示例

示例 1:更新或设置租户的来宾用户访问级别

请求

下面展示了示例请求。 本示例将来宾访问级别修改为"受限来宾用户"。

PATCH https://graph.microsoft.com/v1.0/policies/authorizationPolicy

{
  "allowEmailVerifiedUsersToJoinOrganization":false
}

响应

下面展示了示例响应。

HTTP/1.1 204 No Content

示例 2:在租户中阻止 MSOL PowerShell

请求

下面展示了示例请求。

PATCH https://graph.microsoft.com/v1.0/policies/authorizationPolicy

{
   "blockMsolPowerShell":true
}

响应

下面展示了示例响应。

HTTP/1.1 204 No Content

示例 3:禁用默认用户角色创建应用程序的权限

请求

下面展示了示例请求。

PATCH https://graph.microsoft.com/v1.0/policies/authorizationPolicy

{
   "defaultUserRolePermissions":{
      "allowedToCreateApps":false
   }
}

响应

下面展示了示例响应。

HTTP/1.1 204 No Content

示例 4:启用默认用户角色以使用Self-Serve重置功能

请求

下面展示了示例请求。

PATCH https://graph.microsoft.com/v1.0/policies/authorizationPolicy

{
   "allowedToUseSSPR":true
}

响应

下面展示了示例响应。

HTTP/1.1 204 No Content

请求

下面展示了示例请求。

PATCH https://graph.microsoft.com/v1.0/policies/authorizationPolicy

{
   "defaultUserRolePermissions": {
      "permissionGrantPoliciesAssigned": []
   }
}

响应

下面展示了示例响应。

HTTP/1.1 204 No Content

请求

下面是一个请求示例,该请求允许用户同意应用,但需遵守内置的应用许可策略,该策略允许来自已验证发布者或在同一租户中注册的客户端应用分类为"低"的委派权限。 microsoft-user-default-low

PATCH https://graph.microsoft.com/v1.0/policies/authorizationPolicy

{
   "defaultUserRolePermissions": {
      "permissionGrantPoliciesAssigned": [
         "managePermissionGrantsForSelf.microsoft-user-default-low"
      ]
   }
}

响应

下面展示了示例响应。

HTTP/1.1 204 No Content