Gruppen-Ressourcentypgroup resource type

Stellt eine Azure Active Directory (Azure AD)-Gruppe dar, bei der es sich um eine Office 365-Gruppe oder eine Sicherheitsgruppe handeln kann.Represents an Azure Active Directory (Azure AD) group, which can be an Office 365 group, or a security group.

Erbt von directoryObject.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.

Diese Ressource unterstützt Folgendes:This resource supports:

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
GruppenverwaltungGroup management
Gruppe erstellenCreate group Gruppegroup Erstellt eine neue Gruppe.Create a new group. Dabei kann es sich um eine Office 365-Gruppe, eine dynamische Gruppe oder eine Sicherheitsgruppe handeln.It can be an Office 365 group, dynamic group, or security group.
Gruppe abrufenGet group Gruppegroup Liest die Eigenschaften eines Gruppenobjekts.Read properties of a group object.
Gruppen auflistenList groups Gruppensammlunggroup collection Listet Gruppenobjekte und deren Eigenschaften auf.List group objects and their properties.
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.
RenewRenew Boolescher WertBoolean Verlängert den Ablaufzeitraum einer Gruppe.Renews a group's expiration. Sobald die Gruppe verlängert wurde, wird der Ablaufzeitraum für die Gruppe um die Anzahl der Tage verlängert, die in der Richtlinie definiert sind.When a group is renewed, the group expiration is extended by the number of days defined in the policy.
Add ownerAdd owner KeineNone Fügt einen neuen Besitzer zur Gruppe durch Bereitstellen an die owners-Navigationseigenschaft bereit (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 auflistenList owners directoryObject-SammlungdirectoryObject collection Ruft die Eigentümer der Gruppe aus der owners-Navigationseigenschaft ab.Get the owners of the group from the owners navigation property.
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.
Mitglied hinzufügenAdd member KeinerNone 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).
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 und Geräte ab, die Mitglieder sind, einschließlich der geschachtelten Mitglieder dieser Gruppe.Get the users, groups and devices that are members, including nested members of this group.
Transitive memberOf auflistenList transitive memberOf directoryObject-SammlungdirectoryObject collection Listet die Gruppen auf, deren Mitglied der Benutzer ist.List the groups 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.
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.
checkMemberGroupscheckMemberGroups String collectionString collection Prüft die Mitgliedschaft dieser Gruppe in einer Liste von Gruppen. Die Funktion ist transitiv.Check this group 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 String collectionString collection Gibt alle Gruppen zurück, bei denen die Gruppe Mitglied ist. Die Funktion ist transitiv.Return all of the groups that the group is a member of. The function is transitive.
Create settingCreate setting groupSettinggroupSetting Erstellen Sie eine Einstellungsobjekt basierend auf einer groupSettingTemplate. Die POST-Anforderung muss settingValues für alle Einstellungen bereitstellen, die in der Vorlage definiert sind. Für diesen Vorgang können nur gruppenspezifische Vorlagen verwendet werden.Create a setting object based on a groupSettingTemplate. 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 groupSettinggroupSetting Dient zum Lesen der Eigenschaften eines bestimmten Einstellungsobjekts.Read properties of a specific setting object.
Einstellungen auflistenList settings groupSetting-SammlunggroupSetting collection Listet Eigenschaften aller Einstellungsobjekte auf.List properties of all setting objects.
Einstellung aktualisierenUpdate setting groupSettinggroupSetting Aktualisiert ein Einstellungsobjekt.Update a setting object.
Einstellung löschenDelete setting KeineNone Löscht ein Einstellungsobjekt.Delete a setting object.
validatePropertiesvalidateProperties JSONJSON Überprüft, ob der Anzeigename oder E-Mail-Kontoname einer Office 365-Gruppe den Benennungsrichtlinien entspricht.Validate that 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 erstellenCreate thread conversationThreadconversationThread Erstellt einen neuen Unterhaltungsthread.Create a new conversation thread.
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 Benutzer oder eine neue Gruppe aus der rejectedSenders-Sammlung.Remove new User or Group from the rejectedSenders collection.
Einstellung erstellenCreate setting groupSettinggroupSetting Erstellen Sie eine Einstellungsobjekt basierend auf einer groupSettingTemplate. Die POST-Anforderung muss settingValues für alle Einstellungen bereitstellen, die in der Vorlage definiert sind. Für diesen Vorgang können nur gruppenspezifische Vorlagen verwendet werden.Create a setting object based on a groupSettingTemplate. 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 groupSettinggroupSetting Dient zum Lesen der Eigenschaften eines bestimmten Einstellungsobjekts.Read properties of a specific setting object.
Einstellungen auflistenList settings groupSetting-SammlunggroupSetting collection Listet Eigenschaften aller Einstellungsobjekte auf.List properties of all setting objects.
Einstellung aktualisierenUpdate setting KeineNone Aktualisiert ein Einstellungsobjekt.Update a setting object.
Einstellung löschenDelete setting KeineNone Löscht ein Einstellungsobjekt.Delete a setting object.
Abrufen der EinstellungsvorlageGet setting template KeineNone Liest Eigenschaften einer Einstellungsvorlage.Read properties of a setting template.
Auflisten der EinstellungsvorlageList setting template KeineNone Listet Eigenschaften aller Einstellungsvorlagen auf.List properties of all setting templates.
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 only Office 365 groups.
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.
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 only Office 365 groups.
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 only Office 365 groups.
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 only Office 365 groups.

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.
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.
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. Der Standardwert lautet false.Default value is false. Schreibgeschützt.Read-only. 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.
onPremisesDomainNameonPremisesDomainName ZeichenfolgeString Enthält lokale Domänen-FQDN, die auch als dnsDomainName bezeichnet und aus dem lokalen Verzeichnis synchronisiert werden.Contains the on-premises , also called dnsDomainName synchronized from the on-premises directory. Die Eigenschaft wird nur für Kunden ausgefüllt, die ihr lokales Verzeichnis in Azure Active Directory über Azure AD Connect synchronisieren.The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect.

Wird standardmäßig zurückgegeben.Returned by default. Schreibgeschützt.Read-only.
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.
onPremisesNetBiosNameonPremisesNetBiosName ZeichenfolgeString Enthält den lokalen netBios-Namen, der aus dem lokalen Verzeichnis synchronisiert wird.Contains the on-premises **** synchronized from the on-premises directory. Die Eigenschaft wird nur für Kunden ausgefüllt, die ihr lokales Verzeichnis in Azure Active Directory über Azure AD Connect synchronisieren.The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect.

Wird standardmäßig zurückgegeben.Returned by default. Schreibgeschützt.Read-only.
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.
onPremisesSamAccountNameonPremisesSamAccountName ZeichenfolgeString Enthält den lokalen SAM-Kontonamen, der aus dem lokalen Verzeichnis synchronisiert wird.Contains the on-premises **** synchronized from the on-premises directory. Die Eigenschaft wird nur für Kunden ausgefüllt, die ihr lokales Verzeichnis in Azure Active Directory über Azure AD Connect synchronisieren.The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect.

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.
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 to 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.
securityIdentifiersecurityIdentifier ZeichenfolgeString Sicherheits-ID der Gruppe, verwendet in Windows-Szenarios.Security identifier of the group, used in Windows scenarios.

Wird standardmäßig zurückgegeben.Returned by default.
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.

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
ÖffentlichPublic 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.
PrivatPrivate 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.
HiddenmembershipHiddenmembership 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.
eventsevents Ereignissammlungevent collection Die Kalenderereignisse der Gruppe.The group's calendar 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, bei denen diese Gruppe Mitglied ist. HTTP-Methoden: GET (unterstützt für alle Gruppen). Schreibgeschützt. Lässt NULL-Werte zu.Groups that this group is a member of. HTTP Methods: GET (supported for all groups). Read-only. Nullable.
Elementemembers directoryObject-SammlungdirectoryObject collection Benutzer und Gruppen, die Mitglieder dieser Gruppe sind. HTTP-Methoden: GET (unterstützt für alle Gruppen), POST (unterstützt für Office 365-Gruppen, Sicherheitsgruppen und E-Mail-fähige Sicherheitsgruppen), DELETE (unterstützt für Office 365-Gruppen und Sicherheitsgruppen), lässt NULL-Werte zu.Users and groups that are members of this group. HTTP Methods: GET (supported for all groups), POST (supported for Office 365 groups, security groups and mail-enabled security groups), DELETE (supported for Office 365 groups and security groups) 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. Bei den Besitzern handelt es sich um eine Reihe von Benutzern, die keine Administratoren sind und die berechtigt sind, dieses Objekt zu ändern. Beschränkt auf 10 Besitzer. HTTP-Methoden: GET (unterstützt für alle Gruppen), POST (unterstützt für Office 365-Gruppen, Sicherheitsgruppen und E-Mail-fähige Sicherheitsgruppen), DELETE (unterstützt für Office 365-Gruppen und Sicherheitsgruppen). Lässt NULL-Werte zu.The owners of the group. The owners are a set of non-admin users who are allowed to modify this object. Limited to 10 owners. HTTP Methods: GET (supported for all groups), POST (supported for Office 365 groups, security groups and mail-enabled security groups), DELETE (supported for Office 365 groups and security groups). 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 Einstiegspunkt der Planner-Ressource, die möglicherweise für eine einheitliche Gruppe vorhanden ist.Entry-point to Planner resource that might exist for a Unified Group.
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
Einstellungensettings groupSetting-SammlunggroupSetting collection Schreibgeschützt. Lässt Nullwerte zu.Read-only. 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.

{
  "allowExternalSenders": false,
  "assignedLicenses": [{"@odata.type": "microsoft.graph.assignedLicense"}],
  "autoSubscribeNewMembers": true,
  "classification": "string",
  "createdDateTime": "String (timestamp)",
  "description": "string",
  "displayName": "string",
  "groupTypes": ["string"],
  "hasMembersWithLicenseErrors": "Boolean",
  "id": "string (identifier)",
  "isSubscribedByMail": true,
  "licenseProcessingState": "string",
  "mail": "string",
  "mailEnabled": true,
  "mailNickname": "string",
  "onPremisesDomainName": "string",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesNetBiosName": "string",
  "onPremisesProvisioningErrors": [{"@odata.type": "microsoft.graph.onPremisesProvisioningError"}],
  "onPremisesSamAccountName": "string",
  "onPremisesSecurityIdentifier": "string",
  "onPremisesSyncEnabled": true,
  "preferredDataLocation": "string",
  "proxyAddresses": ["string"],
  "renewedDateTime": "String (timestamp)",
  "securityEnabled": true,
  "securityIdentifier": "String",
  "unseenCount": 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" }]
}

Siehe auchSee also