Gruppen-Ressourcentyp
Namespace: microsoft.graph
Stellt eine Azure Active Directory-Gruppe (Azure AD-Gruppe) dar, bei der es sich um eine Microsoft 365-Gruppe oder eine Sicherheitsgruppe handeln kann. Diese Ressource ist ein offener Typ, mit dem andere Eigenschaften übergeben werden können.
Erbt von directoryObject.
Aus Leistungsgründen geben die Vorgänge create, get und list standardmäßig nur eine Teilmenge häufig verwendeter Eigenschaften zurück. Diese Standardeigenschaften werden im Abschnitt Eigenschaften aufgeführt. Zum Abrufen von Eigenschaften, die nicht standardmäßig zurückgegeben werden, geben sie diese in einer OData-Abfrageoption $select
an.
Diese Ressource unterstützt Folgendes:
- Hinzufügen Ihrer eigenen Daten zu benutzerdefinierten Eigenschaften als Erweiterungen.
- Abonnieren von Änderungsbenachrichtigungen.
- Verwenden einer Delta-Abfrage zum Nachverfolgen von inkrementellen Hinzufügungen, Löschungen und Aktualisierungen durch Bereitstellen der delta-Funktion.
Methoden
Methode | Rückgabetyp | Beschreibung |
---|---|---|
Gruppenverwaltung | ||
Gruppe erstellen | Gruppe | Erstellt eine neue Gruppe. Dabei kann es sich um eine Microsoft 365-Gruppe, eine dynamische Gruppe oder eine Sicherheitsgruppe handeln. |
Gruppe abrufen | Gruppe | Liest die Eigenschaften eines Gruppenobjekts. |
Gruppen auflisten | Gruppensammlung | Listet Gruppenobjekte und deren Eigenschaften auf. |
Gruppe aktualisieren | Keine | Aktualisiert die Eigenschaften eines Gruppenobjekts. |
Gruppe löschen | Keiner | Löscht das Gruppenobjekt. |
delta | group-Sammlung | Dient zum Abrufen inkrementeller Änderungen für Gruppen. |
Mitglieder hinzufügen | Keine | Fügen Sie dieser Gruppe ein Mitglied hinzu, indem Sie die Navigationseigenschaft " Mitglieder " veröffentlichen (nur für Sicherheitsgruppen und Microsoft 365-Gruppen unterstützt). |
Besitzer hinzufügen | Keine | Fügen Sie einen neuen Besitzer für die Gruppe durch eine Veröffentlichung in der Navigationseigenschaft Besitzer hinzu (wird nur für Sicherheitsgruppen und Microsoft 365 Gruppen unterstützt). |
List groupLifecyclePolicies | groupLifecyclePolicy-Sammlung | Dient zum Auflisten der Gruppenlebenszyklusrichtlinien. |
Mitglieder auflisten | directoryObject-Sammlung | Rufen Sie die direkten Mitglieder dieser Gruppe aus der members-Navigationseigenschaft ab. |
Besitzer auflisten | directoryObject-Sammlung | Ruft die Besitzer der Gruppe aus der owners-Navigationseigenschaft ab. |
Transitive Mitglieder auflisten | directoryObject-Sammlung | Ruft die Benutzer, Gruppen und Geräte ab, die Mitglieder sind, einschließlich der geschachtelten Mitglieder dieser Gruppe. |
Transitive memberOf auflisten | directoryObject-Sammlung | Gruppen auflisten, bei denen diese Gruppe Mitglied ist. Dieser Vorgang ist transitiv und schließt die Gruppen ein, in denen diese Gruppe ein geschachteltes Mitglied. |
Mitglied entfernen | Keine | Entfernen Sie ein Mitglied aus einer Microsoft 365-Gruppe oder einer Sicherheitsgruppe über die members-Navigationseigenschaft. |
Besitzer entfernen | Keiner | Entfernen Sie einen Besitzer aus einer Microsoft 365-Gruppe oder einer Sicherheitsgruppe über die owners-Navigationseigenschaft. |
assignLicense | group | Hinzufügen oder Entfernen von Abonnements für die Gruppe. Sie können auch einzelne Pläne aktivieren oder deaktivieren, die einem Abonnement zugeordnet sind. |
Renew | Boolescher Wert | Verlängert den Ablaufzeitraum einer Gruppe. 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. |
validateProperties | JSON | Überprüften, ob der Anzeigename oder E-Mail-Spitzname einer Microsoft 365-Gruppe den Benennungsrichtlinien entspricht. |
App-Rollenzuweisungen | ||
List appRoleAssignments | appRoleAssignment-Auflistung | Apps und App-Rollen abrufen, die dieser Gruppe zugeordnet wurden. |
appRoleAssignment hinzufügen | appRoleAssignment | Dieser Gruppe eine App-Rolle zuweisen. |
appRoleAssignment entfernen | Keine. | Eine App-Rollenzuweisung aus dieser Gruppe entfernen. |
Calendar | ||
Ereignis erstellen | Ereignis | Erstellt ein neues Ereignis durch Veröffentlichen in der Ereignissammlung. |
Ereignis abrufen | Ereignis | Liest die Eigenschaften eines Ereignisobjekts. |
Ereignisse auflisten | Ereignissammlung | Ruft eine Ereignisobjektsammlung ab. |
Ereignis aktualisieren | Keine | Dient zum Aktualisieren der Eigenschaften eines Ereignisobjekts. |
Ereignis löschen | Keine | Löscht das Ereignisobjekt. |
calendarView auflisten | Ereignissammlung | Ruft eine Auflistung der Ereignisse in einem angegebenen Zeitfenster ab. |
Unterhaltungen | ||
Unterhaltung erstellen | Unterhaltung | Erstellt eine neue Unterhaltung durch Veröffentlichung in der Unterhaltungssammlung. |
Unterhaltung abrufen | Unterhaltung | Dient zum Lesen der Eigenschaften eines Unterhaltungsobjekts. |
Unterhaltungen auflisten | Unterhaltungssammlung | Ruft eine Unterhaltungsobjektsammlung ab. |
Unterhaltung löschen | Keine | Löscht ein Unterhaltungsobjekt. |
Thread erstellen | conversationThread | Erstellt einen neuen Unterhaltungsthread. |
Thread abrufen | conversationThread | Liest die Eigenschaften eines Threadobjekts. |
Threads auflisten | conversationThread-Sammlung | Ruft alle Threads einer Gruppe ab. |
Thread aktualisieren | Keine | Aktualisiert die Eigenschaften eines Threadobjekts. |
Thread löschen | Keine | Löscht das Threadobjekt. |
acceptedSenders auflisten | directoryObject collection | Ruft eine Liste von Benutzern oder Gruppen ab, die sich in der Liste der accepted-senders für diese Gruppe befinden. |
acceptedSender hinzufügen | directoryObject | Fügt einen Benutzer oder eine Gruppe zur acceptSenders-Sammlung hinzu. |
acceptedSender entfernen | directoryObject | Entfernt einen Benutzer oder eine Gruppe aus der acceptedSenders-Sammlung. |
rejectedSenders auflisten | directoryObject collection | Ruft eine Liste von Benutzern oder Gruppen ab, die sich in der Liste der rejected-senders für diese Gruppe befinden. |
rejectedSender hinzufügen | directoryObject | Fügt einen neuen Benutzer oder eine neue Gruppe zur rejectedSender-Sammlung hinzu. |
rejectedSender entfernen | directoryObject | Entfernt einen Benutzer oder eine neue Gruppe aus der rejectedSenders-Sammlung. |
Einstellung erstellen | groupSetting | Erstellen Sie ein Einstellungsobjekt basierend auf einer groupSettingTemplate.Create a setting object based on a groupSettingTemplate. Die POST-Anforderung muss settingValues für alle in der Vorlage definierten Einstellungen bereitstellen. Für diesen Vorgang können nur gruppenspezifische Vorlagen verwendet werden. |
Verzeichnisobjekte | ||
Gelöschte Gruppen auflisten | directoryObject-Sammlung | Rufen Sie die Gruppen ab, die in den letzten 30 Tagen im Mandanten gelöscht wurden. |
Auflisten der gelöschten Gruppen im Besitz eines Benutzers | directoryObject-Sammlung | Rufen Sie die Gruppen ab, die in den letzten 30 Tagen im Mandanten gelöscht wurden und sich im Besitz eines Benutzers befinden. |
Gelöschte Gruppe abrufen | directoryObject-Sammlung | Rufen Sie eine gelöschte Gruppe nach ID ab. |
Gelöschte Gruppe wiederherstellen | directoryObject-Sammlung | Stellen Sie eine Gruppe wieder her, die in den letzten 30 Tagen im Mandanten gelöscht wurde. |
Gruppe dauerhaft löschen | directoryObject-Sammlung | Löschen Sie eine gelöschte Gruppe dauerhaft aus dem Mandanten. |
checkMemberGroups | String collection | Sucht nach einer Mitgliedschaft in einer Liste von Gruppen. Die Funktion ist transitiv. |
getMemberGroups | String collection | Gibt alle Gruppen zurück, bei denen die Gruppe Mitglied ist. Die Funktion ist transitiv. |
checkMemberObjects | String-Sammlung | Überprüfen Sie die Mitgliedschaft in einer Liste von Gruppen, Verzeichnis-Rollen oder Verwaltungsobjekten. Die Funktion ist transitiv. |
getMemberObjects | String-Sammlung | Gibt alle Gruppen und Verwaltungseinheiten zurück, in denen die Gruppe Mitglied ist. Die Funktion ist transitiv. |
Gruppeneinstellungen | ||
Einstellung abrufen | groupSetting | Dient zum Lesen der Eigenschaften eines bestimmten Einstellungsobjekts. |
Einstellungen auflisten | groupSetting-Sammlung | Listet Eigenschaften aller Einstellungsobjekte auf. |
Einstellung aktualisieren | Keine | Aktualisiert ein Einstellungsobjekt. |
Einstellung löschen | Keine | Löscht ein Einstellungsobjekt. |
Abrufen der Einstellungsvorlage | Keine | Liest Eigenschaften einer Einstellungsvorlage. |
Auflisten der Einstellungsvorlage | Keine | Listet Eigenschaften aller Einstellungsvorlagen auf. |
Offene Erweiterungen | ||
Offene Erweiterung erstellen | openTypeExtension | Erstellt eine offene Erweiterung und fügt benutzerdefinierte Eigenschaften zu einer neuen oder vorhandenen Ressource hinzu. |
Offene Erweiterung abrufen | openTypeExtension-Sammlung | Dient zum Abrufen einer offenen Erweiterung, die durch den Erweiterungsnamen identifiziert wird. |
Schemaerweiterungen | ||
Schemaerweiterungswerte hinzufügen | Keine | Dient zum Erstellen einer Schemaerweiterungsdefinition und anschließenden Verwenden der Definition zum Hinzufügen benutzerdefinierter typisierter Daten zu einer Ressource. |
Andere Gruppenressourcen | ||
Fotos auflisten | profilePhoto-Sammlung | Ruft eine Sammlung von Profilfotos für die Gruppe ab. |
plannerPlans auflisten | plannerPlan-Sammlung | Ruft Plannerer-Pläne im Besitz der Gruppe ab. |
Benutzereinstellungen | ||
addFavorite | Keine | Fügt die Gruppe zu der Liste der Favoritengruppen des angemeldeten Benutzers hinzu. Wird nur für Microsoft 365-Gruppen unterstützt. |
removeFavorite | Keine | Entfernt die Gruppe aus der Liste der Favoritengruppen des angemeldeten Benutzers. Wird nur für Microsoft 365-Gruppen unterstützt. |
List memberOf | directoryObject-Sammlung | Ruft anhand der Navigationseigenschaft memberOf die Gruppen und administrativen Einheiten ab, bei denen dieser Benutzer direktes Mitglied ist. |
joinedTeams auflisten | group-Sammlung | Ruft die Microsoft-Teams an, in denen der Benutzer ein direktes Mitglied ist. |
Zugeordnete Teams auflisten | associatedTeamInfoAuflistung | Abrufen der Liste derassociatedTeamInfoObjekte in Microsoft Teams, denen einBenutzerzugeordnet ist. |
subscribeByMail | Keiner | Legt die isSubscribedByMail-Eigenschaft auf true fest. Aktiviert den angemeldeten Benutzer für den Erhalt von E-Mail-Unterhaltungen. Wird nur für Microsoft 365-Gruppen unterstützt. |
unsubscribeByMail | Keiner | Legt die isSubscribedByMail-Eigenschaft auf false fest. Deaktiviert den angemeldeten Benutzer für den Erhalt von E-Mail-Unterhaltungen. Wird nur für Microsoft 365-Gruppen unterstützt. |
resetUnseenCount | Keine | Setzt das unseenCount-Element aller Beiträge, die der angemeldete Benutzer seit dem letzten Besuch noch nicht gesehen hat, auf 0 zurück. Wird nur für Microsoft 365-Gruppen unterstützt. |
Eigenschaften
Wichtig
Die spezifische Verwendung von $filter
und des Abfrageparameters $search
wird nur unterstützt, wenn Sie die Kopfzeile ConsistencyLevel verwenden, die auf eventual
und $count
festgelegt ist. Weitere Informationen finden Sie unter Erweiterte Abfragefunktionen für Azure AD-Verzeichnisobjekte.
Eigenschaft | Typ | Beschreibung |
---|---|---|
allowExternalSenders | Boolesch | Gibt an, ob Personen außerhalb der Organisation Nachrichten an die Gruppe senden können. Der Standardwert ist false . Wird nur auf $select zurückgegeben. Wird nur von der „Gruppe abrufen“-API unterstützt (GET /groups/{ID} ). |
assignedLabels | assignedLabel-Sammlung | Die Liste der Vertraulichkeitsbezeichnungspaare (Bezeichnungs-ID, Bezeichnungsname), die einer Office 365-Gruppe zugeordnet sind. Wird nur auf $select zurückgegeben. |
assignedLicenses | assignedLicense-Sammlung | Die Lizenzen, die der Gruppe zugewiesen sind. Wird nur auf $select zurückgegeben. Unterstützt $filter (eq ). Schreibgeschützt. |
autoSubscribeNewMembers | Boolesch | Gibt an, ob neu zur Gruppe hinzugefügte Mitglieder automatisch E-Mail-Benachrichtigungen erhalten. 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. Der Standardwert ist false . Wird nur auf $select zurückgegeben. Wird nur von der „Gruppe abrufen“-API unterstützt (GET /groups/{ID} ). |
classification | Zeichenfolge | Beschreibt eine Klassifizierung für die Gruppe (z. B. niedrige, mittlere oder hohe geschäftliche Auswirkungen). Gültige Werte für diese Eigenschaft werden definiert, indem ein ClassificationList-Einstellungswert basierend auf der Vorlagendefinition erstellt wird. Wird standardmäßig zurückgegeben. Unterstützt $filter (eq , ne , not , ge , le , startsWith ). |
createdDateTime | DateTimeOffset | Zeitstempel der Gruppenerstellung. Der Wert kann nicht geändert werden und wird automatisch ausgefüllt, wenn die Gruppe erstellt wird. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z . Wird standardmäßig zurückgegeben. Schreibgeschützt. |
deletedDateTime | DateTimeOffset | Bei einigen Azure Active Directory-Objekten (Benutzer, Gruppe, Anwendung) wird das Objekt, wenn es gelöscht wird, zunächst logisch gelöscht, und diese Eigenschaft wird mit dem Datum und der Uhrzeit der Löschung des Objekts aktualisiert. Andernfalls ist diese Eigenschaft null . Wird das Objekt wiederhergestellt, wird diese Eigenschaft auf null aktualisiert. |
description | String | Eine optionale Beschreibung für die Gruppe. Wird standardmäßig zurückgegeben. Unterstützt $filter (eq , ne , not , ge , le , startsWith ) und $search . |
displayName | Zeichenfolge | Der Anzeigename der Gruppe. Diese Eigenschaft ist beim Erstellen einer Gruppe erforderlich und kann bei Updates nicht gelöscht werden. Die maximale Länge beträgt 256 Zeichen. Wird standardmäßig zurückgegeben. Unterstützt $filter (eq , ne , not , ge , le , in , startsWith und eq für null -Werte), $search und $orderBy . |
expirationDateTime | DateTimeOffset | Zeitstempel des festgelegten Ablaufs der Gruppe. Der Wert kann nicht geändert werden und wird automatisch ausgefüllt, wenn die Gruppe erstellt wird. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z . Wird standardmäßig zurückgegeben. Unterstützt $filter (eq , ne , not , ge , le , in ). Schreibgeschützt. |
groupTypes | Zeichenfolgensammlung | Gibt den Typ und die Mitgliedschaft der Gruppe an. Wenn die Sammlung Unified enthält, handelt es sich bei der Gruppe um eine Microsoft 365-Gruppe, andernfalls um eine Sicherheits- oder Verteilergruppe. Weiter Informationen finden Sie unter Übersicht über Gruppen.Wenn die Sammlung DynamicMembership enthält, verfügt die Gruppe über eine dynamische Mitgliedschaft, andernfalls ist die Mitgliedschaft statisch. Wird standardmäßig zurückgegeben. Unterstützt $filter (eq , not ). |
hasMembersWithLicenseErrors | Boolesch | Gibt an, ob es in dieser Gruppe Mitglieder mit Lizenzfehlern aus ihrer gruppenbasierten Lizenzzuweisung gibt. Diese Eigenschaft wird nie bei einem GET-Vorgang zurückgegeben. 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). Sehen Sie sich das Beispiel an. Unterstützt $filter (eq ). |
hideFromAddressLists | Boolescher Wert | „True“, wenn die Gruppe nicht in bestimmten Bereichen der Outlook-Benutzeroberfläche angezeigt wird: im Adressbuch, in Adresslisten für die Auswahl von Nachrichtenempfängern und im Dialogfeld Gruppen durchsuchen für das Durchsuchen von Gruppen; andernfalls „False“. Der Standardwert ist false . Wird nur auf $select zurückgegeben. Wird nur von der „Gruppe abrufen“-API unterstützt (GET /groups/{ID} ). |
hideFromOutlookClients | Boolesch | „True“, wenn die Gruppe nicht in Outlook-Clients wie Outlook für Windows und Outlook im Web angezeigt wird; andernfalls „False“. Der Standardwert ist false . Wird nur auf $select zurückgegeben. Wird nur von der „Gruppe abrufen“-API unterstützt (GET /groups/{ID} ). |
id | Zeichenfolge | Eindeutiger Bezeichner für die Gruppe. Wird standardmäßig zurückgegeben. Geerbt von directoryObject. Key. Lässt keine Nullwerte zu. Schreibgeschützt. Unterstützt $filter (eq , ne , not , in ). |
isArchived | Boolesch | Wenn eine Gruppe mit einem Team verknüpft ist, bestimmt diese Eigenschaft, ob sich das Team im schreibgeschützten Modus befindet. Verwenden Sie zum Lesen dieser Eigenschaft den Endpunkt /group/{groupId}/team oder die API Team abrufen. Verwenden Sie zum Aktualisieren dieser Eigenschaft die archiveTeam und unarchiveTeam-APIs. |
isAssignableToRole | Boolesch | Gibt an, ob diese Gruppe einer Azure Active Directory-Rolle zugeordnet werden kann oder nicht. Optional. Diese Eigenschaft kann nur beim Anlegen der Gruppe eingestellt werden und ist unveränderlich. Wenn auf true festgelegt ist, muss die securityEnabled-Eigenschaft auch auf true festgelegt werden, die Sichtbarkeit muss sein Hidden , und die Gruppe darf keine dynamische Gruppe sein (d. a. groupTypes kann nicht enthalten DynamicMembership ). Nur Aufrufer in den Rollen "Globaler Administrator" und "Administrator für privilegierte Rollen" können diese Eigenschaft festlegen. Dem Aufrufer muss auch die Berechtigung RoleManagement.ReadWrite.Directory zugewiesen werden, um diese Eigenschaft festzulegen oder die Mitgliedschaft solcher Gruppen zu aktualisieren. Weitere Informationen finden Sie unter Verwendung einer Gruppe zur Verwaltung von Azure AD-Rollenzuweisungen. Für die Verwendung dieses Features ist eine Azure AD Premium P1 Lizenz erforderlich. Wird standardmäßig zurückgegeben. Unterstützt $filter (eq , ne , not ). |
isSubscribedByMail | Boolesch | Gibt an, ob der angemeldete Benutzer den Erhalt von E-Mail-Unterhaltungen abonniert hat. Der Standardwert ist true . Wird nur auf $select zurückgegeben. Wird nur von der „Gruppe abrufen“-API unterstützt (GET /groups/{ID} ). |
licenseProcessingState | Zeichenfolge | Gibt den Status der Gruppenlizenzzuweisung an alle Mitglieder der Gruppe an. Der Standardwert ist false . Schreibgeschützt. Mögliche Werte: QueuedForProcessing , ProcessingInProgress und ProcessingComplete .Wird nur auf $select zurückgegeben. Schreibgeschützt. |
Zeichenfolge | Die SMTP-Adresse für die Gruppe, z. B. "serviceadmins@contoso.onmicrosoft.com". Wird standardmäßig zurückgegeben. Schreibgeschützt. Unterstützt $filter (eq , ne , not , ge , le , in , startsWith und eq für null -Werte). |
|
mailEnabled | Boolean | Gibt an, ob es sich bei der Gruppe um eine E-Mail-fähige Gruppe handelt. Erforderlich. Wird standardmäßig zurückgegeben. Unterstützt $filter (eq , ne , not ). |
mailNickname | Zeichenfolge | Der E-Mail-Alias für die Gruppe, eindeutig für Microsoft 365-Gruppen in der Organisation. Die maximale Länge beträgt 64 Zeichen. Diese Eigenschaft darf nur Zeichen im ASCII-Zeichensatz 0 bis 127 mit Ausnahme der folgenden enthalten: @ () \ [] " ; : <> , SPACE . Erforderlich. Wird standardmäßig zurückgegeben. Unterstützt $filter (eq , ne , not , ge , le , in , startsWith und eq für null -Werte). |
membershipRule | Zeichenfolge | Die Regel, die Mitglieder dieser Gruppe bestimmt, wenn die Gruppe eine dynamische Gruppe ist (groupTypes enthält DynamicMembership ). Weitere Informationen zur Syntax der Mitgliedschaftsregel finden Sie unter Regeln für eine dynamische Mitgliedschaft. Wird standardmäßig zurückgegeben. Unterstützt $filter (eq , ne , not , ge , le , startsWith ). |
membershipRuleProcessingState | Zeichenfolge | Gibt an, ob die Verarbeitung der dynamischen Mitgliedschaft aktiv ist oder angehalten wurde. Mögliche Werte sind On oder Paused . Wird standardmäßig zurückgegeben. Unterstützt $filter (eq , ne , not , in ). |
onPremisesLastSyncDateTime | DateTimeOffset | 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. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z . Wird standardmäßig zurückgegeben. Schreibgeschützt. Unterstützt $filter (eq , ne , not , ge , le , in ). |
onPremisesProvisioningErrors | onPremisesProvisioningError-Sammlung | Fehler bei Verwendung eines Microsoft-Synchronisierungsprodukts während der Bereitstellung. Wird standardmäßig zurückgegeben. Unterstützt $filter (eq , not ). |
onPremisesSamAccountName | Zeichenfolge | Enthält den lokalen SAM-Kontonamen, der aus dem lokalen Verzeichnis synchronisiert wird. Die Eigenschaft wird nur für Kunden ausgefüllt, die ihr lokales Verzeichnis in Azure Active Directory über Azure AD Connect synchronisieren. Wird standardmäßig zurückgegeben. Unterstützt $filter (eq , ne , not , ge , le , in , startsWith ). Schreibgeschützt. |
onPremisesSecurityIdentifier | Zeichenfolge | Enthält die lokale Sicherheits-ID (SID) für die Gruppe, die von der lokalen Bereitstellung in der Cloud synchronisiert wurde. Wird standardmäßig zurückgegeben. Unterstützt $filter (eq auch für null -Werte). Schreibgeschützt. |
onPremisesSyncEnabled | Boolean | 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). Wird standardmäßig zurückgegeben. Schreibgeschützt. Unterstützt $filter (eq , ne , not , in und eq für null -Werte). |
preferredDataLocation | Zeichenfolge | Der bevorzugte Datenspeicherort für die Microsoft 365-Gruppe. Standardmäßig erbt die Gruppe den bevorzugten Datenspeicherort des Gruppenerstellers. Um diese Eigenschaft festzulegen, muss dem aufrufenden Benutzer eine der folgenden Azure AD-Rollen zugewiesen sein:
Weitere Informationen zu dieser Eigenschaft finden Sie unter OneDrive Online Multi-Geo. Nullwerte zulassend. Wird standardmäßig zurückgegeben. |
preferredLanguage | String | Die bevorzugte Sprache für eine Microsoft 365-Gruppe. Muss im ISO 639-1-Code angegeben werden, z. B. en-US . Wird standardmäßig zurückgegeben. Unterstützt $filter (eq , ne , not , ge , le , in , startsWith und eq für null -Werte). |
proxyAddresses | Zeichenfolgenauflistung | E-Mail-Adressen für die Gruppe, die in das gleiche Gruppenpostfach umgeleitet werden sollen. Zum Beispiel: ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"] . Der any-Operator ist für Filterausdrücke für mehrwertige Eigenschaften erforderlich. Wird standardmäßig zurückgegeben. Schreibgeschützt. Lässt keine NULL-Werte zu. Unterstützt $filter (eq , not , ge , le , startsWith , endsWith , /$count eq 0 , /$count ne 0 ). |
renewedDateTime | DateTimeOffset | Zeitstempel der letzten Verlängerung der Gruppe. Dies kann nicht direkt geändert werden und wird nur über die Aktion zum Verlängern des Diensts aktualisiert. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z . Wird standardmäßig zurückgegeben. Unterstützt $filter (eq , ne , not , ge , le , in ). Schreibgeschützt. |
resourceBehaviorOptions | String-Sammlung | Gibt die Gruppenverhalten an, die für eine Microsoft 365-Gruppe während deren Erstellung festgelegt werden können. Dies kann nur bei der Erstellung (POST) festgelegt werden. Mögliche Werte sind: AllowOnlyMembersToPost , HideGroupInOutlook , SubscribeNewGroupMembers , WelcomeEmailDisabled . Weitere Informationen finden Sie unter Festlegen der Gruppenverhaltensweisen und Bereitstellungsoptionen für Microsoft 365. |
resourceProvisioningOptions | String-Sammlung | Gibt die Gruppenressourcen an, die als Teil der Microsoft 365-Gruppenerstellung bereitgestellt werden, die normalerweise nicht Bestandteil der standardmäßigen Gruppenerstellung sind. Möglicher Wert: Team . Weitere Informationen finden Sie unter Festlegen der Gruppenverhaltensweisen und Bereitstellungsoptionen für Microsoft 365. |
securityEnabled | Boolean | Gibt an, ob es sich bei der Gruppe um eine Sicherheitsgruppe handelt. Erforderlich. Wird standardmäßig zurückgegeben. Unterstützt $filter (eq , ne , not , in ). |
securityIdentifier | Zeichenfolge | Sicherheits-ID der Gruppe, verwendet in Windows-Szenarios. Wird standardmäßig zurückgegeben. |
theme | Zeichenfolge | Gibt das Farbdesign einer Microsoft 365-Gruppe an. Mögliche Werte sind Teal , Purple , Green , Blue , Pink , Orange oder Red . Wird standardmäßig zurückgegeben. |
unseenCount | Int32 | Die Anzahl von Unterhaltungen, die neue Beiträge erhalten haben, da der angemeldete Benutzer die Gruppe zuletzt besucht hat. Wird nur auf $select zurückgegeben. Wird nur von der „Gruppe abrufen“-API unterstützt (GET /groups/{ID} ). |
visibility | Zeichenfolge | Legt die Gruppenbeitrittsrichtlinie und die Sichtbarkeit von Gruppeninhalten für Gruppen fest. Mögliche Werte: Private , Public oder HiddenMembership . HiddenMembership kann für Microsoft 365-Gruppen nur während der Erstellung der Gruppen festgelegt werden. Die Einstellung kann später nicht mehr aktualisiert werden. Andere Werte für die Sichtbarkeit können nach der Gruppenerstellung aktualisiert werden.Wird bei der Erstellung der Gruppe in Microsoft Graph kein Sichtbarkeitswert angegeben, wird eine Sicherheitsgruppe standardmäßig als Private erstellt, und die Microsoft 365-Gruppe ist Public . Gruppen, die Rollen zugewiesen werden können, sind immer Private . Weitere Informationen finden Sie unter Sichtbarkeitsoptionen für Gruppen. Wird standardmäßig zurückgegeben. Nullwerte zulassend. |
Sichtbarkeitsoptionen für Gruppen
Wert | Beschreibung |
---|---|
Öffentlich | Jeder kann der Gruppe beitreten, ohne dass die Berechtigung „Besitzer“ erforderlich ist. Jeder kann die Attribute der Gruppe anzeigen. Jeder kann die Mitglieder der Gruppe sehen. |
Privat | Die Berechtigung „Besitzer“ ist erforderlich, um der Gruppe beizutreten. Nichtmitglieder können die Attribute der Gruppe nicht anzeigen. Jeder kann die Mitglieder der Gruppe sehen. |
HiddenMembership | Die Berechtigung „Besitzer“ ist erforderlich, um der Gruppe beizutreten. Nichtmitglieder können die Attribute der Gruppe nicht anzeigen. Nichtmitglieder können die Mitglieder der Gruppe nicht sehen. Administratoren (global, Unternehmen, Benutzer und Helpdesk) können die Mitgliedschaft der Gruppe anzeigen. Die Gruppe wird im globalen Adressbuch (GAL) angezeigt. |
Beziehungen
Beziehung | Typ | Beschreibung |
---|---|---|
acceptedSenders | directoryObject-Sammlung | 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. |
appRoleAssignments | appRoleAssignment-Auflistung | Stellt die App-Rollen dar, die eine Gruppe für eine Anwendung gewährt bekommen hat. Unterstützt $expand . |
Kalender | Kalender | Der Kalender der Gruppe. Schreibgeschützt. |
calendarView | event-Sammlung | Die Kalenderansicht für den Kalender. Schreibgeschützt. |
conversations | Unterhaltungssammlung | Die Unterhaltungen der Gruppe |
createdOnBehalfOf | directoryObject | Der Benutzer (bzw. die Anwendung), der/die Gruppe erstellt hat. HINWEIS: Dies ist nicht festgelegt, wenn der Benutzer ein Administrator ist. Schreibgeschützt. |
drive | drive | Das Standardlaufwerk der Gruppe. Schreibgeschützt. |
drives | drive-Sammlung | Die Laufwerke der Gruppe. Schreibgeschützt. |
events | Ereignissammlung | Die Kalenderereignisse der Gruppe. |
extensions | extension-Sammlung | Die Auflistung der offenen Erweiterungen, die für die Gruppe definiert sind. Schreibgeschützt. Nullwerte zulassend. |
groupLifecyclePolicies | groupLifecyclePolicy-Sammlung | Die Sammlung der Lebenszyklusrichtlinien für diese Gruppe. Schreibgeschützt. Lässt Nullwerte zu. |
memberOf | directoryObject-Sammlung | Gruppen, bei denen diese Gruppe Mitglied ist. HTTP-Methoden: GET (für alle Gruppen unterstützt). Schreibgeschützt. Nullwerte zulassend. Unterstützt $expand . |
members | directoryObject collection | Die Mitglieder dieser Gruppe, wobei es sich um Benutzer, Geräte, andere Gruppen oder Dienstprinzipale handeln kann. Unterstützt die Vorgänge Mitglieder auflisten, Mitglieder hinzufügen und Mitglieder entfernen. Lässt NULL-Werte zu. Unterstützt $expand einschließlich verschachtelter $select . Beispiel: /groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=members($select=id,userPrincipalName,displayName) . |
membersWithLicenseErrors | User-Sammlung | Eine Liste von Gruppenmitgliedern mit Lizenzfehlern aus dieser gruppenbasierten Lizenzizenzzuweisung. Schreibgeschützt. |
onenote | Onenote | Schreibgeschützt. |
owners | directoryObject-Sammlung | Die Besitzer der Gruppe. Beschränkt auf 100 Besitzer. Lässt NULL-Werte zu. Wenn diese Eigenschaft beim Erstellen einer Microsoft 365-Gruppe nicht angegeben wird, wird der aufrufende Benutzer automatisch als Gruppenbesitzer zugewiesen. Unterstützt $filter (/$count eq 0 , /$count ne 0 , /$count eq 1 , /$count ne 1 ). Unterstützt $expand einschließlich verschachtelter $select . Beispiel: /groups?$filter=startsWith(displayName,'Role')&$select=id,displayName&$expand=owners($select=id,userPrincipalName,displayName) . |
permissionGrants | resourceSpecificPermissionGrant | Die Berechtigung, die einer Gruppe für eine bestimmte Anwendung erteilt wurde. Unterstützt $expand . |
Foto | profilePhoto | Das Profilfoto der Gruppe. |
Fotos | profilePhoto-Sammlung | Die Profilfotos, die sich im Besitz der Gruppe befinden. Schreibgeschützt. Nullwerte zulassend. |
planner | plannerGroup | Einstiegspunkt der Planner-Ressource, die möglicherweise für eine einheitliche Gruppe vorhanden ist. |
rejectedSenders | directoryObject-Sammlung | Die Liste der Benutzer oder Gruppen, die nicht berechtigt sind, Beiträge oder Kalenderereignisse in dieser Gruppe zu erstellen. Nullwerte zulassend. |
Einstellungen | groupSetting-Sammlung | Einstellungen, die das Verhalten dieser Gruppe steuern, z. B. ob Mitglieder Gastbenutzer zur Gruppe einladen können. Nullwerte zulassend. |
sites | site-Sammlung | Die Liste der SharePoint-Websites in dieser Gruppe. Greifen Sie mit /sites/root auf die Standardwebsite zu. |
team | channel-Sammlung | Das dieser Gruppe zugeordnete Team. |
threads | conversationThread-Sammlung | Die Unterhaltungs-Threads der Gruppe. Nullwerte zulassend. |
transitiveMemberOf | directoryObject collection | Die Gruppen, in denen eine Gruppe Mitglied ist, entweder direkt und über eine geschachtelte Mitgliedschaft. Nullwerte zulassend. |
transitiveMembers | directoryObject collection | Die direkten und transitiven Mitglieder einer Gruppe. Nullwerte zulassend. |
JSON-Darstellung
Es folgt eine JSON-Darstellung der Ressource.
{
"allowExternalSenders": false,
"acceptedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
"assignedLicenses": [{ "@odata.type": "microsoft.graph.assignedLicense" }],
"autoSubscribeNewMembers": true,
"calendar": { "@odata.type": "microsoft.graph.calendar" },
"calendarView": [{ "@odata.type": "microsoft.graph.event" }],
"classification": "String",
"conversations": [{ "@odata.type": "microsoft.graph.conversation" }],
"createdDateTime": "String (timestamp)",
"createdOnBehalfOf": { "@odata.type": "microsoft.graph.directoryObject" },
"description": "String",
"displayName": "String",
"drive": { "@odata.type": "microsoft.graph.drive" },
"events": [{ "@odata.type": "microsoft.graph.event" }],
"groupTypes": ["String"],
"hasMembersWithLicenseErrors": "Boolean",
"hideFromAddressLists": false,
"hideFromOutlookClients": false,
"id": "String (identifier)",
"isAssignableRole": false,
"isSubscribedByMail": true,
"licenseProcessingState": "String",
"mail": "String",
"mailEnabled": true,
"mailNickname": "String",
"memberOf": [{ "@odata.type": "microsoft.graph.directoryObject" }],
"members": [{ "@odata.type": "microsoft.graph.directoryObject" }],
"membersWithLicenseErrors": [{ "@odata.type": "microsoft.graph.user" }],
"onPremisesLastSyncDateTime": "String (timestamp)",
"onPremisesProvisioningErrors": [
{ "@odata.type": "microsoft.graph.onPremisesProvisioningError" }
],
"onPremisesSecurityIdentifier": "String",
"onPremisesSyncEnabled": true,
"owners": [{ "@odata.type": "microsoft.graph.directoryObject" }],
"preferredDataLocation": "String",
"proxyAddresses": ["String"],
"photo": { "@odata.type": "microsoft.graph.profilePhoto" },
"rejectedSenders": [{ "@odata.type": "microsoft.graph.directoryObject" }],
"renewedDateTime": "String (timestamp)",
"resourceBehaviorOptions": ["String"],
"resourceProvisioningOptions": ["String"],
"securityEnabled": true,
"securityIdentifier": "String",
"sites": [{ "@odata.type": "microsoft.graph.site" }],
"threads": [{ "@odata.type": "microsoft.graph.conversationThread" }],
"unseenCount": 1024,
"visibility": "String"
}