Freigeben über


team-Ressourcentyp

Namespace: microsoft.graph

Ein Team in Microsoft Teams ist eine Sammlung von Kanal-Objekten. Ein Kanal stellt ein Thema und somit eine logische Trennung einer Unterhaltung in einem Team dar.

Jedes Team ist einer Microsoft 365-Gruppe zugeordnet. Die Gruppe hat die gleiche ID wie das Team – /groups/{id}/team ist z. B. identisch mit /teams/{id}. Weitere Informationen zum Arbeiten mit Gruppen und Mitgliedern in Teams finden Sie unter Verwenden der Microsoft Graph REST-API zum Arbeiten mit Microsoft Teams.

Methoden

Methode Rückgabetyp Beschreibung
Create teamsAsyncOperation Erstellen eines von Grund auf neuen Teams.
Team aus Gruppe erstellen team Erstellen eines neuen Teams oder Hinzufügen eines Teams zu einer vorhandenen Microsoft 365-Gruppe.
Get team Abrufen der Eigenschaften und Beziehungen des angegebenen Teams.
Update team Aktualisieren der Eigenschaften des angegebenen Teams.
Delete Keine Löschen des Teams und der zugehörigen Gruppe.
Mitglieder auflisten conversationMember-Sammlung Mitgliederliste des Teams abrufen.
Add member conversationMember Neues Mitglied zum Team hinzufügen.
Massenhinzufügen von Mitgliedern actionResultPart-Sammlung Hinzufügen von mehreren Mitgliedern zu dem Team im Rahmen einer einzigen Anforderung.
Mitglied abrufen conversationMember-Sammlung Mitglied des Teams abrufen.
Abrufen des primären Kanals channel Der allgemeine Kanal für das Team.
Update member conversationMember Ändern einer Rolle zu „Besitzer“ oder zurück zu „reguläres Mitglied“.
Mitglied entfernen Keine Vorhandenes Mitglied aus dem Team entfernen.
Team archivieren teamsAsyncOperation Versetzen des Teams in einen schreibgeschützten Zustand.
Archivierung von Team aufheben teamsAsyncOperation Zurückversetzen des Teams in den Zustand Lesen/Schreiben.
Team klonen teamsAsyncOperation Kopieren des Teams und der zugehörigen Gruppe.
Ihre Teams auflisten team-Sammlung Auflisten der Teams, in denen Sie Mitglied sind.
Auflisten der zugeordneten Teams associatedTeamInfoAuflistung Rufen Sie die Liste der Teams in Microsoft Teams ab, denen ein Benutzer zugeordnet ist.
Auflisten aller Teams in einer Organisation team-Sammlung Listet alle Teams in einer Organisation auf.
Abschließen der Migration für das Team team Der Migrationsmodus wird vom Team entfernt, und das Team wird den Benutzern zur Verfügung gestellt, um Nachrichten bereitzustellen und zu lesen.
Auflisten aller Kanäle channel-Sammlung Rufen Sie die Liste der Kanäle ab, die entweder in diesem Team sind oder mit diesem Team geteilt werden (eingehende Kanäle).
List channels channel-Auflistung Abrufen der Liste der Kanäle in einem Team.
Eingehende Kanäle auflisten channel-Sammlung Rufen Sie die Liste der eingehenden Kanäle ab (Kanäle, die mit einem Team geteilt werden).
Entfernen eines eingehenden Kanals Keines Entfernen eines eingehenden Kanals (eines Kanals, der für ein Team freigegeben wurde) aus einem Team.
Apps im Team auflisten teamsAppInstallation-Sammlung In einem Team installierte Apps auflisten.
App zu Team hinzufügen Keine Fügen Sie eine App (durch Installation) zu einem Team hinzu.
Im Team installierte App abrufen teamsAppInstallation Rufen Sie die angegebene in einem Team installierte App auf.
Im Team installierte App aktualisieren Keine Aktualisieren Sie die in einem Team installierte App auf die neueste Version.
App aus Team entfernen Keine Entfernen Sie eine App (durch Deinstallation) aus einem Team.
Berechtigungserteilungen auflisten resourceSpecificPermissionGrant-Sammlung Berechtigungen auflisten, die Apps erteilt wurden, um auf das Team zuzugreifen.

Eigenschaften

Eigenschaft Typ Beschreibung
id string Der eindeutige Bezeichner des Teams. Die Gruppe hat dieselbe ID wie das Team. Diese Eigenschaft ist schreibgeschützt und wird vom Basisentitätstyp geerbt.
classification string Eine optionale Bezeichnung. Beschreibt in der Regel die Daten- oder Geschäftssensitivität des Teams. Muss mit einem der im Verzeichnis des Mandanten vorkonfigurierten Sätze übereinstimmen.
classSettings teamClassSettings Konfigurieren von Einstellungen einer Klasse. Nur verfügbar, wenn das Team eine Klasse darstellt.
createdDateTime dateTimeOffset Zeitstempel für den Zeitpunkt, an dem das Team erstellt wurde.
description string Eine optionale Beschreibung für das Team. Maximale Länge: 1024 Zeichen.
displayName string Der Name des Teams.
funSettings teamFunSettings Einstellungen zum Konfigurieren der Verwendung von Giphy, Memen und Aufklebern im Team.
guestSettings teamGuestSettings Einstellungen zum Konfigurieren, ob Gäste Kanäle im Team erstellen, aktualisieren oder löschen können.
internalId Zeichenfolge Eine eindeutige ID für das Team, das an einigen Stellen verwendet wurde, zum Beispiel Überwachungsprotokoll/Office 365-Verwaltungsaktivitäts-API.
isArchived Boolesch Gibt an, ob sich das Team im schreibgeschützten Modus befindet.
memberSettings teamMemberSettings Einstellungen zum Konfigurieren, ob Mitglieder bestimmte Aktionen, z. B. Kanäle erstellen und Bots hinzufügen, im Team ausführen können.
messagingSettings teamMessagingSettings Einstellungen zum Konfigurieren von Messaging und Erwähnungen im Team.
specialization teamSpecialization Optional. Gibt an, ob das Team für einen bestimmten Anwendungsfall vorgesehen ist. Jede Teamspezialisierung hat Zugriff auf eindeutige Verhaltensweisen und Oberflächen, die auf den Anwendungsfall zugeschnitten sind.
Zusammenfassung teamSummary Enthält zusammenfassende Informationen über das Team, einschließlich der Anzahl der Besitzer, Mitglieder und Gäste.
tenantId string Die ID des Microsoft Entra-Mandanten.
visibility teamVisibilityType Die Sichtbarkeit der Gruppe und des Teams. Der Standardwert ist „öffentlich“.
webUrl string (schreibgeschützt) Ein Link, der im Microsoft Teams-Client zu dem Team führt. Dies ist die URL, die Sie erhalten, wenn Sie im Microsoft Teams-Client mit der rechten Maustaste auf ein Team klicken und Link zum Team abrufen auswählen. Diese URL sollte als nicht transparenter Blob behandelt und nicht analysiert werden.

Instanzenattribute

Instanzattribute sind Eigenschaften mit besonderem Verhalten. Diese Eigenschaften sind temporär und definieren entweder a) das Verhalten, das der Dienst ausführen soll, oder b) stellen kurzfristige Eigenschaftswerte bereit, z. B. eine Download-URL für ein Element, das abläuft.

Eigenschaftenname Typ Beschreibung
@microsoft.graph.teamCreationMode Zeichenfolge Gibt an, dass sich das Team im Migrationszustand befindet und zurzeit für Migrationszwecke verwendet wird. Akzeptiert einen Wert: migration. Hinweis: Microsoft kann in Zukunft von Ihnen oder Ihren Kunden fordern, basierend auf der Menge der importierten Daten, zusätzliche Gebühren zu zahlen.

Ein Beispiel für eine POST-Anforderung finden Sie unter Anforderung (Team im Migrationszustand erstellen).

Beziehungen

Beziehung Typ Beschreibung
allChannels channel-Sammlung Liste der Kanäle, die entweder im Team gehostet oder für das Team freigegeben wurden (eingehende Kanäle).
channels channel-Sammlung Die Sammlung von Kanälen und Nachrichten, die dem Team zugeordnet sind.
incomingChannels channel-Sammlung Liste der Kanäle, die für das Team freigegeben sind.
installedApps teamsAppInstallation-Sammlung Die in diesem Team installierten Apps.
members conversationMember-Sammlung Mitglieder und Besitzer des Teams.
operations teamsAsyncOperation-Auflistung Die asynchronen Vorgänge, die ausgeführt wurden oder in diesem Team ausgeführt werden.
Foto profilePhoto Das Profilfoto für das Team.
primaryChannel channel Der allgemeine Kanal für das Team.
Zeitplan Zeitplan Der Schichtzeitplan für dieses Team.
tags teamworkTag-Sammlung Die Tags, die dem Team zugeordnet sind.
template teamsTemplate Die Vorlage, von der dieses Team erstellt wurde. Siehe Verfügbare Vorlagen.
permissionGrants resourceSpecificPermissionGrant-Sammlung Eine Sammlung von Berechtigungen, die Apps erteilt wurden, um auf das Team zuzugreifen.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

Hinweis: wenn das Team den Typ „Klasse“ hat, wird eine classSettings-Eigenschaft auf das Team angewendet.

{
  "classSettings": {"@odata.type": "microsoft.graph.teamClassSettings"},
  "classification": "String",
  "createdDateTime": "DateTimeOffset",
  "description": "String",
  "displayName": "String",
  "funSettings": {"@odata.type": "microsoft.graph.teamFunSettings"},
  "guestSettings": {"@odata.type": "microsoft.graph.teamGuestSettings"},
  "internalId": "String",
  "isArchived": "Boolean",
  "memberSettings": {"@odata.type": "microsoft.graph.teamMemberSettings"},
  "messagingSettings": {"@odata.type": "microsoft.graph.teamMessagingSettings"},
  "specialization": "String",
  "tenantId": "String",
  "visibility": "String",
  "webUrl": "String (URL)"
}