tipo de recurso ruleBasedSubjectSet

Espacio de nombres: microsoft.graph.identityGovernance

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Especifica las reglas para definir los asuntos que son el ámbito de una configuración triggerAndScopeBasedConditions del flujo de trabajo del ciclo de vida.

Hereda de subjectSet.

Propiedades

Propiedad Tipo Descripción
Regla Cadena Regla del conjunto de asuntos. Los flujos de trabajo de ciclo de vida admiten un amplio conjunto de propiedades de usuario para configurar las reglas mediante $filter expresiones de consulta. Para obtener más información, consulte parámetros de consulta y usuario admitidos.

Nota:

La evaluación de reglas distingue mayúsculas de minúsculas.

Propiedades de usuario y parámetros de consulta admitidos

Los flujos de trabajo de ciclo de vida admiten las siguientes propiedades de usuario para configurar las reglas que están en el ámbito de una condición de ejecución. Puede usar el $filter parámetro de consulta OData con los eqoperadores , ne, ino startsWith . También puede combinar las expresiones de filtro mediante uno de los operadores de conjunción y disyunción siguientes:

  • and
  • or
  • and y not
  • or y not
User (propiedad) Tipo de propiedad Admite eq, ne, in Admite startsWith
accountEnabled Booleano ✔️  
assignedPlans/any(a:a/capabilityStatus) Colección assignedPlan ✔️  
assignedPlans/any(a:a/service) Colección assignedPlan ✔️  
assignedPlans/any(a:a/servicePlanId) Colección assignedPlan ✔️  
city Cadena ✔️ ✔️
CompanyName String ✔️ ✔️
country Cadena ✔️ ✔️
department Cadena ✔️ ✔️
displayName Cadena ✔️ ✔️
employeeId Cadena ✔️  
employeeOrgData/costCenter employeeOrgData ✔️  
employeeOrgData/division employeeOrgData ✔️  
employeeType Cadena ✔️  
faxNumber Cadena ✔️ ✔️
givenName Cadena ✔️ ✔️
jobTitle Cadena ✔️ ✔️
mail Cadena ✔️ ✔️
mailNickname Cadena ✔️ ✔️
mobilePhone String ✔️ ✔️
officeLocation String ✔️ ✔️
onPremisesExtensionAttributes/extensionAttribute1 - 15 onPremisesExtensionAttributes ✔️  
onPremisesSecurityIdentifier Cadena ✔️  
onPremisesSyncEnabled Booleano ✔️  
otherMails/any(p:p) Colección de cadenas ✔️ ✔️
postalCode String ✔️ ✔️
preferredLanguage Cadena ✔️ ✔️
proxyAddresses/any(p:p) Colección string ✔️ ✔️
state Cadena ✔️ ✔️
streetAddress String ✔️ ✔️
surname Cadena ✔️ ✔️
usageLocation Cadena ✔️ ✔️
userPrincipalName Cadena ✔️ ✔️
userType Cadena ✔️  

También puede configurar reglas mediante extensiones de directorio (Microsoft Entra ID). No se admite la configuración de reglas con extensiones de esquema, extensiones abiertas o atributos de seguridad personalizados.

Ejemplos de reglas

Regla de ejemplo Descripción
"rule": "(department eq 'Marketing')" Ejecute el flujo de trabajo para los usuarios en el departamento "Marketing".
"rule": "(department ne 'Marketing')" Ejecute el flujo de trabajo para los usuarios que no están en el departamento "Marketing".
"rule": "(department in ('Marketing'))" Ejecute el flujo de trabajo para los usuarios en el departamento "Marketing".
"rule": "(accountEnabled eq true)" Ejecute el flujo de trabajo para los usuarios cuya cuenta está habilitada.
"rule": "(employeeOrgData/costCenter eq '100')" Ejecute el flujo de trabajo para los usuarios cuyo costCenter es 100.
"rule": "(otherMails/any(p:startsWith(p, 'Av')))" Ejecute el flujo de trabajo para los usuarios cuyos otrosmails comienzan por Av.
"rule": "(department eq 'Marketing') and (accountEnabled in (true))" Ejecute el flujo de trabajo para los usuarios del departamento de marketing y cuya cuenta está habilitada.
"rule": "(department eq 'Marketing') or (not (city eq 'Redmond'))" Ejecute el flujo de trabajo para los usuarios del departamento de marketing y cuya ciudad no sea "Redmond".

Relaciones

Ninguna.

Representación JSON

La siguiente es una representación JSON del recurso

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