Actualizar la funcionalidad de Microsoft 365 para la directiva predeterminada

Espacio de nombres: microsoft.graph

Actualice una funcionalidad entre inquilinos de Microsoft 365 existente para la directiva de acceso entre inquilinos predeterminada.

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) Policy.ReadWrite.CrossTenantCapability No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación Policy.ReadWrite.CrossTenantCapability No disponible.

Importante

Para el acceso delegado mediante cuentas profesionales o educativas en las que el usuario que ha iniciado sesión actúa sobre otro usuario, se le debe asignar un rol compatible de Microsoft Entra o un rol personalizado que conceda los permisos necesarios para esta operación. La administración de las funcionalidades multiinquilino de Microsoft 365 afecta a toda la directiva de acceso entre inquilinos, por lo que ningún rol integrado con privilegios inferiores cubre todas las funcionalidades. Esta operación admite los siguientes roles integrados:

  • Administrador global: necesario para todas las funcionalidades, ya que la administración de la directiva de acceso entre inquilinos requiere privilegios para todo el directorio.
  • Administrador de Exchange: compatible solo con las funciones Sugerencias de correo, Uso compartido del Calendario y Disponibilidad.

Solicitud HTTP

PATCH /policies/crossTenantAccessPolicy/default/m365Capabilities/{m365CapabilityBase-name}

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, únicamente proporcione los valores de las propiedades que deben actualizarse. Las propiedades existentes que no están incluidas en el cuerpo de la solicitud mantienen sus valores anteriores.

En la tabla siguiente se especifican las propiedades que se pueden actualizar.

Propiedad Tipo Descripción
acceso entrante m365CapabilityInboundAccess La configuración de acceso de entrada para la funcionalidad.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 204 No Content.

Ejemplos

Ejemplo 1: Actualizar solo la configuración de acceso

En el ejemplo siguiente se muestra cómo actualizar solo la configuración isAllowed para una funcionalidad.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

PATCH https://graph.microsoft.com/v1.0/policies/crossTenantAccessPolicy/default/m365Capabilities/crossTenantOpenProfileCard
Content-Type: application/json

{
  "inboundAccess": {
    "isAllowed": false
  }
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content

Ejemplo 2: Actualizar la configuración de acceso y los ámbitos de recursos

En el ejemplo siguiente se muestra cómo actualizar la configuración de isAllowed y el resourceScopes para una funcionalidad.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

PATCH https://graph.microsoft.com/v1.0/policies/crossTenantAccessPolicy/default/m365Capabilities/crossTenantOpenProfileCard
Content-Type: application/json

{
  "inboundAccess": {
    "isAllowed": true,
    "resourceScopes": {
      "included": [
        {
          "resourceId": "ad4fc698-74dc-4f62-9e71-ba9b591e8e74",
          "resourceType": "group"
        },
        {
          "resourceId": "070061d7-a98e-43d3-b708-0758d3738ac7",
          "resourceType": "group"
        }
      ],
      "excluded": [
        {
          "resourceId": "ad4fc698-74dc-4f62-9e71-ba9b591e8e00",
          "resourceType": "group"
        }
      ]
    }
  }
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content
  • Last updated on