Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph.identityGovernance
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.
Gibt die Regeln an, die die Subjekte im Bereich eines Lebenszyklusworkflows definieren. Dieses Objekt wird in der scope-Eigenschaft der triggerAndScopeBasedConditions-Ressource konfiguriert.
Erbt von subjectSet.
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| Regel | Zeichenfolge | Die Regel für den Betreff-Satz. Lebenszyklusworkflows unterstützen eine Vielzahl von Benutzereigenschaften zum Konfigurieren der Regeln mithilfe $filter von Abfrageausdrücken. Weitere Informationen finden Sie unter Unterstützte Benutzer- und Abfrageparameter. |
Hinweis
Bei der Regelauswertung wird zwischen Groß- und Kleinschreibung unterschieden.
Unterstützte Benutzereigenschaften und Abfrageparameter
Lifecycle Workflows unterstützt die folgenden Benutzereigenschaften zum Konfigurieren der Regeln, die sich im Bereich einer Ausführungsbedingung befinden. Sie können den OData-Abfrageparameter $filter entweder mit den eqOperatoren , ne, inoder startsWith verwenden. Sie können die Filterausdrücke auch mit einem der folgenden Konjunktions- und Disjunktionsoperatoren kombinieren:
andor-
andundnot -
orundnot
| Benutzereigenschaft | Eigenschaftentyp | Unterstützt eq, ne, in | Unterstützt startsWith |
|---|---|---|---|
| accountEnabled | Boolean | ✔️ | |
| assignedPlans/any(a:a/capabilityStatus) | assignedPlan collection | ✔️ | |
| assignedPlans/any(a:a/service) | assignedPlan collection | ✔️ | |
| assignedPlans/any(a:a/servicePlanId) | assignedPlan collection | ✔️ | |
| Ort | Zeichenfolge | ✔️ | ✔️ |
| CompanyName | String | ✔️ | ✔️ |
| Land/Region | Zeichenfolge | ✔️ | ✔️ |
| customSecurityAttributes | Zeichenfolge | ✔️ | ✔️ |
| department | Zeichenfolge | ✔️ | ✔️ |
| displayName | Zeichenfolge | ✔️ | ✔️ |
| employeeId | String | ✔️ | |
| employeeOrgData/costCenter | employeeOrgData | ✔️ | |
| employeeOrgData/division | employeeOrgData | ✔️ | |
| employeeType | Zeichenfolge | ✔️ | |
| faxNumber | String | ✔️ | ✔️ |
| givenName | Zeichenfolge | ✔️ | ✔️ |
| jobTitle | Zeichenfolge | ✔️ | ✔️ |
| Zeichenfolge | ✔️ | ✔️ | |
| mailNickname | Zeichenfolge | ✔️ | ✔️ |
| mobilePhone | String | ✔️ | ✔️ |
| officeLocation | String | ✔️ | ✔️ |
| onPremisesExtensionAttributes/extensionAttribute1 – 15 | onPremisesExtensionAttributes | ✔️ | |
| onPremisesSecurityIdentifier | Zeichenfolge | ✔️ | |
| onPremisesSyncEnabled | Boolean | ✔️ | |
| otherMails/any(p:p) | Zeichenfolgenauflistung | ✔️ | ✔️ |
| postalCode | Zeichenfolge | ✔️ | ✔️ |
| preferredLanguage | Zeichenfolge | ✔️ | ✔️ |
| proxyAddresses/any(p:p) | String collection | ✔️ | ✔️ |
| state | Zeichenfolge | ✔️ | ✔️ |
| streetAddress | String | ✔️ | ✔️ |
| surname | Zeichenfolge | ✔️ | ✔️ |
| usageLocation | Zeichenfolge | ✔️ | ✔️ |
| userPrincipalName | Zeichenfolge | ✔️ | ✔️ |
| userType | Zeichenfolge | ✔️ |
Sie können Regeln auch mithilfe von Directory-Erweiterungen (Microsoft Entra ID) und benutzerdefinierten Sicherheitsattributen konfigurieren. Das Konfigurieren von Regeln mit Schemaerweiterungen oder offenen Erweiterungen wird nicht unterstützt.
Hinweis
Für die Verwendung benutzerdefinierter Sicherheitsattribute ist die Rolle "Attributzuweisungsadministrator" erforderlich. Weitere Informationen finden Sie unter Attributzuweisungsadministrator.
Beispiele für Regeln
| Beispielregel | Beschreibung |
|---|---|
"rule": "(department eq 'Marketing')" |
Führen Sie den Workflow für Benutzer in der Abteilung "Marketing" aus. |
"rule": "(department ne 'Marketing')" |
Führen Sie den Workflow für Benutzer aus, die nicht der Abteilung "Marketing" angehören. |
"rule": "(department in ('Marketing'))" |
Führen Sie den Workflow für Benutzer in der Abteilung "Marketing" aus. |
"rule": "(accountEnabled eq true)" |
Führen Sie den Workflow für Benutzer aus, deren Konto aktiviert ist. |
"rule": "(employeeOrgData/costCenter eq '100')" |
Führen Sie den Workflow für Benutzer aus, deren costCenter den Wert 100. |
"rule": "(otherMails/any(p:startsWith(p, 'Av')))" |
Führen Sie den Workflow für Benutzer aus, deren otherMails mit Avbeginnt. |
"rule": "(department eq 'Marketing') and (accountEnabled in (true))" |
Führen Sie den Workflow für Benutzer in der Marketingabteilung aus, deren Konto aktiviert ist. |
"rule": "(department eq 'Marketing') or (not (city eq 'Redmond'))" |
Führen Sie den Workflow für Benutzer in der Marketingabteilung aus, deren Ort nicht "Redmond" ist. |
"rule": "(customSecurityAttributes/OnsightLocation/CustomerOnsite eq true)" |
Führen Sie den Workflow für Benutzer aus, bei denen das benutzerdefinierte Sicherheitsattribut für CustomerOnSite auf "true" festgelegt ist. |
Beziehungen
Keine.
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"@odata.type": "#microsoft.graph.identityGovernance.ruleBasedSubjectSet",
"rule": "String"
}