Gruppen-Ressourcentypgroup resource type

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.

Stellt eine Azure Active Directory (Azure AD)-Gruppe dar, bei der es sich um eine Office 365-Gruppe, ein Team in Microsoft Teams oder eine Sicherheitsgruppe handeln kann. Erbt von directoryObject.Represents an Azure Active Directory (Azure AD) group, which can be an Office 365 group, a team in Microsoft Teams, a dynamic group, or a security group. Inherits from directoryObject.

Aus Leistungsgründen geben die Vorgänge create, get und list standardmäßig nur eine Teilmenge häufig verwendeter Eigenschaften zurück.For performance reasons, the create, get, and list operations return only a subset of more commonly used properties by default. Diese _Standard_eigenschaften werden im Abschnitt Eigenschaften aufgeführt.These default properties are noted in the Properties section. Zum Abrufen von Eigenschaften, die nicht standardmäßig zurückgegeben werden, geben sie diese in einer OData-Abfrageoption $select an.To get any of the properties that are not returned by default, specify them in a $select OData query option. Sehen Sie sich das Beispiel an.See an example.

Diese Ressource unterstützt Folgendes:This resource supports:

Microsoft Teams- und Office 365-Gruppen unterstützen Gruppenzusammenarbeit.Microsoft Teams and Office 365 groups support group collaboration. Der Großteil der Office 365-Gruppen-API kann mit Microsoft Teams verwendet werden.You can use most of the Office 365 groups API with Microsoft Teams. Um ein Team zu erstellen, müssen Sie zuerst eine Gruppe erstellen und dann ein Team zur Gruppe hinzufügen.To create a team, first create group and then add a team to it. Weitere Informationen finden Sie in der Übersicht über Microsoft Teams.For details, see the Microsoft Teams overview.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
GruppenverwaltungGroup management
Gruppe erstellenCreate group groupgroup Erstellt eine neue Gruppe gemäß den Angaben.Create a new group as specified. Dabei kann es sich um eine Office 365-Gruppe, eine dynamische Gruppe, eine Sicherheitsgruppe oder ein Team handeln.It can be an Office 365 group, dynamic group, security group, or team.
Gruppe abrufenGet group groupgroup Dient zum Lesen der Eigenschaften und der Beziehungen des group-Objekts.Read properties and relationships of group object.
Gruppe aktualisierenUpdate group KeineNone Aktualisiert die Eigenschaften eines Gruppenobjekts.Update the properties of a group object.
Gruppe löschenDelete group KeinerNone Löscht das Gruppenobjekt.Delete group object.
deltadelta group-Sammlunggroup collection Dient zum Abrufen inkrementeller Änderungen für Gruppen.Get incremental changes for groups.
List groupLifecyclePoliciesList groupLifecyclePolicies groupLifecyclePolicy-SammlunggroupLifecyclePolicy collection Dient zum Auflisten der Gruppenlebenszyklusrichtlinien.List group lifecycle policies.
Besitzer auflistenList owners directoryObject-SammlungdirectoryObject collection Ruft die Besitzer der Gruppe aus der owners-Navigationseigenschaft ab.Get the owners of the group from the owners navigation property.
Besitzer hinzufügenAdd owner directoryObjectdirectoryObject Fügt einen neuen Besitzer zur Gruppe durch Bereitstellen an die owners-Navigationseigenschaft hinzu (wird nur für Sicherheitsgruppen und E-Mail-fähige Sicherheitsgruppen unterstützt).Add a new owner for the group by posting to the owners navigation property (supported for security groups and mail-enabled security groups only).
Besitzer entfernenRemove owner KeinerNone Entfernt einen Besitzer aus einer Office 365-Gruppe, einer Sicherheitsgruppe oder einer E-Mail-fähigen Sicherheitsgruppe über die owners-Navigationseigenschaft.Remove an owner from an Office 365 group, a security group or a mail-enabled security group through the owners navigation property.
Mitglieder auflistenList members directoryObject-SammlungdirectoryObject collection Ruft die Benutzer und Gruppen, die direkte Mitglieder dieser Gruppe sind, aus der members-Navigationseigenschaft ab.Get the users and groups that are direct members of this group from the members navigation property.
Transitive Mitglieder auflistenList transitive members directoryObject-SammlungdirectoryObject collection Ruft die Benutzer, Gruppen, Geräte und Dienstprinzipale ab, die Mitglieder sind, einschließlich der geschachtelten Mitglieder dieser Gruppe.Get the users, groups, devices, and service principals that are members, including nested members of this group.
Mitglied hinzufügenAdd member directoryObjectdirectoryObject Fügt dieser Gruppe einen Benutzer oder eine Gruppe durch Bereitstellung an die members-Navigationseigenschaft hinzu (wird nur für Sicherheitsgruppen und E-Mail-fähige Sicherheitsgruppen unterstützt).Add a user or group to this group by posting to the members navigation property (supported for security groups and mail-enabled security groups only).
Mitglied entfernenRemove member KeineNone Entfernt ein Mitglied aus einer Office 365-Gruppe, einer Sicherheitsgruppe oder einer E-Mail-fähigen Sicherheitsgruppe anhand der members-Navigationseigenschaft. Sie können Benutzer oder andere Gruppen entfernen.Remove a member from an Office 365 group, a security group or a mail-enabled security group through the members navigation property. You can remove users or other groups.
memberOf auflistenList memberOf directoryObject-SammlungdirectoryObject collection Ruft die Gruppen und administrativen Einheiten, in denen diese Gruppe ein direktes Mitglied ist, aus der memberOf-Navigationseigenschaft ab.Get the groups and administrative units that this group is a direct member of from the memberOf navigation property.
Transitive memberOf auflistenList transitive memberOf directoryObject-SammlungdirectoryObject collection Listet die Gruppen und administrativen Einheiten auf, bei denen der Benutzer Mitglied ist.List the groups and administrative units that this user is a member of. Dieser Vorgang ist transitiv und schließt die Gruppen ein, in denen diese Gruppe ein geschachteltes Mitglied.This operation is transitive and includes the groups that this group is a nested member of.
checkMemberGroupscheckMemberGroups ZeichenfolgenauflistungString collection Sucht nach einer Mitgliedschaft in einer Liste von Gruppen. Die Funktion ist transitiv.Check for membership in a list of groups. The function is transitive.
getMemberGroupsgetMemberGroups String collectionString collection Gibt alle Gruppen zurück, bei denen die Gruppe Mitglied ist. Die Funktion ist transitiv.Return all the groups that the group is a member of. The function is transitive.
getMemberObjectsgetMemberObjects ZeichenfolgenauflistungString collection Gibt alle Gruppen und administrativen Einheiten zurück, in denen der Benutzer Mitglied ist. Die Funktion ist transitiv.Return all of the groups and administrative units that the group is a member of. The function is transitive.
Einstellung erstellenCreate setting directorySettingdirectorySetting Erstellt ein Einstellungsobjekt basierend auf einer directorySettingTemplate. Die POST-Anforderung muss settingValues für alle Einstellungen angeben, die in der Vorlage definiert sind. Für diesen Vorgang können nur gruppenspezifische Vorlagen verwendet werden.Create a setting object based on a directorySettingTemplate. The POST request must provide settingValues for all the settings defined in the template. Only groups specific templates may be used for this operation.
Einstellung abrufenGet setting directorySettingdirectorySetting Dient zum Lesen der Eigenschaften eines bestimmten Einstellungsobjekts.Read properties of a specific setting object.
Einstellungen auflistenList settings directorySetting collectiondirectorySetting collection Listet Eigenschaften aller Einstellungsobjekte auf.List properties of all setting objects.
Einstellung aktualisierenUpdate setting directorySettingdirectorySetting Aktualisiert ein Einstellungsobjekt.Update a setting object.
Einstellung löschenDelete setting KeineNone Löscht ein Einstellungsobjekt.Delete a setting object.
Endpunkte auflistenList endpoints endpoint-Sammlungendpoint collection Ruft eine Endpunktobjektsammlung ab.Get an endpoint object collection.
Endpunkt abrufenGet endpoint endpointendpoint Dient zum Lesen der Eigenschaften und der Beziehungen des endpoint-Objekts.Read properties and relationships of an endpoint object.
deltadelta group-Sammlunggroup collection Ruft inkrementelle Änderungen für Gruppen ab.Get incremental changes for groups.
validatePropertiesvalidateProperties JSONJSON Überprüft, ob der Anzeigename oder E-Mail-Kontoname einer Office 365-Gruppe den Benennungsrichtlinien entspricht.Validate an Office 365 group's display name or mail nickname complies with naming policies.
CalendarCalendar
Ereignis erstellenCreate event Ereignisevent Erstellt ein neues Ereignis durch Veröffentlichen in der Ereignissammlung.Create a new event by posting to the events collection.
Ereignis abrufenGet event Ereignisevent Liest die Eigenschaften eines Ereignisobjekts.Read properties of an event object.
Ereignisse auflistenList events Ereignissammlungevent collection Ruft eine Ereignisobjektsammlung ab.Get an event object collection.
Ereignis aktualisierenUpdate event KeineNone Dient zum Aktualisieren der Eigenschaften eines Ereignisobjekts.Update the properties of an event object.
Ereignis löschenDelete event KeineNone Löscht das Ereignisobjekt.Delete event object.
calendarView auflistenList calendarView Ereignissammlungevent collection Ruft eine Auflistung der Ereignisse in einem angegebenen Zeitfenster ab.Get a collection of events in a specified time window.
UnterhaltungenConversations
Unterhaltung erstellenCreate conversation Unterhaltungconversation Erstellt eine neue Unterhaltung durch Veröffentlichung in der Unterhaltungssammlung.Create a new conversation by posting to the conversations collection.
Unterhaltung abrufenGet conversation Unterhaltungconversation Dient zum Lesen der Eigenschaften eines Unterhaltungsobjekts.Read properties of a conversation object.
Unterhaltungen auflistenList conversations Unterhaltungssammlungconversation collection Ruft eine Unterhaltungsobjektsammlung ab.Get a conversation object collection.
Unterhaltung löschenDelete conversation KeineNone Löscht ein Unterhaltungsobjekt.Delete conversation object.
Thread abrufenGet thread conversationThreadconversationThread Liest die Eigenschaften eines Threadobjekts.Read properties of a thread object.
Threads auflistenList threads conversationThread-SammlungconversationThread collection Ruft alle Threads einer Gruppe ab.Get all the threads of a group.
Thread aktualisierenUpdate thread KeineNone Aktualisiert die Eigenschaften eines Threadobjekts.Update properties of a thread object.
Thread löschenDelete thread KeineNone Löscht das Threadobjekt.Delete thread object
acceptedSenders auflistenList acceptedSenders directoryObject collectiondirectoryObject collection Ruft eine Liste von Benutzern oder Gruppen ab, die sich in der Liste der accepted-senders für diese Gruppe befinden.Get a list of users or groups that are in the accepted-senders list for this group.
acceptedSender hinzufügenAdd acceptedSender directoryObjectdirectoryObject Fügt einen Benutzer oder eine Gruppe zur acceptSenders-Sammlung hinzu.Add a User or Group to the acceptSenders collection.
acceptedSender entfernenRemove acceptedSender directoryObjectdirectoryObject Entfernt einen Benutzer oder eine Gruppe aus der acceptedSenders-Sammlung.Remove a User or Group from the acceptedSenders collection.
rejectedSenders auflistenList rejectedSenders directoryObject collectiondirectoryObject collection Ruft eine Liste von Benutzern oder Gruppen ab, die sich in der Liste der rejected-senders für diese Gruppe befinden.Get a list of users or groups that are in the rejected-senders list for this group.
rejectedSender hinzufügenAdd rejectedSender directoryObjectdirectoryObject Fügt einen neuen Benutzer oder eine neue Gruppe zur rejectedSender-Sammlung hinzu.Add a new User or Group to the rejectedSenders collection.
rejectedSender entfernenRemove rejectedSender directoryObjectdirectoryObject Entfernt einen neuen Benutzer oder eine neue Gruppe aus der rejectedSenders-Sammlung.Remove new new User or Group from the rejectedSenders collection.
Offene ErweiterungenOpen extensions
Offene Erweiterung erstellenCreate open extension openTypeExtensionopenTypeExtension Erstellt eine offene Erweiterung und fügt benutzerdefinierte Eigenschaften zu einer neuen oder vorhandenen Ressource hinzu.Create an open extension and add custom properties to a new or existing resource.
Offene Erweiterung abrufenGet open extension openTypeExtension-SammlungopenTypeExtension collection Dient zum Abrufen einer offenen Erweiterung, die durch den Erweiterungsnamen identifiziert wird.Get an open extension identified by the extension name.
SchemaerweiterungenSchema extensions
Schemaerweiterungswerte hinzufügenAdd schema extension values Dient zum Erstellen einer Schemaerweiterungsdefinition und anschließenden Verwenden der Definition zum Hinzufügen benutzerdefinierter typisierter Daten zu einer Ressource.Create a schema extension definition and then use it to add custom typed data to a resource.
Andere GruppenressourcenOther group resources
Fotos auflistenList photos profilePhoto-SammlungprofilePhoto collection Ruft eine Sammlung von Profilfotos für die Gruppe ab.Get a collection of profile photos for the group.
plannerPlans auflistenList plannerPlans plannerPlan-SammlungplannerPlan collection Ruft Plannerer-Pläne im Besitz der Gruppe ab.Get Planner plans owned by the group.
BenutzereinstellungenUser settings
addFavoriteaddFavorite KeineNone Fügt die Gruppe zu der Liste der Favoritengruppen des angemeldeten Benutzers hinzu.Add the group to the list of the signed-in user's favorite groups. Wird nur für Office 365-Gruppen unterstützt.Supported for only Office 365 groups.
removeFavoriteremoveFavorite KeineNone Entfernt die Gruppe aus der Liste der Favoritengruppen des angemeldeten Benutzers.Remove the group from the list of the signed-in user's favorite groups. Wird nur für Office 365-Gruppen unterstützt.Supported for Office 365 Groups only.
memberOf auflistenList memberOf directoryObject-SammlungdirectoryObject collection Ruft die Gruppen und administrativen Einheiten, bei denen dieser Benutzer direktes Mitglied ist, aus der memberOf-Navigationseigenschaft ab.Get the groups and administative units that this user is a direct member of, from the memberOf navigation property.
joinedTeams auflistenList joinedTeams group-Sammlunggroup collection Ruft die Microsoft-Teams an, in denen der Benutzer ein direktes Mitglied ist.Get the Microsoft Teams that the user is a direct member of.
subscribeByMailsubscribeByMail KeinerNone Legt die isSubscribedByMail-Eigenschaft auf true fest.Set the isSubscribedByMail property to true. Aktiviert den angemeldeten Benutzer für den Erhalt von E-Mail-Unterhaltungen.Enabling the signed-in user to receive email conversations. Wird nur für Office 365-Gruppen unterstützt.Supported for Office 365 Groups only.
unsubscribeByMailunsubscribeByMail KeinerNone Legt die isSubscribedByMail-Eigenschaft auf false fest.Set the isSubscribedByMail property to false. Deaktiviert den angemeldeten Benutzer für den Erhalt von E-Mail-Unterhaltungen.Disabling the signed-in user from receive email conversations. Wird nur für Office 365-Gruppen unterstützt.Supported for Office 365 Groups only.
resetUnseenCountresetUnseenCount KeineNone Setzt das unseenCount-Element aller Beiträge, die der angemeldete Benutzer seit dem letzten Besuch noch nicht gesehen hat, auf 0 zurück.Reset the unseenCount to 0 of all the posts that the signed-in user has not seen since their last visit. Wird nur für Office 365-Gruppen unterstützt.Supported for Office 365 Groups only.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
allowExternalSendersallowExternalSenders BooleschBoolean Gibt an, ob Personen außerhalb der Organisation Nachrichten an die Gruppe senden können.Indicates if people external to the organization can send messages to the group. Der Standardwert lautet false.Default value is false.

Wird nur für $select zurückgegeben.Returned only on $select.
assignedLabelsassignedLabels assignedLabel-SammlungassignedLabel collection Die Liste der Vertraulichkeitsbezeichnungspaare (Bezeichnungs-ID, Bezeichnungsname), die einer Office 365-Gruppe zugeordnet sind.The list of sensitivity label pairs (label ID, label name) associated with an Office 365 group.

Wird nur für $select zurückgegeben.Returned only on $select. Schreibgeschützt.Read-only.
assignedLicensesassignedLicenses assignedLicense-SammlungassignedLicense collection Die Lizenzen, die der Gruppe zugewiesen sind.The licenses that are assigned to the group.

Wird nur für $select zurückgegeben.Returned only on $select. Schreibgeschützt.Read-only.
autoSubscribeNewMembersautoSubscribeNewMembers BooleschBoolean Gibt an, ob neu zur Gruppe hinzugefügte Mitglieder automatisch E-Mail-Benachrichtigungen erhalten.Indicates if new members added to the group will be auto-subscribed to receive email notifications. Sie können diese Eigenschaft in einer PATCH-Anforderung für die Gruppe festlegen; legen Sie sie nicht in der anfänglichen POST-Anforderung fest, mit der die Gruppe erstellt wird.You can set this property in a PATCH request for the group; do not set it in the initial POST request that creates the group. Der Standardwert lautet false.Default value is false.

Wird nur für $select zurückgegeben.Returned only on $select.
classificationclassification ZeichenfolgeString Beschreibt eine Klassifizierung für die Gruppe (z. B. niedrige, mittlere oder hohe geschäftliche Auswirkungen). Gültige Werte für diese Eigenschaft werden durch die Erstellung eines ClassificationList-setting-Werts basierend auf der Vorlagendefinition erstellt.Describes a classification for the group (such as low, medium or high business impact). Valid values for this property are defined by creating a ClassificationList setting value, based on the template definition.

Wird standardmäßig zurückgegeben.Returned by default.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Zeitstempel der Gruppenerstellung.Timestamp of when the group was created. Der Wert kann nicht geändert werden und wird automatisch ausgefüllt, wenn die Gruppe erstellt wird.The value cannot be modified and is automatically populated when the group is created. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'.For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

Wird standardmäßig zurückgegeben.Returned by default. Schreibgeschützt.Read-only.
descriptiondescription StringString Eine optionale Beschreibung für die Gruppe.An optional description for the group.

Wird standardmäßig zurückgegeben.Returned by default.
displayNamedisplayName ZeichenfolgeString Der Anzeigename der Gruppe.The display name for the group. Diese Eigenschaft ist beim Erstellen einer Gruppe erforderlich und kann bei Updates nicht gelöscht werden.This property is required when a group is created and cannot be cleared during updates.

Wird standardmäßig zurückgegeben.Returned by default. Unterstützt $filter und $orderby.Supports $filter and $orderby.
expirationDateTimeexpirationDateTime DateTimeOffsetDateTimeOffset Zeitstempel des festgelegten Ablaufs der Gruppe.Timestamp of when the group is set to expire. Der Wert kann nicht geändert werden und wird automatisch ausgefüllt, wenn die Gruppe erstellt wird.The value cannot be modified and is automatically populated when the group is created. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'.For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

Wird standardmäßig zurückgegeben.Returned by default. Schreibgeschützt.Read-only.
groupTypesgroupTypes ZeichenfolgensammlungString collection Gibt den Typ und die Mitgliedschaft der Gruppe an.Specifies the group type and its membership.

Wenn die Sammlung Unified enthält, dann handelt es sich bei der Gruppe um eine Office 365-Gruppe, andernfalls um eine Sicherheitsgruppe.If the collection contains Unified then the group is an Office 365 group; otherwise it's a security group.

Wenn die Sammlung DynamicMembership enthält, verfügt die Gruppe über eine dynamische Mitgliedschaft, andernfalls ist die Mitgliedschaft statisch.If the collection includes DynamicMembership, the group has dynamic membership; otherwise, membership is static.

Wird standardmäßig zurückgegeben.Returned by default. Unterstützt $filter.Supports $filter.
hasMembersWithLicenseErrorshasMembersWithLicenseErrors BooleschBoolean Gibt an, ob es in dieser Gruppe Mitglieder mit Lizenzfehlern aus ihrer gruppenbasierten Lizenzzuweisung gibt.Indicates whether there are members in this group that have license errors from its group-based license assignment.

Diese Eigenschaft wird nie bei einem GET-Vorgang zurückgegeben.This property is never returned on a GET operation. Sie können sie als $filter-Argument verwenden, um Gruppen abzurufen, die Mitglieder mit Lizenzfehlern enthalten (d. h., Sie filtern nach dieser Eigenschaft mit dem Wert true).You can use it as a $filter argument to get groups that have members with license errors (that is, filter for this property being true). Sehen Sie sich das Beispiel an.See an example.
idid ZeichenfolgeString Eindeutiger Bezeichner für die Gruppe.The unique identifier for the group.

Wird standardmäßig zurückgegeben.Returned by default. Geerbt von directoryObject.Inherited from directoryObject. Key.Key. Lässt keine Nullwerte zu.Not nullable. Schreibgeschützt.Read-only.
isSubscribedByMailisSubscribedByMail BooleschBoolean Gibt an, ob der angemeldete Benutzer den Erhalt von E-Mail-Unterhaltungen abonniert hat.Indicates whether the signed-in user is subscribed to receive email conversations. Der Standardwert ist true.Default value is true.

Wird nur für $select zurückgegeben.Returned only on $select.
licenseProcessingStatelicenseProcessingState ZeichenfolgeString Gibt den Status der Gruppenlizenzzuweisung an alle Mitglieder der Gruppe an.Indicates status of the group license assignment to all members of the group. Mögliche Werte: QueuedForProcessing, ProcessingInProgress und ProcessingComplete.Possible values: QueuedForProcessing, ProcessingInProgress, and ProcessingComplete.

Wird nur für $select zurückgegeben.Returned only on $select. Schreibgeschützt.Read-only.
mailmail ZeichenfolgeString Die SMTP-Adresse für die Gruppe, z. B. „serviceadmins@contoso.onmicrosoft.com“.The SMTP address for the group, for example, "serviceadmins@contoso.onmicrosoft.com".

Wird standardmäßig zurückgegeben.Returned by default. Schreibgeschützt.Read-only. Unterstützt $filter.Supports $filter.
mailEnabledmailEnabled BooleanBoolean Gibt an, ob es sich bei der Gruppe um eine E-Mail-fähige Gruppe handelt.Specifies whether the group is mail-enabled.

Wird standardmäßig zurückgegeben.Returned by default.
mailNicknamemailNickname ZeichenfolgeString Der E-Mail-Alias für die Gruppe, in der Organisation eindeutig.The mail alias for the group, unique in the organization. Diese Eigenschaft muss beim Erstellen einer Gruppe angegeben werden.This property must be specified when a group is created.

Wird standardmäßig zurückgegeben.Returned by default. Unterstützt $filter.Supports $filter.
membershipRulemembershipRule ZeichenfolgeString Die Regel, die Mitglieder dieser Gruppe bestimmt, wenn die Gruppe eine dynamische Gruppe ist (groupTypes enthält DynamicMembership).The rule that determines members for this group if the group is a dynamic group (groupTypes contains DynamicMembership). Weitere Informationen zur Syntax der Mitgliedschaftsregel finden Sie unter Regeln für eine dynamische Mitgliedschaft.For more information about the syntax of the membership rule, see Membership Rules syntax.

Wird standardmäßig zurückgegeben.Returned by default.
membershipRuleProcessingStatemembershipRuleProcessingState ZeichenfolgeString Gibt an, ob die Verarbeitung der dynamischen Mitgliedschaft aktiv ist oder angehalten wurde.Indicates whether the dynamic membership processing is on or paused. Mögliche Werte sind „On“ oder „Paused“.Possible values are "On" or "Paused".

Wird standardmäßig zurückgegeben.Returned by default.
onPremisesLastSyncDateTimeonPremisesLastSyncDateTime DateTimeOffsetDateTimeOffset Gibt den Zeitpunkt der letzten Synchronisierung des Objekts mit dem lokalen Verzeichnis an. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben.Indicates the last time at which the group was synced with the on-premises directory.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'.For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

Wird standardmäßig zurückgegeben.Returned by default. Schreibgeschützt.Read-only. Unterstützt $filter.Supports $filter.
onPremisesProvisioningErrorsonPremisesProvisioningErrors onPremisesProvisioningError-SammlungonPremisesProvisioningError collection Fehler bei Verwendung eines Microsoft-Synchronisierungsprodukts während der Bereitstellung.Errors when using Microsoft synchronization product during provisioning.

Wird standardmäßig zurückgegeben.Returned by default.
onPremisesSecurityIdentifieronPremisesSecurityIdentifier ZeichenfolgeString Enthält die lokale Sicherheits-ID (SID) für die Gruppe, die von der lokalen Bereitstellung in der Cloud synchronisiert wurde.Contains the on-premises security identifier (SID) for the group that was synchronized from on-premises to the cloud.

Wird standardmäßig zurückgegeben.Returned by default. Schreibgeschützt.Read-only.
onPremisesSyncEnabledonPremisesSyncEnabled BooleanBoolean true, wenn diese Gruppe aus einem lokalen Verzeichnis synchronisiert wird; false, wenn die Gruppe ursprünglich aus einem lokalen Verzeichnis synchronisiert wurde, aber nicht mehr synchronisiert wird; NULL, wenn dieses Objekt nie aus einem lokalen Verzeichnis synchronisiert wurde (Standard).true if this group is synced from an on-premises directory; false if this group was originally synced from an on-premises directory but is no longer synced; null if this object has never been synced from an on-premises directory (default).

Wird standardmäßig zurückgegeben.Returned by default. Schreibgeschützt.Read-only. Unterstützt $filter.Supports $filter.
preferredDataLocationpreferredDataLocation ZeichenfolgeString Der bevorzugte Datenspeicherort für die Gruppe.The preferred data location for the group. Weitere Informationen finden Sie unter OneDrive Online Multi-Geo.For more information, see OneDrive Online Multi-Geo.

Wird standardmäßig zurückgegeben.Returned by default.
preferredLanguagepreferredLanguage ZeichenfolgeString Die bevorzugte Sprache für eine Office 365-Gruppe.The preferred language for an Office 365 group. Muss im ISO 639-1-Code angegeben werden. Beispiel: „en-US“.Should follow ISO 639-1 Code; for example "en-US".

Wird standardmäßig zurückgegeben.Returned by default.
proxyAddressesproxyAddresses ZeichenfolgenauflistungString collection E-Mail-Adressen für die Gruppe, die in das gleiche Gruppenpostfach umgeleitet werden sollen.Email addresses for the group that direct to the same group mailbox. Zum Beispiel: ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"].For example: ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"]. Der any-Operator ist für Filterausdrücke für mehrwertige Eigenschaften erforderlich.The any operator is required for filter expressions on multi-valued properties.

Wird standardmäßig zurückgegeben.Returned by default. Schreibgeschützt.Read-only. Lässt keine NULL-Werte zu.Not nullable. Unterstützt $filter.Supports $filter.
renewedDateTimerenewedDateTime DateTimeOffsetDateTimeOffset Zeitstempel der letzten Verlängerung der Gruppe.Timestamp of when the group was last renewed. Dies kann nicht direkt geändert werden und wird nur über die Aktion zum Verlängern des Diensts aktualisiert.This cannot be modified directly and is only updated via the renew service action. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'.For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

Wird standardmäßig zurückgegeben.Returned by default. Schreibgeschützt.Read-only.
securityEnabledsecurityEnabled BooleanBoolean Gibt an, ob es sich bei der Gruppe um eine Sicherheitsgruppe handelt.Specifies whether the group is a security group.

Wird standardmäßig zurückgegeben.Returned by default. Unterstützt $filter.Supports $filter.
themetheme ZeichenfolgeString Gibt das Farbdesign einer Office 365-Gruppe an.Specifies an Office 365 group's color theme. Mögliche Werte sind Teal, Purple, Green, Blue, Pink, Orange oder Red.Possible values are Teal, Purple, Green, Blue, Pink, Orange or Red.

Wird standardmäßig zurückgegeben.Returned by default.
unseenConversationsCountunseenConversationsCount Int32Int32 Die Anzahl von Unterhaltungen, an die seit dem letzten Besuch des angemeldeten Benutzers bei der Gruppe ein oder mehrere neue Beiträge übermittelt wurden.Count of conversations that have been delivered one or more new posts since the signed-in user's last visit to the group. Diese Eigenschaft ist identisch mit unseenCount.This property is the same as unseenCount.

Wird nur für $select zurückgegeben.Returned only on $select.
unseenCountunseenCount Int32Int32 Die Anzahl von Unterhaltungen, die neue Beiträge erhalten haben, da der angemeldete Benutzer die Gruppe zuletzt besucht hat.Count of conversations that have received new posts since the signed-in user last visited the group. Diese Eigenschaft ist identisch mit unseenConversationsCount.This property is the same as unseenConversationsCount.

Wird nur für $select zurückgegeben.Returned only on $select.
unseenMessagesCountunseenMessagesCount Int32Int32 Die Anzahl neuer Beiträge, die seit dem letzten Besuch des angemeldeten Benutzers bei der Gruppe an die Unterhaltungen der Gruppe übermittelt wurden.Count of new posts that have been delivered to the group's conversations since the signed-in user's last visit to the group.

Wird nur für $select zurückgegeben.Returned only on $select.
visibilityvisibility ZeichenfolgeString Gibt die Sichtbarkeit einer Office 365-Gruppe an.Specifies the visibility of an Office 365 group. Mögliche Werte sind: private, public oder hiddenmembership; leere Werte werden als „public“ behandelt.Possible values are: private, public, or hiddenmembership; blank values are treated as public. Weitere Informationen finden Sie unter Sichtbarkeitsoptionen für Gruppen.See group visibility options to learn more.
Die Sichtbarkeit kann nur beim Erstellen einer Gruppe festgelegt und anschließend nicht mehr bearbeitet werden.Visibility can be set only when a group is created; it is not editable.
Sichtbarkeit wird nur für einheitliche Gruppen unterstützt. Für Sicherheitsgruppen wird sie nicht unterstützt.Visibility is supported only for unified groups; it is not supported for security groups.

Wird standardmäßig zurückgegeben.Returned by default.

Sichtbarkeitsoptionen für GruppenGroup visibility options

Im Folgenden wird die Bedeutung der einzelnen Werte der Eigenschaft visibility erläutert:Here's what each visibility property value means:

WertValue BeschreibungDescription
public Jeder kann der Gruppe beitreten, ohne dass die Berechtigung „Besitzer“ erforderlich ist.Anyone can join the group without needing owner permission.
Jeder kann die Inhalte der Gruppe anzeigen.Anyone can view the contents of the group.
private Die Berechtigung „Besitzer“ ist erforderlich, um der Gruppe beizutreten.Owner permission is needed to join the group.
Nichtmitglieder können die Inhalte der Gruppe nicht anzeigen.Non-members cannot view the contents of the group.
hiddenmembership Die Berechtigung „Besitzer“ ist erforderlich, um der Gruppe beizutreten.Owner permission is needed to join the group.
Nichtmitglieder können die Inhalte der Gruppe nicht anzeigen.Non-members cannot view the contents of the group.
Nichtmitglieder können die Mitglieder der Gruppe nicht sehen.Non-members cannot see the members of the group.
Administratoren (global, Unternehmen, Benutzer und Helpdesk) können die Mitgliedschaft der Gruppe anzeigen.Administrators (global, company, user, and helpdesk) can view the membership of the group.
Die Gruppe wird im globalen Adressbuch (GAL) angezeigt.The group appears in the global address book (GAL).

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
acceptedSendersacceptedSenders directoryObject-SammlungdirectoryObject collection Die Liste der Benutzer oder Gruppen, die berechtigt sind, Beiträge oder Kalenderereignisse in dieser Gruppe zu erstellen. Wenn diese Liste nicht leer ist, dürfen nur die hier aufgeführten Benutzer oder Gruppen Beiträge schreiben.The list of users or groups that are allowed to create post's or calendar events in this group. If this list is non-empty then only users or groups listed here are allowed to post.
Kalendercalendar Kalendercalendar Der Kalender der Gruppe. Schreibgeschützt.The group's calendar. Read-only.
calendarViewcalendarView Ereignissammlungevent collection Die Kalenderansicht für den Kalender. Schreibgeschützt.The calendar view for the calendar. Read-only.
conversationsconversations Unterhaltungssammlungconversation collection Die Unterhaltungen der GruppeThe group's conversations.
createdOnBehalfOfcreatedOnBehalfOf directoryObjectdirectoryObject Der Benutzer (bzw. die Anwendung), der/die Gruppe erstellt hat. HINWEIS: Dies ist nicht festgelegt, wenn der Benutzer ein Administrator ist. Schreibgeschützt.The user (or application) that created the group. NOTE: This is not set if the user is an administrator. Read-only.
Laufwerkdrive drivedrive Das Standardlaufwerk der Gruppe.The group's default drive. Schreibgeschützt.Read-only.
drivesdrives drive-Sammlungdrive collection Die Laufwerke der Gruppe.The group's drives. Schreibgeschützt.Read-only.
endpointsendpoints endpoint-SammlungEndpoint collection Endpunkte für die Gruppe.Endpoints for the group. Schreibgeschützt.Read-only. Nullwerte zulassend.Nullable.
eventsevents event-Sammlungevent collection Die Ereignisse der Gruppe.The group's events.
extensionsextensions extension-Sammlungextension collection Die Sammlung der für die Gruppe definierten offenen Erweiterungen. Schreibgeschützt. Nullwerte zulassend.The collection of open extensions defined for the group. Read-only. Nullable.
groupLifecyclePoliciesgroupLifecyclePolicies groupLifecyclePolicy-SammlunggroupLifecyclePolicy collection Die Sammlung der Lebenszyklusrichtlinien für diese Gruppe.The collection of lifecycle policies for this group. Schreibgeschützt.Read-only. Lässt Nullwerte zu.Nullable.
memberOfmemberOf directoryObject-SammlungdirectoryObject collection Gruppen und administrative Einheiten, in denen dieser Benutzer Mitglied ist.Groups and administrative units that this group is a member of. HTTP-Methoden: GET (für alle Gruppen unterstützt).HTTP Methods: GET (supported for all groups). Schreibgeschützt.Read-only. Lässt NULL-Werte zu.Nullable.
membersmembers directoryObject-SammlungdirectoryObject collection Benutzer, Kontakte und Gruppen, die Mitglieder dieser Gruppe sind.Users, contacts, and groups that are members of this group. HTTP-Methoden: GET (für alle Gruppen unterstützt), POST (für Sicherheitsgruppen und E-Mail-fähige Sicherheitsgruppen unterstützt), DELETE (nur für Sicherheitsgruppen unterstützt). Schreibgeschützt.HTTP Methods: GET (supported for all groups), POST (supported for security groups and mail-enabled security groups), DELETE (supported only for security groups) Read-only. Nullwerte zulassend.Nullable.
membersWithLicenseErrorsmembersWithLicenseErrors user-Sammlunguser collection Eine Liste von Gruppenmitgliedern mit Lizenzfehlern aus dieser gruppenbasierten Lizenzizenzzuweisung.A list of group members with license errors from this group-based license assignment. Schreibgeschützt.Read-only.
onenoteonenote onenoteonenote Schreibgeschützt.Read-only.
ownersowners directoryObject-SammlungdirectoryObject collection Die Besitzer der Gruppe.The owners of the group. Bei den Besitzern handelt es sich um eine Reihe von Benutzern, die keine Administratoren sind und die berechtigt sind, dieses Objekt zu ändern.The owners are a set of non-admin users who are allowed to modify this object. HTTP-Methoden: GET (für alle Gruppen unterstützt), POST (für Sicherheitsgruppen und E-Mail-fähige Sicherheitsgruppen unterstützt), DELETE (nur für Sicherheitsgruppen unterstützt). Schreibgeschützt.HTTP Methods: GET (supported for all groups), POST (supported for security groups and mail-enabled security groups), DELETE (supported only for security groups) Read-only. Nullwerte zulassend.Nullable.
Fotophoto profilePhotoprofilePhoto Das Profilfoto der Gruppe.The group's profile photo.
Fotosphotos profilePhoto-SammlungprofilePhoto collection Die Profilfotos im Besitz der Gruppe. Schreibgeschützt. Lässt Nullwerte zu.The profile photos owned by the group. Read-only. Nullable.
plannerplanner plannerGroupplannerGroup Selektive Planner-Dienste, die für die Gruppe zur Verfügung stehen.Selective Planner services available to the group. Schreibgeschützt.Read-only. Nullwerte zulassend.Nullable.
rejectedSendersrejectedSenders directoryObject-SammlungdirectoryObject collection Die Liste der Benutzer oder Gruppen, die nicht berechtigt sind, Beiträge oder Kalenderereignisse in dieser Gruppe zu erstellen. Lässt NULL-Werte zuThe list of users or groups that are not allowed to create posts or calendar events in this group. Nullable
settingssettings directorySetting collectiondirectorySetting collection Einstellungen, die das Verhalten dieser Gruppe steuern, z. B. ob Mitglieder Gastbenutzer zur Gruppe einladen können.Settings that can govern this group's behavior, like whether members can invite guest users to the group. Nullwerte zulassend.Nullable.
sitessites site-Sammlungsite collection Die Liste der SharePoint-Websites in dieser Gruppe. Der Zugriff auf die Standardwebsite erfolgt mit „/sites/root“.The list of SharePoint sites in this group. Access the default site with /sites/root.
threadsthreads conversationThread-SammlungconversationThread collection Die Unterhaltungs-Threads der Gruppe. Lässt NULL-Werte zu.The group's conversation threads. Nullable.

JSON-DarstellungJSON representation

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

{
  "accessType": "string",
  "assignedLabels": [{"@odata.type": "microsoft.graph.assignedLabel"}],
  "assignedLicenses": [{"@odata.type": "microsoft.graph.assignedLicense"}],
  "allowExternalSenders": false,
  "autoSubscribeNewMembers": true,
  "createdDateTime": "String (timestamp)",
  "deletedDateTime": "String (timestamp)",
  "description": "string",
  "displayName": "string",
  "expirationDateTime": "String (timestamp)",
  "groupTypes": ["string"],
  "id": "string (identifier)",
  "isFavorite": true,
  "isSubscribedByMail": true,
  "licenseProcessingState": "string",
  "mail": "string",
  "mailEnabled": true,
  "mailNickname": "string",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesProvisioningErrors": [{"@odata.type": "microsoft.graph.onPremisesProvisioningError"}],
  "onPremisesSecurityIdentifier": "string",
  "onPremisesSyncEnabled": true,
  "preferredDataLocation": "string",
  "proxyAddresses": ["string"],
  "renewedDateTime": "String (timestamp)",
  "securityEnabled": true,
  "unseenConversationsCount": 1024,
  "unseenCount": 1024,
  "unseenMessagesCount": 1024,
  "visibility": "string",
  "acceptedSenders": [{"@odata.type": "microsoft.graph.directoryObject"}],
  "calendar": {"@odata.type": "microsoft.graph.calendar"},
  "calendarView": [{"@odata.type": "microsoft.graph.event"}],
  "conversations": [{"@odata.type": "microsoft.graph.conversation"}],
  "createdOnBehalfOf": {"@odata.type": "microsoft.graph.directoryObject"},
  "drive": {"@odata.type": "microsoft.graph.drive"},
  "events": [{"@odata.type": "microsoft.graph.event"}],
  "memberOf": [{"@odata.type": "microsoft.graph.directoryObject"}],
  "members": [{"@odata.type": "microsoft.graph.directoryObject"}],
  "membersWithLicenseErrors": [{"@odata.type": "microsoft.graph.user"}],
  "owners": [{"@odata.type": "microsoft.graph.directoryObject"}],
  "photo": {"@odata.type": "microsoft.graph.profilePhoto"},
  "rejectedSenders": [{"@odata.type": "microsoft.graph.directoryObject"}],
  "sites": [{"@odata.type": "microsoft.graph.site"}],
  "threads": [{"@odata.type": "microsoft.graph.conversationThread"}],
  "classification": "string",
  "hasMembersWithLicenseErrors": true,
  "membershipRule": "string",
  "membershipRuleProcessingState": "string",
  "preferredLanguage": "string",
  "theme": "string"
}

Siehe auchSee also