tipo de recurso ruleBasedSubjectSet

  • Artigo

Namespace: microsoft.graph.identityGovernance

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Especifica as regras para definir os sujeitos que são o escopo de um gatilho de fluxo de trabalho de ciclo de vidaAndScopeBasedConditions configuração .

Herda do subjectSet.

Propriedades

Propriedade Tipo Descrição
Regra Cadeia de caracteres A regra do conjunto de assuntos. Os fluxos de trabalho do ciclo de vida dão suporte a um conjunto avançado de propriedades do usuário para configurar as regras usando $filter expressões de consulta. Para obter mais informações, consulte parâmetros de consulta e usuário com suporte.

Observação

A avaliação de regra é sensível a casos.

Propriedades de usuário com suporte e parâmetros de consulta

Os fluxos de trabalho do ciclo de vida dão suporte às seguintes propriedades de usuário para configurar as regras que estão no escopo de uma condição de execução. Você pode usar o $filter parâmetro de consulta OData com os eqoperadores , ne, ou startsWithin. Você também pode combinar as expressões de filtro usando um dos seguintes operadores de conjunção e disjunção:

  • and
  • or
  • and e not
  • or e not
Propriedade user Tipo de propriedade Dá suporte a eq, ne, in Dá suporte ao startsWith
accountEnabled Booliano ✔️  
assignedPlans/any(a:a/capabilityStatus) Coleção assignedPlan ✔️  
assignedPlans/any(a:a/service) Coleção assignedPlan ✔️  
assignedPlans/any(a:a/servicePlanId) Coleção assignedPlan ✔️  
city Cadeia de caracteres ✔️ ✔️
CompanyName String ✔️ ✔️
country Cadeia de caracteres ✔️ ✔️
department String ✔️ ✔️
displayName Cadeia de caracteres ✔️ ✔️
employeeId String ✔️  
employeeOrgData/costCenter employeeOrgData ✔️  
employeeOrgData/division employeeOrgData ✔️  
employeeType String ✔️  
FaxNumber String ✔️ ✔️
givenName Cadeia de caracteres ✔️ ✔️
jobTitle String ✔️ ✔️
email String ✔️ ✔️
mailNickname String ✔️ ✔️
mobilePhone String ✔️ ✔️
officeLocation String ✔️ ✔️
onPremisesExtensionAttributes/extensionAttribute1 - 15 onPremisesExtensionAttributes ✔️  
onPremisesSecurityIdentifier String ✔️  
onPremisesSyncEnabled Booliano ✔️  
otherMails/any(p:p) String Collection ✔️ ✔️
postalCode Cadeia de caracteres ✔️ ✔️
preferredLanguage Cadeia de caracteres ✔️ ✔️
proxyAddresses/any(p:p) String collection ✔️ ✔️
state Cadeia de caracteres ✔️ ✔️
streetAddress String ✔️ ✔️
surname Cadeia de caracteres ✔️ ✔️
usageLocation String ✔️ ✔️
userPrincipalName Cadeia de caracteres ✔️ ✔️
userType String ✔️  

Você também pode configurar regras usando extensões de Diretório (Microsoft Entra ID). Não há suporte para configurar regras com extensões de esquema, extensões abertas ou atributos de segurança personalizados.

Exemplos de regras

Regra de exemplo Descrição
"rule": "(department eq 'Marketing')" Execute o fluxo de trabalho para usuários no departamento de "Marketing".
"rule": "(department ne 'Marketing')" Execute o fluxo de trabalho para usuários que não estão no departamento de "Marketing".
"rule": "(department in ('Marketing'))" Execute o fluxo de trabalho para usuários no departamento de "Marketing".
"rule": "(accountEnabled eq true)" Execute o fluxo de trabalho para usuários cuja conta está habilitada.
"rule": "(employeeOrgData/costCenter eq '100')" Execute o fluxo de trabalho para usuários cujo custoCenter é 100.
"rule": "(otherMails/any(p:startsWith(p, 'Av')))" Execute o fluxo de trabalho para usuários cujos outrosMails começam com Av.
"rule": "(department eq 'Marketing') and (accountEnabled in (true))" Execute o fluxo de trabalho para usuários no departamento de marketing e cuja conta está habilitada.
"rule": "(department eq 'Marketing') or (not (city eq 'Redmond'))" Execute o fluxo de trabalho para usuários no departamento de marketing e cuja cidade não é "Redmond".

Relações

Nenhum

Representação JSON

Veja a seguir uma representação JSON do recurso.

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