Klonen eines Teams

Namespace: microsoft.graph

Erstellen Sie eine Kopie eines Teams. Dieser Vorgang erstellt auch eine Kopie der entsprechenden Gruppe. Sie können angeben, welche Teile des Teams geklont werden sollen:

• apps : Kopiert Microsoft Teams Apps, die im Team installiert sind.
• Kanäle – Kopiert die Kanalstruktur (aber nicht die Nachrichten im Kanal).
• mitglieder – Kopiert die Mitglieder und Besitzer der Gruppe.
• einstellungen – Kopiert alle Einstellungen innerhalb des Teams zusammen mit wichtigen Gruppeneinstellungen.
• Registerkarten – Kopiert die Registerkarten innerhalb von Kanälen.

Wenn Registerkarten geklont werden, werden sie in einen nicht konfigurierten Zustand versetzt. Sie werden auf der Registerkartenleiste in Microsoft Teams angezeigt, und wenn Sie sie zum ersten Mal öffnen, durchlaufen Sie den Konfigurationsbildschirm. (Wenn die Person, die die Registerkarte öffnet, nicht über die Berechtigung zum Konfigurieren von Apps verfügt, wird eine Meldung angezeigt, in der erläutert wird, dass die Registerkarte nicht konfiguriert wurde.)

Beim Klonen handelt es sich um einen vorgang mit langer Ausführungsdauer. Nachdem der POST-Klon zurückgegeben wurde, müssen Sie den Vorgang abrufen, um festzustellen, ob er "ausgeführt" oder "erfolgreich" oder "fehlgeschlagen" ist. Sie sollten mit GET fortfahren, bis der Status nicht "ausgeführt" ist. Die empfohlene Verzögerung zwischen GETs beträgt 5 Sekunden.

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	Team.Create, Group.ReadWrite.All , Directory.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	Team.Create, Group.ReadWrite.All , Directory.ReadWrite.All

Hinweis: Mit ** markierte Berechtigungen werden nur für die Abwärtskompatibilität unterstützt. Es wird empfohlen, Ihre Lösungen so zu aktualisieren, dass sie eine alternative Berechtigung verwenden, die in der vorherigen Tabelle aufgeführt ist, und diese Berechtigungen in Zukunft nicht mehr verwenden.

HTTP-Anforderung

POST /teams/{id}/clone

Anforderungsheader

Kopfzeile	Wert
Authorization	Bearer {token}. Erforderlich.
Content-Type	application/json

Anforderungstext

Eigenschaft	Typ	Beschreibung
classification	Zeichenfolge (optional)	Beschreibt eine Klassifizierung für die Gruppe (z. B. geringe, mittlere oder hohe geschäftliche Auswirkungen). Wenn die Klassifizierung nicht angegeben ist, wird die Klassifizierung aus dem ursprünglichen Team/der ursprünglichen Gruppe kopiert.
description	Zeichenfolge (optional)	Eine optionale Beschreibung für die Gruppe. Wenn diese Eigenschaft nicht angegeben ist, bleibt sie leer.
displayName	String	Der Anzeigename der Gruppe. Diese Eigenschaft ist beim Erstellen einer Gruppe erforderlich und kann bei Updates nicht deaktiviert werden. Unterstützt $Filter und $orderby.
mailNickname	Zeichenfolge	Der E-Mail-Alias für die Gruppe, in der Organisation eindeutig. Diese Eigenschaft muss beim Erstellen einer Gruppe angegeben werden. Unterstützt $filter. Wenn diese Eigenschaft nicht angegeben ist, wird sie aus dem displayName berechnet. Bekanntes Problem: Diese Eigenschaft wird derzeit ignoriert.
partsToClone	verschiebbareTeamParts	Eine durch Trennzeichen getrennte Liste der zu klonenden Teile. Rechtliche Komponenten sind "Apps, Registerkarten, Einstellungen, Kanäle, Mitglieder".
visibility	teamVisibilityType (optional)	Gibt die Sichtbarkeit der Gruppe an. Die folgenden Werte sind möglich: Privat, öffentlich. Wenn die Sichtbarkeit nicht angegeben ist, wird die Sichtbarkeit aus dem ursprünglichen Team/der ursprünglichen Gruppe kopiert. Wenn es sich bei dem geklonten Team um ein educationClass-Team handelt, wird der Sichtbarkeitsparameter ignoriert, und die Sichtbarkeit der neuen Gruppe wird auf HiddenMembership festgelegt.

Antwort

If successful, this method will return a 202 Accepted response code with a Location: header pointing to the operation resource. Wenn der Vorgang abgeschlossen ist, teilt ihnen die Vorgangsressource die ID des erstellten Teams mit.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

HTTP

POST /teams/{id}/clone
Content-Type: application/json

{  
     "displayName": "Library Assist",
     "description": "Self help community for library",
     "mailNickname": "libassist",
     "partsToClone": "apps,tabs,settings,channels,members",
     "visibility": "public"
}

C#

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var displayName = "Library Assist";

var description = "Self help community for library";

var mailNickname = "libassist";

var partsToClone = ClonableTeamParts.Apps | ClonableTeamParts.Tabs | ClonableTeamParts.Settings | ClonableTeamParts.Channels | ClonableTeamParts.Members;

var visibility = TeamVisibilityType.Public;

await graphClient.Teams["{team-id}"]
    .Clone(visibility,partsToClone,displayName,description,mailNickname,null)
    .Request()
    .PostAsync();

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

JavaScript

const options = {
    authProvider,
};

const client = Client.init(options);

const clone = {
     displayName: 'Library Assist',
     description: 'Self help community for library',
     mailNickname: 'libassist',
     partsToClone: 'apps,tabs,settings,channels,members',
     visibility: 'public'
};

await client.api('/teams/{id}/clone')
    .post(clone);

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

Objective-C

MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/v1.0/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/teams/{id}/clone"]]];
[urlRequest setHTTPMethod:@"POST"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

NSMutableDictionary *payloadDictionary = [[NSMutableDictionary alloc] init];

NSString *displayName = @"Library Assist";
payloadDictionary[@"displayName"] = displayName;

NSString *description = @"Self help community for library";
payloadDictionary[@"description"] = description;

NSString *mailNickname = @"libassist";
payloadDictionary[@"mailNickname"] = mailNickname;

MSGraphClonableTeamParts *partsToClone = [MSGraphClonableTeamParts apps];
payloadDictionary[@"partsToClone"] = partsToClone;

MSGraphTeamVisibilityType *visibility = [MSGraphTeamVisibilityType public];
payloadDictionary[@"visibility"] = visibility;

NSData *data = [NSJSONSerialization dataWithJSONObject:payloadDictionary options:kNilOptions error:&error];
[urlRequest setHTTPBody:data];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        //Request Completed

}];

[meDataTask execute];

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

Java

GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

String displayName = "Library Assist";

String description = "Self help community for library";

String mailNickname = "libassist";

EnumSet<ClonableTeamParts> partsToClone = EnumSet.of(ClonableTeamParts.APPS,ClonableTeamParts.TABS,ClonableTeamParts.SETTINGS,ClonableTeamParts.CHANNELS,ClonableTeamParts.MEMBERS);

TeamVisibilityType visibility = TeamVisibilityType.PUBLIC;

graphClient.teams("{id}")
    .clone(TeamCloneParameterSet
        .newBuilder()
        .withDisplayName(displayName)
        .withDescription(description)
        .withMailNickname(mailNickname)
        .withClassification(null)
        .withVisibility(visibility)
        .withPartsToClone(partsToClone)
        .build())
    .buildRequest()
    .post();

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

Go

//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

requestBody := msgraphsdk.New()
displayName := "Library Assist"
requestBody.SetDisplayName(&displayName)
description := "Self help community for library"
requestBody.SetDescription(&description)
mailNickname := "libassist"
requestBody.SetMailNickname(&mailNickname)
partsToClone := "apps,tabs,settings,channels,members"
requestBody.SetPartsToClone(&partsToClone)
visibility := "public"
requestBody.SetVisibility(&visibility)
teamId := "team-id"
graphClient.TeamsById(&teamId).Clone(team-id).Post(requestBody)

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

PowerShell

Import-Module Microsoft.Graph.Teams

$params = @{
    DisplayName = "Library Assist"
    Description = "Self help community for library"
    MailNickname = "libassist"
    PartsToClone = "apps,tabs,settings,channels,members"
    Visibility = "public"
}

Copy-MgTeam -TeamId $teamId -BodyParameter $params

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

Antwort

Das Folgende ist ein Beispiel für die Antwort. Hinweis: Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.

HTTP/1.1 202 Accepted
Location: /teams({id})/operations({opId})
Content-Type: text/plain
Content-Length: 0