team-Ressourcentypteam resource type

Namespace: microsoft.graphNamespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported. Um zu ermitteln, ob eine API in v 1.0 verfügbar ist, verwenden Sie die Versions Auswahl.To determine whether an API is available in v1.0, use the Version selector.

Ein Team in Microsoft Teams ist eine Sammlung von Kanal-Objekten.A team in Microsoft Teams is a collection of channel objects. Ein Kanal stellt ein Thema und somit eine logische Trennung einer Unterhaltung in einem Team dar.A channel represents a topic, and therefore a logical isolation of discussion, within a team.

Jedes Team wird einer Gruppe zugeordnet.Every team is associated with a group. Die Gruppe hat die gleiche ID wie das Team – /groups/{id}/team ist z. B. identisch mit /teams/{id}.The group has the same ID as the team - for example, /groups/{id}/team is the same as /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.For more information about working with groups and members in teams, see Use the Microsoft Graph REST API to work with Microsoft Teams.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
Team erstellenCreate team teamsAsyncOperationteamsAsyncOperation Erstellen eines von Grund auf neuen Teams.Create a team from scratch.
Team aus Gruppe erstellenCreate team from group teamteam Erstellen eines neuen Teams oder Hinzufügen eines Teams zu einer vorhandenen Gruppe.Create a new team, or add a team to an existing group.
Team abrufenGet team teamteam Abrufen der Eigenschaften und Beziehungen des angegebenen Teams.Retrieve the properties and relationships of the specified team.
Team aktualisierenUpdate team teamteam Aktualisieren der Eigenschaften des angegebenen Teams.Update the properties of the specified team.
Team löschenDelete team KeineNone Löschen des Teams und der zugehörigen Gruppe.Delete the team and its associated group.
Mitglieder auflistenList members conversationMember-SammlungconversationMember collection Mitgliederliste des Teams abrufen.Get the list of members in the team.
Add memberAdd member conversationMemberconversationMember Neues Mitglied zum Team hinzufügen.Add a new member to the team.
Massenhinzufügen von MitgliedernAdd members in bulk actionResultPart-SammlungactionResultPart collection Hinzufügen von mehreren Mitgliedern zu dem Team im Rahmen einer einzigen Anforderung.Add multiple members to the team in a single request.
Mitglied abrufenGet member conversationMember-SammlungconversationMember collection Mitglied des Teams abrufen.Get a member in the team.
Rolle eines Mitglieds aktualisierenUpdate member's role conversationMemberconversationMember Ändern einer Rolle zu „Besitzer“ oder zurück zu „reguläres Mitglied“.Change a member to an owner or back to a regular member.
Mitglied entfernenRemove member KeineNone Vorhandenes Mitglied aus dem Team entfernen.Remove an existing member from the team.
Team archivierenArchive team teamsAsyncOperationteamsAsyncOperation Versetzen des Teams in einen schreibgeschützten Zustand.Put the team in a read-only state.
Archivierung von Team aufhebenUnarchive team teamsAsyncOperationteamsAsyncOperation Zurückversetzen des Teams in den Zustand Lesen/Schreiben.Restore the team to a read-write state.
Team klonenClone team teamsAsyncOperationteamsAsyncOperation Kopieren des Teams und der zugehörigen Gruppe.Copy the team and its associated group.
Ihre Teams auflistenList your teams team-Sammlungteam collection Auflisten der Teams, in denen Sie Mitglied sind.List the teams you are a member of.
Get Team-Foto abrufenGet team photo BinärdatenBinary data Abrufen des Fotos (Bildes) für ein Team.Get the photo (picture) for a team.
Migration abschließenComplete migration teamteam Der Migrationsmodus wird vom Team entfernt, und das Team wird den Benutzern zur Verfügung gestellt, um Nachrichten bereitzustellen und zu lesen.Removes migration mode from the team and makes the team available to users to post and read messages.
Im Team installierte Apps auflistenList apps installed in team teamsAppInstallation-SammlungteamsAppInstallation collection In einem Team installierte Apps auflisten.List apps installed in a team.
App zu Team hinzufügenAdd app to team KeineNone Fügen Sie eine App (durch Installation) zu einem Team hinzu.Add (install) an app to a team.
Im Team installierte App abrufenGet app installed in team teamsAppInstallationteamsAppInstallation Rufen Sie die angegebene in einem Team installierte App auf.Get the specified app installed in a team.
Im Team installierte App aktualisierenUpgrade app installed in team KeineNone Aktualisieren Sie die in einem Team installierte App auf die neueste Version.Upgrade the app installed in a team to the latest version.
App aus Team entfernenRemove app from team KeineNone Entfernen Sie eine App (durch Deinstallation) aus einem Team.Remove (uninstall) an app from a team.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
displayNamedisplayName stringstring Der Name des Teams.The name of the team.
descriptiondescription stringstring Eine optionale Beschreibung für das Team.An optional description for the team.
classificationclassification stringstring Eine optionale Bezeichnung.An optional label. Beschreibt in der Regel die Daten- oder Geschäftssensitivität des Teams.Typically describes the data or business sensitivity of the team. Muss mit einem der im Verzeichnis des Mandanten vorkonfigurierten Sätze übereinstimmen.Must match one of a pre-configured set in the tenant's directory.
specializationspecialization teamSpecializationteamSpecialization Optional.Optional. Gibt an, ob das Team für einen bestimmten Anwendungsfall vorgesehen ist.Indicates whether the team is intended for a particular use case. Jede Teamspezialisierung hat Zugriff auf eindeutige Verhaltensweisen und Oberflächen, die auf den Anwendungsfall zugeschnitten sind.Each team specialization has access to unique behaviors and experiences targeted to its use case.
visibilityvisibility teamVisibilityTypeteamVisibilityType Die Sichtbarkeit der Gruppe und des Teams.The visibility of the group and team. Der Standardwert ist „öffentlich“.Defaults to Public.
funSettingsfunSettings teamFunSettingsteamFunSettings Einstellungen zum Konfigurieren der Verwendung von Giphy, Memen und Aufklebern im Team.Settings to configure use of Giphy, memes, and stickers in the team.
guestSettingsguestSettings teamGuestSettingsteamGuestSettings Einstellungen zum Konfigurieren, ob Gäste Kanäle im Team erstellen, aktualisieren oder löschen können.Settings to configure whether guests can create, update, or delete channels in the team.
internalIdinternalId Zeichenfolgestring Eine eindeutige ID für das Team, das an einigen Stellen verwendet wurde, zum Beispiel Überwachungsprotokoll/Office 365-Verwaltungsaktivitäts-API.A unique ID for the team that has been used in a few places such as the audit log/Office 365 Management Activity API.
isArchivedisArchived BooleschBoolean Gibt an, ob sich das Team im schreibgeschützten Modus befindet.Whether this team is in read-only mode.
memberSettingsmemberSettings teamMemberSettingsteamMemberSettings Einstellungen zum Konfigurieren, ob Mitglieder bestimmte Aktionen, z. B. Kanäle erstellen und Bots hinzufügen, im Team ausführen können.Settings to configure whether members can perform certain actions, for example, create channels and add bots, in the team.
messagingSettingsmessagingSettings teamMessagingSettingsteamMessagingSettings Einstellungen zum Konfigurieren von Messaging und Erwähnungen im Team.Settings to configure messaging and mentions in the team.
discoverySettingsdiscoverySettings teamDiscoverySettingsteamDiscoverySettings Einstellungen zum Konfigurieren der Team-Auffindbarkeit durch andere Personen.Settings to configure team discoverability by others.
webUrlwebUrl string (schreibgeschützt)string (readonly) Ein Link, der im Microsoft Teams-Client zu dem Team führt.A hyperlink that will go to the team in the Microsoft Teams client. 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.This is the URL that you get when you right-click a team in the Microsoft Teams client and select Get link to team. Diese URL sollte als nicht transparenter Blob behandelt und nicht analysiert werden.This URL should be treated as an opaque blob, and not parsed.
classSettingsclassSettings teamClassSettingsteamClassSettings Konfigurieren von Einstellungen einer Klasse.Configure settings of a class. Nur verfügbar, wenn das Team eine Klasse darstellt.Available only when the team represents a class.
isMembershipLimitedToOwnersisMembershipLimitedToOwners Boolescher WertBoolean Wenn die Einstellung auf true gesetzt ist, befindet sich das Team derzeit im Zustand der Teammitgliedschaft nur für den Besitzer und ist für andere Teammitglieder, z. B. Studenten, nicht zugänglich.If set to true, the team is currently in the owner-only team membership state and not accessible by other team members, such as students.
createdDateTimecreatedDateTime dateTimeOffsetdateTimeOffset Schreibgeschützt.Read only. Zeitstempel für den Zeitpunkt, an dem das Team erstellt wurde.Timestamp at which the team was created.

InstanzenattributeInstance attributes

Instanzenattribute sind Eigenschaften mit speziellem Verhalten. Diese Eigenschaften sind temporär. Sie definieren entweder, wie sich der Dienst verhalten soll, oder geben kurzfristige Eigenschaftswerte an, beispielsweise URLs zum Elementdownload, die ablaufen.Instance attributes are properties with special behaviors. These properties are temporary and either a) define behavior the service should perform or b) provide short-term property values, like a download URL for an item that expires.

EigenschaftennameProperty name TypType BeschreibungDescription
@microsoft.graph.teamCreationMode@microsoft.graph.teamCreationMode Zeichenfolgestring Gibt an, dass sich das Team im Migrationszustand befindet und zurzeit für Migrationszwecke verwendet wird.Indicates that the team is in migration state and is currently being used for migration purposes. Akzeptiert einen Wert: migration.It accepts one value: migration.

Ein Beispiel für eine POST-Anforderung finden Sie unter Anforderung (Team im Migrationszustand erstellen).For a POST request example, see Request (create team in migration state).

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
channelschannels channel-Sammlungchannel collection Die Sammlung von Kanälen und Nachrichten, die mit dem Team verknüpft ist.The collection of channels & messages associated with the team.
installedAppsinstalledApps teamsAppInstallation-SammlungteamsAppInstallation collection Die in diesem Team installierten Apps.The apps installed in this team.
membersmembers conversationMember-SammlungconversationMember collection Mitglieder und Besitzer des Teams.Members and owners of the team.
ownersowners useruser Die Liste der Besitzer des Teams.The list of this team's owners. Derzeit muss beim Erstellen eines Teams mit Anwendungsberechtigungen genau ein Besitzer angegeben werden.Currently, when creating a team using application permissions, exactly one owner must be specified. Bei Verwendung von benutzerdelegierten Berechtigungen kann kein Besitzer angegeben werden (der aktuelle Benutzer ist der Besitzer).When using user delegated permissions, no owner can be specified (the current user is the owner). Der Besitzer muss als Objekt-ID (GUID) und nicht als UPN angegeben werden.Owner must be specified as an object ID (GUID), not a UPN.
operationsoperations teamsAsyncOperation-AuflistungteamsAsyncOperation collection Die asynchronen Vorgänge, die ausgeführt wurden oder in diesem Team ausgeführt werden.The async operations that ran or are running on this team.
Fotophoto profilePhotoprofilePhoto Das Team-Foto.The team photo.
primaryChannelprimaryChannel channelchannel Der allgemeine Kanal für das Team.The general channel for the team.
Zeitplanschedule Zeitplanschedule Der Schichtzeitplan für dieses Team.The schedule of shifts for this team.
templatetemplate teamsTemplateteamsTemplate Die Vorlage, von der dieses Team erstellt wurde.The template this team was created from. Siehe Verfügbare Vorlagen.See available templates.

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.The following is a JSON representation of the resource.

Hinweis: wenn das Team den Typ „Klasse“ hat, wird eine classSettings-Eigenschaft auf das Team angewendet.Note: If the team is of type class, a classSettings property is applied on the team.

{
  "guestSettings": {"@odata.type": "microsoft.graph.teamGuestSettings"},
  "memberSettings": {"@odata.type": "microsoft.graph.teamMemberSettings"},
  "messagingSettings": {"@odata.type": "microsoft.graph.teamMessagingSettings"},
  "funSettings": {"@odata.type": "microsoft.graph.teamFunSettings"},
  "discoverySettings": {"@odata.type": "microsoft.graph.teamDiscoverySettings"},
  "internalId": "string",
  "isArchived": false,
  "webUrl": "string (URL)",
  "displayName": "string",
  "description": "string",
  "classification": "string",
  "specialization": "string",
  "visibility": "string",
  "classSettings": {"@odata.type": "microsoft.graph.teamClassSettings"},
  "isMembershipLimitedToOwners":"boolean",
  "createdDateTime": "string (timestamp)"
}

Weitere Informationen:See also