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 :
- Utilisation du modèle objet client
- Tâches courantes de programmation dans le modèle objet client géré
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. |