Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores 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)
AdministrativeUnit.ReadWrite.All
No disponible.
Delegado (cuenta personal de Microsoft)
No admitida.
No admitida.
Aplicación
AdministrativeUnit.ReadWrite.All
No disponible.
Importante
En escenarios delegados con cuentas profesionales o educativas, el usuario que ha iniciado sesión debe ser un usuario miembro o tener asignado un rol de Microsoft Entra compatible o un rol personalizado con un permiso de rol admitido.
Privileged Role Administrator es el rol con privilegios mínimos admitido para esta operación.
Controla si la regla de pertenencia dinámica se procesa activamente.
On Establézcalo en para activar la regla de pertenencia dinámica o Paused para detener la actualización dinámica de la pertenencia. Opcional.
membershipType
Cadena
Indica el tipo de pertenencia de la unidad administrativa. Los valores posibles son: dynamic, assigned. Si no se establece, el valor predeterminado es null y se asigna el comportamiento predeterminado. Opcional.
visibility
Cadena
Visibilidad de la unidad administrativa. Si no se establece, el valor predeterminado es null y el comportamiento predeterminado es público. Se puede establecer en HiddenMembership para ocultar la pertenencia de los no miembros. Opcional.
El recurso administrativeUnit admite extensiones, lo que permite usar la POST operación para agregar propiedades personalizadas con sus propios datos al crear la unidad administrativa.
Respuesta
Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto administrativeUnit en el cuerpo de la respuesta.
Ejemplo
Solicitud
En el ejemplo siguiente se muestra una solicitud que crea una nueva unidad administrativa con una regla de pertenencia dinámica para incluir todos los usuarios cuyo país es el Estados Unidos.
POST https://graph.microsoft.com/v1.0/directory/administrativeUnits
Content-type: application/json
{
"displayName": "Seattle District Technical Schools",
"description": "Seattle district technical schools administration",
"membershipType": "Dynamic",
"membershipRule": "(user.country -eq \"United States\")",
"membershipRuleProcessingState": "On",
"visibility": "HiddenMembership"
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new AdministrativeUnit
{
DisplayName = "Seattle District Technical Schools",
Description = "Seattle district technical schools administration",
MembershipType = "Dynamic",
MembershipRule = "(user.country -eq \"United States\")",
MembershipRuleProcessingState = "On",
Visibility = "HiddenMembership",
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Directory.AdministrativeUnits.PostAsync(requestBody);
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
AdministrativeUnit administrativeUnit = new AdministrativeUnit();
administrativeUnit.setDisplayName("Seattle District Technical Schools");
administrativeUnit.setDescription("Seattle district technical schools administration");
administrativeUnit.setMembershipType("Dynamic");
administrativeUnit.setMembershipRule("(user.country -eq \"United States\")");
administrativeUnit.setMembershipRuleProcessingState("On");
administrativeUnit.setVisibility("HiddenMembership");
AdministrativeUnit result = graphClient.directory().administrativeUnits().post(administrativeUnit);
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.administrative_unit import AdministrativeUnit
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = AdministrativeUnit(
display_name = "Seattle District Technical Schools",
description = "Seattle district technical schools administration",
membership_type = "Dynamic",
membership_rule = "(user.country -eq \"United States\")",
membership_rule_processing_state = "On",
visibility = "HiddenMembership",
)
result = await graph_client.directory.administrative_units.post(request_body)