Se connecter à un nouveau groupe Microsoft 365 : développement CSOM

Le modèle CSOM (Client-side Server Object Model) permet d’accéder au modèle d’objet SharePoint à partir d’un code exécuté localement ou sur un serveur autre que SharePoint.

Important

Désolé... Nous ne prenons pas en charge la connexion d’un site de communication au groupe Microsoft 365.

Conditions requises

Avant de commencer, assurez-vous que vous connaissez les éléments suivants :

Vous devez également référencer le package NuGet Microsoft.SharePointOnline.CSOM (version 16.1.6906.1200 ou ultérieure).

Exemple de code CSOM

L’exemple suivant montre comment créer un objet Microsoft.Online.SharePoint.TenantAdministration.Tenant et appeler la méthode CreateGroupForSite afin de renvoyer une liste de thèmes.

Notes

  • L’URL utilisée pour créer l’objet de contexte inclut le suffixe - admin, car les méthodes TenantAdministration fonctionnent avec le site administrateur.
  • Créez une instance Client avec le Constructeur de clients, puis appelez les méthodes sur cette instance.
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éthodes dans la classe Microsoft.Online.SharePoint.TenantAdministration.Tenant

Utilisez les méthodes suivantes pour créer un groupe Microsoft 365, puis joignez-le à un site existant.

Méthode CreateGroupForSite

Créez un groupe Microsoft 365, puis joignez-le à un site existant. Une fois cette opération réussie pour un site donné, le refaire avec le même site génèrera une Exception.

Espace de noms : Microsoft.Online.SharePoint.TenantAdministration.Tenant
Type de valeur renvoyée : void

Paramètre Type Description
siteUrl string URL du site à connecter à un nouveau groupe Microsoft 365.
displayName string Groupe du nom d'affichage à créer.
alias string Alias du nouveau groupe à créer.
isPublic bool Si le groupe est public ou privé.
optionalParams GroupCreationParams Un ensemble facultatif de paramètres de création du groupe.

type: Microsoft.Online.SharePoint.TenantAdministration.GroupCreationParams

Propriété Type Description
Description string Obtient et définit la description du groupe.
Propriétaires string[] Obtient et définit les propriétaires du groupe. Ceux-ci devraient être les noms principaux des utilisateurs.
CreationOptions string[] Obtient et définit les options de création du groupe.
Classification string Obtient et définit la classification des données du groupe.

Voir aussi