mailboxProtectionRule 资源类型
命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示与 Exchange 保护策略关联的保护规则的属性。
继承自 protectionRuleBase。
方法
| 方法 | 返回类型 | Description |
|---|---|---|
| List | mailboxProtectionRule 集合 | 获取 mailboxProtectionRule 对象及其属性的列表。 |
| 创建 | mailboxProtectionRule | 创建新的 mailboxProtectionRule。 |
| Get | mailboxProtectionRule | 读取 mailboxProtectionRule 的属性和关系。 |
| 删除 | None | 删除 mailboxProtectionRule。 |
| Run | protectionRuleBase | 激活邮箱保护规则。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 与策略关联的保护规则的唯一标识符。 |
| createdBy | identitySet | 创建规则的人员的标识。 |
| createdDateTime | DateTimeOffset | 创建规则的日期和时间。 |
| error | publicError | 如果规则表达式上的操作失败，则包含错误详细信息。 |
| isAutoApplyEnabled | 布尔值 |
true 指示保护规则是动态的; false 它是静态的。 静态规则运行一次，而动态规则将侦听系统中的所有更改并更新保护单元列表。 目前，仅支持静态规则。 |
| lastModifiedBy | identitySet | 上次修改此规则的人员的身份。 |
| lastModifiedDateTime | DateTimeOffset | 上次修改规则的时间戳。 |
| mailboxExpression | String | 包含邮箱表达式。 有关示例，请参阅 mailboxExpression 示例。 |
| status | protectionRuleStatus | 保护规则的状态。 可能的值包括 draft、active、completed、completedWithErrors、unknownFutureValue。 成员 draft 当前不受支持。 |
mailboxExpression 示例
下表显示了邮箱表达式的可能格式。
| 属性 | 运算符 | 示例 |
|---|---|---|
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'])) |
protectionRuleStatus 值
| 成员 | 说明 |
|---|---|
| 草案 | 创建保护规则时的初始状态。 成员 draft 当前不受支持。 |
| 积极 | 使用 /run API 时保护规则的状态。 |
| 完成 | 保护规则成功应用于相应策略后的状态。 |
| completedWithErrors | 保护规则应用于相应策略并发生任何失败后的状态。 |
| unknownFutureValue | 可演变枚举 sentinel 值。 请勿使用。 |
关系
无。
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"@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"
}