Skip to content

exchangeprotectionpolicy.md

Latest commit

 

History

History
76 lines (66 loc) · 5.53 KB

exchangeprotectionpolicy.md

File metadata and controls

76 lines (66 loc) · 5.53 KB
title exchangeProtectionPolicy resource type
description Represents the plan defined by the Global Admin or Exchange Online Admin to protect Exchange Online.
author tushar20
ms.reviewer manikantsinghms
ms.localizationpriority medium
ms.subservice m365-backup-storage
doc_type resourcePageType
ms.date 05/30/2024
ms.custom sfi-ga-nochange

exchangeProtectionPolicy resource type

Namespace: microsoft.graph

[!INCLUDE beta-disclaimer]

Represents the plan defined by the Exchange Online Admin to protect Exchange Online. The Exchange protection policy defines what mailbox data to protect, when to protect it, and for what time period to retain the protected data.

Inherits from protectionPolicyBase.

Methods

Method Return type Description
Create exchangeProtectionPolicy Create a new exchangeProtectionPolicy.
Update exchangeProtectionPolicy Update the properties of an exchangeProtectionPolicy.

Properties

Property Type Description
createdBy identitySet The identity of person who created the policy. Inherited from protectionPolicyBase.
createdDateTime DateTimeOffset The date and time when the policy was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Inherited from protectionPolicyBase.
displayName String Name of the policy to be created. Inherited from protectionPolicyBase.
id String The unique identifier of the protection rule associated to the policy. Inherited from protectionPolicyBase.
isEnabled Boolean Indicates whether the policy is enabled. Inherited from protectionPolicyBase.
lastModifiedBy identitySet The identity of the person who last modified the policy. Inherited from protectionPolicyBase.
lastModifiedDateTime DateTimeOffset The date and time when the policy was last modified. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Inherited from protectionPolicyBase.
offboardRequestedDateTime DateTimeOffset The date and time when offboarding was requested for the protection policy. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Inherited from protectionPolicyBase.
protectionPolicyArtifactCount protectionPolicyArtifactCount The count of artifacts in the protection policy by status. Returned only on $select. Inherited from protectionPolicyBase.
retentionSettings retentionSetting collection Contains the retention setting details for the policy. Inherited from protectionPolicyBase.
status protectionPolicyStatus Status of the policy. This value is an aggregated status of the protection units. The possible values are: inactive, activeWithErrors, updating, active, unknownFutureValue, offboardRequested, offboarded. You must use the Prefer: include-unknown-enum-members request header to get the following values in this evolvable enum: offboardRequested, offboarded. Inherited from protectionPolicyBase.

Relationships

Relationship Type Description
mailboxInclusionRules mailboxProtectionRule collection The rules associated with the Exchange protection policy.
mailboxProtectionUnits mailboxProtectionUnit collection The protection units (mailboxes) that are protected under the Exchange protection policy.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.exchangeProtectionPolicy",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "displayName": "String",
  "id": "String (identifier)",
  "isEnabled": "Boolean",
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "String (timestamp)",
  "offboardRequestedDateTime": "String (timestamp)",
  "protectionPolicyArtifactCount": {"@odata.type": "microsoft.graph.protectionPolicyArtifactCount"},
  "retentionSettings": [{"@odata.type": "microsoft.graph.retentionSetting"}],
  "status": "String"
}