Verbinden einer neuen Microsoft 365-Gruppe: CSOM-Entwicklung

Das clientseitige SharePoint-Objektmodell (Client-Side Object Model, CSOM) bietet Zugriff auf das SharePoint-Objektmodell von Code, der lokal oder auf einem anderen Server als SharePoint ausgeführt wird.

Wichtig

Es wird nicht unterstützt, um eine Verbindung zwischen einer Kommunikationswebsite und einer Microsoft 365-Gruppe herzustellen.

Voraussetzungen

Machen Sie sich mit den folgenden Themen vertraut, bevor Sie mit den ersten Schritten beginnen:

Sie müssen zudem auf das Microsoft.SharePointOnline.CSOM-NuGet-Paket (Version 16.1.6906.1200 oder höher) verweisen.

CSOM-Codebeispiel

Das folgende Beispiel zeigt, wie Sie ein Microsoft.Online.SharePoint.TenantAdministration.Tenant-Objekt erstellen und die CreateGroupForSite-Methode aufrufen, um eine Liste von Themen zurückzugeben.

Hinweis

  • Die URL zum Erstellen des Kontextobjekts enthält das Suffix -admin, da TenantAdministration-Methoden mit der Adminwebsite funktionieren.
  • Erstellen Sie eine Mandanten-Instanz mit dem Mandant-Konstruktor und rufen Sie anschließend die Methoden für diese Instanz auf.
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();

Methoden der Klasse „Microsoft.Online.SharePoint.TenantAdministration.Tenant“

Verwenden Sie die folgenden Methoden, um eine neue Microsoft 365-Gruppe zu erstellen und sie an eine bestehende Website anzuhängen.

Methode „CreateGroupForSite“

Erstellen Sie eine neue Microsoft 365-Gruppe und fügen Sie diese einer vorhandenen Website an. Wurde dies erfolgreich für eine Website ausgeführt, löst das erneute Aufrufen mit derselben Website eine Ausnahme aus.

Namespace: Microsoft.Online.SharePoint.TenantAdministration.Tenant
Rückgabetyp: void

Parameter Typ Beschreibung
siteUrl String Die URL der Website, die mit einer neuen Microsoft 365-Gruppe verbunden werden soll.
displayName String Anzeigename der zu erstellenden Gruppe.
Alias String Alias der neu zu erstellenden Gruppe.
isPublic bool Gibt an, ob die Gruppe öffentlich oder privat ist.
optionalParams GroupCreationParams Eine optionale Sammlung von Parametern zur Erstellung der Gruppe.

Typ: Microsoft.Online.SharePoint.TenantAdministration.GroupCreationParams

Eigenschaft Typ Beschreibung
Beschreibung String Ruft die Beschreibung der Gruppe ab und legt diese fest.
Besitzer string[] Ruft die Besitzer der Gruppe ab und legt diese fest. Es sollte sich hierbei um die Hauptnamen der Benutzer handeln.
CreationOptions string[] Ruft die Erstellungsoptionen der Gruppe ab und legt diese fest.
Klassifizierung String Ruft die Datenklassifizierung der Gruppe ab und legt diese fest.

Siehe auch

  • Last updated on