添加成员

命名空间：microsoft.graph

使用此 API 将成员 (用户、组或设备) 添加到管理单元。目前，一次只能向管理单元添加一个成员。

全局服务	美国政府 L4	美国政府 L5 (DOD)	由世纪互联运营的中国
✅	✅	✅	✅

权限

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

添加现有用户、组或设备的权限

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

重要

在具有工作或学校帐户的委托方案中，登录用户必须是成员用户或分配了受支持的Microsoft Entra角色或具有受支持角色权限的自定义角色。 特权角色管理员 是此作支持的最低特权角色。

创建新组的权限

权限类型	权限（从最低特权到最高特权）
委派（工作或学校帐户）	Group.ReadWrite.All 和 AdministrativeUnit.Read.All、Directory.ReadWrite.All
委派（个人 Microsoft 帐户）	不支持。
应用程序	Group.Create 和 AdministrativeUnit.Read.All、Group.ReadWrite.All 和 AdministrativeUnit.Read.All、Directory.ReadWrite.All

重要

若要在管理单元中创建新组，必须在管理单元范围内至少为调用主体分配以下Microsoft Entra角色之一：

组管理员
用户管理员

对于仅应用方案 - 除了这些角色之外，服务主体还需要其他权限才能读取目录。可以通过分配受支持的Microsoft Entra角色（例如“目录读取者”角色）授予这些权限;也可以通过允许读取目录的 Microsoft graph 应用程序权限（如 Directory.Read.All）授予这些权限。

HTTP 请求

以下请求将现有用户、组或设备添加到管理单元。

POST /directory/administrativeUnits/{id}/members/$ref

以下请求在管理单元中创建一个新组。

POST /directory/administrativeUnits/{id}/members

请求标头

名称	说明
Authorization	持有者 {token}。必填。详细了解身份验证和授权。
Content-type	application/json. 必需。

请求正文

添加现有用户、组或设备

在请求正文中，提供要添加的用户、组、设备或 directoryObject 的 ID。如果管理单元是受限管理管理单元 ("isMemberManagementRestricted": true) ，则组类型必须是Microsoft Entra安全组。仅支持启用安全、未启用邮件和未启用本地同步的非统一组。

创建新组

下表显示了在管理单元中创建组时要指定的组资源的属性。

属性	类型	说明
displayName	string	要在组的通讯簿中显示的名称。必需。
description	string	组说明。可选。
isAssignableToRole	Boolean	将设置为 true 以启用要分配给Microsoft Entra角色的组。特权角色管理员是设置此属性值的最低特权角色。可选。
mailEnabled	Boolean	对于已启用邮件的组，请设置为 true。必需。
mailNickname	string	组的邮件别名。这些字符不能在 mailNickName 中使用： `@()\[]";:.<>,SPACE`。必填。
securityEnabled	Boolean	对于启用安全机制的组（包括 Microsoft 365 组），请设置为 true。必填。
owners	directoryObject collection	此属性表示创建时指定的组所有者。可选。
members	directoryObject collection	此属性表示创建时指定的组成员。可选。
visibility	String	指定 Microsoft 365 组的可见性。可能的值为： `Private`、 `Public`、 `HiddenMembership`或空 (解释为 `Public`) 。

响应

如果成功，使用 $ref) 添加现有对象 (将 204 No Content 返回响应代码。它不会在响应正文中返回任何内容。

在没有) 的情况下 $ref 创建新组 (时，此方法在响应正文中返回 201 Created 响应代码和组对象。该响应仅包括组的默认属性。必须在请求正文中提供 "@odata.type" : "#microsoft.graph.group" 行，才能将新成员显式标识为组。没有正确 @odata.type 项的请求正文将 400 Bad Request 返回错误消息。

示例

示例 1：添加现有用户或组

以下请求将现有用户或组添加到管理单元。

请求

以下示例显示了一个请求。

POST https://graph.microsoft.com/v1.0/directory/administrativeUnits/{id}/members/$ref
Content-type: application/json

{
  "@odata.id":"https://graph.microsoft.com/v1.0/groups/{id}"
}


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new ReferenceCreate
{
	OdataId = "https://graph.microsoft.com/v1.0/groups/{id}",
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Directory.AdministrativeUnits["{administrativeUnit-id}"].Members.Ref.PostAsync(requestBody);



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewReferenceCreate()
odataId := "https://graph.microsoft.com/v1.0/groups/{id}"
requestBody.SetOdataId(&odataId) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Directory().AdministrativeUnits().ByAdministrativeUnitId("administrativeUnit-id").Members().Ref().Post(context.Background(), requestBody, nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

com.microsoft.graph.models.ReferenceCreate referenceCreate = new com.microsoft.graph.models.ReferenceCreate();
referenceCreate.setOdataId("https://graph.microsoft.com/v1.0/groups/{id}");
graphClient.directory().administrativeUnits().byAdministrativeUnitId("{administrativeUnit-id}").members().ref().post(referenceCreate);


const options = {
	authProvider,
};

const client = Client.init(options);

const directoryObject = {
  '@odata.id':'https://graph.microsoft.com/v1.0/groups/{id}'
};

await client.api('/directory/administrativeUnits/{id}/members/$ref')
	.post(directoryObject);


<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\ReferenceCreate;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new ReferenceCreate();
$requestBody->setOdataId('https://graph.microsoft.com/v1.0/groups/{id}');

$graphServiceClient->directory()->administrativeUnits()->byAdministrativeUnitId('administrativeUnit-id')->members()->ref()->post($requestBody)->wait();


Import-Module Microsoft.Graph.Identity.DirectoryManagement

$params = @{
	"@odata.id" = "https://graph.microsoft.com/v1.0/groups/{id}"
}

New-MgDirectoryAdministrativeUnitMemberByRef -AdministrativeUnitId $administrativeUnitId -BodyParameter $params


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.reference_create import ReferenceCreate
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = ReferenceCreate(
	odata_id = "https://graph.microsoft.com/v1.0/groups/{id}",
)

await graph_client.directory.administrative_units.by_administrative_unit_id('administrativeUnit-id').members.ref.post(request_body)

在请求正文中，提供 id 要添加的用户或组对象的。

响应

以下示例显示了相应的响应。

HTTP/1.1 204 No Content

示例 2：创建新组

以下示例在管理单元中创建一个新组。必须在请求正文中提供 "@odata.type" : "#microsoft.graph.group" 行，才能将新成员显式标识为组。没有正确 @odata.type 项的请求正文将 400 Bad Request 返回错误消息。

请求