Type de ressource ruleBasedSubjectSet
Espace de noms : microsoft.graph.identityGovernance
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Spécifie les règles pour définir les sujets qui constituent l’étendue d’un déclencheur de workflow de cycle de vieAndScopeBasedConditions configuration.
Hérite de subjectSet.
Propriétés
| Propriété | Type | Description |
|---|---|---|
| règle | Chaîne | Règle pour l’ensemble de sujets. Les workflows de cycle de vie prennent en charge un ensemble complet de propriétés utilisateur pour la configuration des règles à l’aide d’expressions $filter de requête. Pour plus d’informations, consultez Paramètres d’utilisateur et de requête pris en charge. |
Remarque
L’évaluation de la règle respecte la casse.
Propriétés utilisateur et paramètres de requête pris en charge
Les workflows de cycle de vie prennent en charge les propriétés utilisateur suivantes pour la configuration des règles qui se trouvent dans l’étendue d’une condition d’exécution. Vous pouvez utiliser le $filter paramètre de requête OData avec les eqopérateurs , ne, inou startsWith . Vous pouvez également combiner les expressions de filtre à l’aide de l’un des opérateurs de conjonction et de disjonction suivants :
andor-
andetnot -
oretnot
| Propriété de l’utilisateur | Type de propriété | Prend en charge eq, ne, in | Prend en charge startsWith |
|---|---|---|---|
| accountEnabled | Boolean | ✔️ | |
| assignedPlans/any(a:a/capabilityStatus) | collection assignedPlan | ✔️ | |
| assignedPlans/any(a:a/service) | collection assignedPlan | ✔️ | |
| assignedPlans/any(a:a/servicePlanId) | collection assignedPlan | ✔️ | |
| Ville | String | ✔️ | ✔️ |
| CompanyName | Chaîne | ✔️ | ✔️ |
| country | String | ✔️ | ✔️ |
| customSecurityAttributes | Chaîne | ✔️ | ✔️ |
| Service | Chaîne | ✔️ | ✔️ |
| displayName | Chaîne | ✔️ | ✔️ |
| employeeId | String | ✔️ | |
| employeeOrgData/costCenter | employeeOrgData | ✔️ | |
| employeeOrgData/division | employeeOrgData | ✔️ | |
| employeeType | String | ✔️ | |
| faxNumber | String | ✔️ | ✔️ |
| givenName | Chaîne | ✔️ | ✔️ |
| jobTitle | Chaîne | ✔️ | ✔️ |
| messagerie | String | ✔️ | ✔️ |
| mailNickname | Chaîne | ✔️ | ✔️ |
| mobilePhone | Chaîne | ✔️ | ✔️ |
| officeLocation | Chaîne | ✔️ | ✔️ |
| onPremisesExtensionAttributes/extensionAttribute1 - 15 | onPremisesExtensionAttributes | ✔️ | |
| onPremisesSecurityIdentifier | String | ✔️ | |
| onPremisesSyncEnabled | Boolean | ✔️ | |
| otherMails/any(p:p) | Collection de chaînes | ✔️ | ✔️ |
| postalCode | String | ✔️ | ✔️ |
| preferredLanguage | Chaîne | ✔️ | ✔️ |
| proxyAddresses/any(p:p) | String collection | ✔️ | ✔️ |
| state | Chaîne | ✔️ | ✔️ |
| streetAddress | String | ✔️ | ✔️ |
| surname | Chaîne | ✔️ | ✔️ |
| usageLocation | String | ✔️ | ✔️ |
| userPrincipalName | String | ✔️ | ✔️ |
| userType | String | ✔️ |
Vous pouvez également configurer des règles à l’aide d’extensions d’annuaire (ID Microsoft Entra) et d’attributs de sécurité personnalisés. La configuration de règles avec des extensions de schéma ou des extensions ouvertes n’est pas prise en charge.
Remarque
L’utilisation d’attributs de sécurité personnalisés nécessite le rôle Administrateur d’attribution d’attributs. Pour plus d’informations, consultez : Administrateur d’attribution d’attributs.
Exemples de règles
| Exemple de règle | Description |
|---|---|
"rule": "(department eq 'Marketing')" |
Exécutez le workflow pour les utilisateurs du service « Marketing ». |
"rule": "(department ne 'Marketing')" |
Exécutez le workflow pour les utilisateurs qui ne sont pas dans le service « Marketing ». |
"rule": "(department in ('Marketing'))" |
Exécutez le workflow pour les utilisateurs du service « Marketing ». |
"rule": "(accountEnabled eq true)" |
Exécutez le flux de travail pour les utilisateurs dont le compte est activé. |
"rule": "(employeeOrgData/costCenter eq '100')" |
Exécutez le workflow pour les utilisateurs dont costCenter est 100. |
"rule": "(otherMails/any(p:startsWith(p, 'Av')))" |
Exécutez le flux de travail pour les utilisateurs dont otherMails commence par Av. |
"rule": "(department eq 'Marketing') and (accountEnabled in (true))" |
Exécutez le workflow pour les utilisateurs du service marketing et dont le compte est activé. |
"rule": "(department eq 'Marketing') or (not (city eq 'Redmond'))" |
Exécutez le flux de travail pour les utilisateurs du service marketing et dont la ville n’est pas « Redmond ». |
"rule": "(customSecurityAttributes/OnsightLocation/CustomerOnsite eq true)" |
Exécutez le flux de travail pour les utilisateurs dont l’attribut de sécurité personnalisé pour CustomerOnSite est défini sur true. |
Relations
Aucun.
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"@odata.type": "#microsoft.graph.identityGovernance.ruleBasedSubjectSet",
"rule": "String"
}