ruleBasedSubjectSet-Ressourcentyp

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 zum Definieren der Themen an, die der Bereich einer triggerAndScopeBasedConditions-Konfiguration des Lebenszyklusworkflows sind.

Erbt von subjectSet.

Eigenschaften

Eigenschaft	Typ	Beschreibung
Regel	String	Die Regel für den Betreffsatz. Lebenszyklusworkflows unterstützen eine Vielzahl von Benutzereigenschaften zum Konfigurieren der Regeln mithilfe von $filter Abfrageausdrücken. Weitere Informationen finden Sie unter Unterstützte Benutzer- und Abfrageparameter.

Hinweis

Bei der Regelauswertung wird die Groß-/Kleinschreibung beachtet.

Unterstützte Benutzereigenschaften und Abfrageparameter

Lebenszyklus-Workflows unterstützen die folgenden Benutzereigenschaften zum Konfigurieren der Regeln, die sich im Bereich einer Ausführungsbedingung befinden. Sie können den $filter OData-Abfrageparameter mit den eqOperatoren , ne, inoder startsWith verwenden. Sie können die Filterausdrücke auch mit einem der folgenden Konjunktions- und Disjunktionsoperatoren kombinieren:

• and
• or
• and und not
• or und not

User-Eigenschaft	Eigenschaftentyp	Unterstützt eq, ne, in	Unterstützt startsWith
accountEnabled	Boolesch	✔️
assignedPlans/any(a:a/capabilityStatus)	assignedPlan collection	✔️
assignedPlans/any(a:a/service)	assignedPlan collection	✔️
assignedPlans/any(a:a/servicePlanId)	assignedPlan collection	✔️
Ort	String	✔️	✔️
CompanyName	String	✔️	✔️
Land/Region	String	✔️	✔️
customSecurityAttributes	String	✔️	✔️
department	String	✔️	✔️
displayName	String	✔️	✔️
employeeId	String	✔️
employeeOrgData/costCenter	employeeOrgData	✔️
employeeOrgData/division	employeeOrgData	✔️
employeeType	Zeichenfolge	✔️
faxNumber	String	✔️	✔️
givenName	String	✔️	✔️
jobTitle	String	✔️	✔️
mail	String	✔️	✔️
mailNickname	String	✔️	✔️
mobilePhone	String	✔️	✔️
officeLocation	String	✔️	✔️
onPremisesExtensionAttributes/extensionAttribute1 – 15	onPremisesExtensionAttributes	✔️
onPremisesSecurityIdentifier	String	✔️
onPremisesSyncEnabled	Boolesch	✔️
otherMails/any(p:p)	Zeichenfolgenauflistung	✔️	✔️
postalCode	String	✔️	✔️
preferredLanguage	String	✔️	✔️
proxyAddresses/any(p:p)	String collection	✔️	✔️
state	String	✔️	✔️
streetAddress	String	✔️	✔️
surname	String	✔️	✔️
usageLocation	String	✔️	✔️
userPrincipalName	String	✔️	✔️
userType	String	✔️

Sie können Regeln auch mithilfe von Verzeichniserweiterungen (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 in der Abteilung "Marketing" sind.
"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 ist 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 Stadt nicht "Redmond" ist.
"rule": "(customSecurityAttributes/OnsightLocation/CustomerOnsite eq true)"	Führen Sie den Workflow für Benutzer aus, für die das benutzerdefinierte Sicherheitssattribut für CustomerOnSite auf true festgelegt ist.

Beziehungen

Keine.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "@odata.type": "#microsoft.graph.identityGovernance.ruleBasedSubjectSet",
  "rule": "String"
}