Aktualisieren von administrativeunit
Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta
Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Aktualisieren sie die Eigenschaften eines administrativeUnit-Objekts .
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | AdministrativeUnit.ReadWrite.All | Nicht verfügbar. |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | AdministrativeUnit.ReadWrite.All | Nicht verfügbar. |
In delegierten Szenarien muss dem angemeldeten Benutzer auch eine unterstützte Microsoft Entra-Rolle oder eine benutzerdefinierte Rolle mit der microsoft.directory/administrativeUnits/allProperties/allTasks
Rollenberechtigung zugewiesen werden.
Administrator für privilegierte Rollen ist die Rolle mit den geringsten Berechtigungen für diesen Vorgang.
HTTP-Anforderung
PATCH /administrativeUnits/{id}
PATCH /directory/administrativeUnits/{id}
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Anforderungstext
Geben Sie im Anforderungstext die Werte für die relevanten Felder an, die aktualisiert werden sollen. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte bei oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet. Aus Gründen der Leistung sollten Sie vorhandene Werte, die nicht geändert wurden, nicht angeben.
Eigenschaft | Typ | Beschreibung |
---|---|---|
description | Zeichenfolge | Beschreibung für die Verwaltungseinheit. |
displayName | Zeichenfolge | Anzeigename für die Verwaltungseinheit. |
membershipRule | Zeichenfolge | Dynamische Mitgliedschaftsregel für die Verwaltungseinheit. Weitere Informationen zu den Regeln, die Sie für dynamische Verwaltungseinheiten und dynamische Gruppen verwenden können, finden Sie unter Verwenden von Attributen zum Erstellen erweiterter Regeln. |
membershipRuleProcessingState | Zeichenfolge | Wird verwendet, um zu steuern, ob die dynamische Mitgliedschaftsregel aktiv verarbeitet wird. Legen Sie auf fest On , wann die dynamische Mitgliedschaftsregel aktiv sein soll und Paused wenn Sie das dynamische Aktualisieren der Mitgliedschaft beenden möchten. |
membershipType | Zeichenfolge | Mitgliedschaftstyp für die Verwaltungseinheit. Kann dynamic oder assigned sein. |
visibility | Zeichenfolge | Sichtbarkeit für die Verwaltungseinheit. Wenn nicht festgelegt, ist public der Standardwert . Kann auf HiddenMembership festgelegt werden, wodurch die Mitgliedschaft vor Nicht-Mitgliedern ausgeblendet wird. |
Da die administrativeUnit-RessourceErweiterungen unterstützt, können Sie den PATCH
Vorgang verwenden, um Eigene App-spezifische Daten in benutzerdefinierten Eigenschaften einer Erweiterung in einer vorhandenen administrativeUnit-Instanz hinzuzufügen, zu aktualisieren oder zu löschen.
Antwort
Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content
zurückgegeben.
Beispiele
Im folgenden Beispiel wird eine dynamische Mitgliedschaftsregel für eine vorhandene Verwaltungseinheit so festgelegt, dass alle Benutzer einbezogen werden, deren Land USA ist. Außerdem wird der Anzeigename der Verwaltungseinheit aktualisiert.
Anforderung
PATCH https://graph.microsoft.com/beta/administrativeUnits/4d7ea995-bc0f-45c0-8c3e-132e93bf95f8
Content-type: application/json
{
"displayName": "Executive Division",
"membershipType": "Dynamic",
"membershipRule": "(user.country -eq \"United States\")",
"membershipRuleProcessingState": "On"
}
Antwort
HTTP/1.1 204 No Content