连接到新的 Microsoft 365 组：CSOM 开发

借助 SharePoint 客户端对象模型 (CSOM)，可以通过在本地或非 SharePoint 服务器上运行的代码访问 SharePoint 对象模型。

重要

不支持将通信网站连接到 Microsoft 365 组。

先决条件

开始前，请务必先熟悉以下内容：

此外，还需要引用 Microsoft.SharePointOnline.CSOM NuGet 包（版本 16.1.6906.1200 或更高版本）。

CSOM 代码示例

下面的示例展示了如何创建 Microsoft.Online.SharePoint.TenantAdministration.Tenant 对象，并调用 CreateGroupForSite 方法返回主题列表。

备注

用于创建上下文对象的 URL 包括 -admin 后缀，因为 TenantAdministration 方法处理的是管理网站。
使用 Tenant 构造函数创建 Tenant 实例，再对此实例调用相应方法。

using System.Security;
using Microsoft.SharePoint.Client;
using Microsoft.Online.SharePoint.TenantAdministration;
using Microsoft.Online.SharePoint.TenantManagement;

...

ClientContext ctx = new ClientContext("https://contoso-admin.sharepoint.com/");
var pwd = "mypassword";
var passWord = new SecureString();
foreach (char c in pwd.ToCharArray()) passWord.AppendChar(c);
ctx.Credentials = new SharePointOnlineCredentials("admin@mydomain.com", passWord);
Tenant tenant = new Tenant(ctx);
tenant.CreateGroupForSite("https://contoso.sharepoint.com/sites/team-site", "display-name-for-group", "alias-for-group", true);
ctx.ExecuteQuery();

Microsoft.Online.SharePoint.TenantAdministration.Tenant 类方法

使用以下方法创建新的 Microsoft 365 组并将其附加到现有网站。

CreateGroupForSite 方法

创建新的 Microsoft 365 组并将其附加到现有网站。成功对给定网站执行此操作后，使用相同网站再次调用将引发异常。

命名空间： Microsoft.Online.SharePoint.TenantAdministration.Tenant
返回类型： void

参数	类型	说明
siteUrl	string	连接到新的 Microsoft 365 组的网站的 URL。
displayName	string	要创建的组的显示名称。
alias	string	要创建的新组的别名。
IsPublic	bool	组是公共或专用。
optionalParams	GroupCreationParams	一组可选的组创建参数。

类型： Microsoft.Online.SharePoint.TenantAdministration.GroupCreationParams

属性	类型	说明
说明	string	获取和设置组说明。
所有者	string[]	获取和设置组所有者。这些应是用户主体名称。
CreationOptions	string[]	获取和设置组创建选项。
分类	string	获取和设置组数据分类。

另请参阅

Last updated on 2022-06-29