Compartilhar via


mailboxProtectionRule resource type

Namespace: microsoft.graph

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.

Representa as propriedades de uma regra de proteção associada a uma política de proteção do Exchange.

Herda de protectionRuleBase.

Métodos

Método Tipo de retorno Descrição
List coleção mailboxProtectionRule Obtenha uma lista dos objetos mailboxProtectionRule e respetivas propriedades.
Create mailboxProtectionRule Crie uma nova caixa de correioProtectionRule.
Get mailboxProtectionRule Leia as propriedades e relações de uma caixa de correioProtectionRule.
Delete Nenhum Eliminar uma caixa de correioProtectionRule.
Run protectionRuleBase Ativar uma regra de proteção de caixa de correio.

Propriedades

Propriedade Tipo Descrição
id Cadeia de caracteres O identificador exclusivo da regra de proteção associada à política.
createdBy identitySet A identidade da pessoa que criou a regra.
createdDateTime DateTimeOffset A data e hora em que a regra foi criada.
erro publicError Contém detalhes de erro se uma operação numa expressão de regra falhar.
isAutoApplyEnabled Booliano true indica que a regra de proteção é dinâmica; false que é estático. As regras estáticas são executadas uma vez enquanto as regras dinâmicas ouvem todas as alterações no sistema e atualizam a lista de unidades de proteção. Atualmente, apenas são suportadas regras estáticas.
lastModifiedBy identitySet Identidade da pessoa que modificou esta regra pela última vez.
lastModifiedDateTime DateTimeOffset Carimbo de data/hora da última modificação à regra.
mailboxExpression Cadeia de caracteres Contém uma expressão de caixa de correio. Para obter exemplos, veja mailboxExpression examples (Exemplos de impressão em série).
status protectionRuleStatus Estado da regra de proteção. Os valores possíveis são: draft, active, completed, completedWithErrors, unknownFutureValue. O draft membro não é atualmente suportado.

mailboxExpression examples (exemplos de mailboxExpression)

A tabela seguinte mostra os formatos possíveis para a expressão da caixa de correio.

Propriedade Operador Exemplo
memberOf -any (memberOf -any (group.id -in ['d7f5150a-0c6f-4894-a6a1-6df77b26f375']))
group.id -in (memberOf -any (group.id -in ['d7f5150a-0c6f-4894-a6a1-6df77b26f375', '363cdbd0-f091-4644-93e4-64c1020c94d8']))

valores protectionRuleStatus

Member Descrição
rascunho O status inicial da regra de proteção após a criação. O draft membro não é atualmente suportado.
ativo A status da regra de proteção ao utilizar a /run API.
concluído A status da regra de proteção depois de ser aplicada com êxito à política correspondente.
completedWithErrors O status da regra de proteção depois de ser aplicada à política correspondente e quaisquer falhas ocorridas.
unknownFutureValue Valor da sentinela de enumeração evoluível. Não usar.

Relações

Nenhum

Representação JSON

A representação JSON seguinte mostra o tipo de recurso.

{
  "@odata.type": "#microsoft.graph.mailboxProtectionRule",
  "id": "String (identifier)",
  "status": "String",
  "createdDateTime": "String (timestamp)",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "error": {
    "@odata.type": "microsoft.graph.publicError"
  },
  "isAutoApplyEnabled": "Boolean",
  "mailboxExpression": "String"
}