Compartir a través de

Conectarse a nuevo grupo de Microsoft 365: Desarrollo CSOM

El modelo de objetos de cliente de SharePoint (CSOM) proporciona acceso al modelo de objetos de SharePoint desde código que se ejecuta de manera local o en un servidor diferente de SharePoint.

Importante

No se permite conectar un sitio de comunicación al grupo de Microsoft 365.

Requisitos previos

Antes de empezar, asegúrese de que está familiarizado con lo siguiente:

También debe consultar al paquete NuGet Microsoft.SharePointOnline.CSOM (versión 16.1.6906.1200 o posterior).

Ejemplo de código de CSOM

En el siguiente ejemplo se muestra cómo crear un objeto Microsoft.Online.SharePoint.TenantAdministration.Tenant y llamar al método CreateGroupForSite para devolver una lista de temas.

Nota:

  • La dirección URL que se usa para crear el objeto de contexto incluye el sufijo -admin, dado que los métodos TenantAdministration funcionan con el sitio de administración.
  • Cree una instancia Tenant con el constructor Tenant y, después, llame a los métodos de esa instancia.
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();

Métodos en la clase Microsoft.Online.SharePoint.TenantAdministration.Tenant

Use los métodos siguientes para crear un nuevo grupo de Microsoft 365 y adjuntarlo a un sitio existente.

Método CreateGroupForSite

Crear un nuevo grupo de Microsoft 365 y adjuntarlo a un sitio existente. Cuando se realiza correctamente para un sitio determinado, llamarlo nuevamente con el mismo sitio devolverá una excepción.

Espacio de nombres: Microsoft.Online.SharePoint.TenantAdministration.Tenant
Tipo de valor devuelto: void

Parámetro Tipo Descripción
siteUrl string Dirección URL del sitio para conectarse a un nuevo grupo de Microsoft 365.
displayName string Mostrar nombre de grupo a crear.
alias string Alias del nuevo grupo a crear.
isPublic bool Si el grupo es público o privado.
optionalParams GroupCreationParams Un conjunto opcional de parámetros de creación para el grupo.

tipo: Microsoft.Online.SharePoint.TenantAdministration.GroupCreationParams

Propiedad Tipo Descripción
Descripción string Obtiene y establece la descripción del grupo.
Propietarios string[] Obtiene y establece los propietarios del grupo. Deben ser los nombres principales de los usuarios.
CreationOptions string[] Obtiene y establece las opciones de creación del grupo.
Clasificación string Obtiene y establece la clasificación de los datos del grupo.

Consulte también