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.
Parameter properties
Type:
System.DateTime
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-DisplayName
The name of the policy to be created.
Parameter properties
Type:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-ExchangeProtectionPolicyId
The unique identifier of exchangeProtectionPolicy
Parameter properties
Type:
System.String
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateExpanded
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
Update
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Headers
Optional headers that will be added to the request.
Parameter properties
Type:
System.Collections.IDictionary
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
True
Value from pipeline by property name:
False
Value from remaining arguments:
False
-HttpPipelineAppend
SendAsync Pipeline Steps to be appended to the front of the pipeline
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.
Parameter properties
Type:
System.DateTime
Supports wildcards:
False
DontShow:
False
Parameter sets
UpdateViaIdentityExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
UpdateExpanded
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-MailboxInclusionRules
The rules associated with the Exchange protection policy.
To construct, see NOTES section for MAILBOXINCLUSIONRULES properties and create a hash table.
The protection units (mailboxes) that are protected under the Exchange protection policy.
To construct, see NOTES section for MAILBOXPROTECTIONUNITS properties and create a hash table.
Runs the command in a mode that only reports what would happen without performing the actions.
Parameter properties
Type:
System.Management.Automation.SwitchParameter
Supports wildcards:
False
DontShow:
False
Aliases:
wi
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see
about_CommonParameters.
To create the parameters described below, construct a hash table containing the appropriate properties.
For information on hash tables, run Get-Help about_Hash_Tables.
BODYPARAMETER <IMicrosoftGraphExchangeProtectionPolicy>: exchangeProtectionPolicy
[(Any) <Object>]: This indicates any property can be added to this object.
[BillingPolicyId <String>]:
[CreatedBy <IMicrosoftGraphIdentitySet>]: identitySet
[(Any) <Object>]: This indicates any property can be added to this object.
[Application <IMicrosoftGraphIdentity>]: identity
[(Any) <Object>]: This indicates any property can be added to this object.
[DisplayName <String>]: The display name of the identity.
This property is read-only.
[Id <String>]: The identifier of the identity.
This property is read-only.
[Device <IMicrosoftGraphIdentity>]: identity
[User <IMicrosoftGraphIdentity>]: identity
[CreatedDateTime <DateTime?>]: 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.
[DisplayName <String>]: The name of the policy to be created.
[IsEnabled <Boolean?>]: Indicates whether the policy is enabled.
[LastModifiedBy <IMicrosoftGraphIdentitySet>]: identitySet
[LastModifiedDateTime <DateTime?>]: 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.
[ProtectionPolicyArtifactCount <IMicrosoftGraphProtectionPolicyArtifactCount>]: protectionPolicyArtifactCount
[(Any) <Object>]: This indicates any property can be added to this object.
[Completed <Int32?>]: The number of artifacts whose protection is completed.
[Failed <Int32?>]: The number of artifacts whose protection failed.
[InProgress <Int32?>]: The number of artifacts whose protection is in progress.
[Total <Int32?>]: The number of artifacts present in the protection policy.
[RetentionSettings <IMicrosoftGraphRetentionSetting[]>]: Contains the retention setting details for the policy.
[Interval <String>]: The frequency of the backup.
[Period <TimeSpan?>]: The period of time to retain the protected data for a single Microsoft 365 service.
[Status <String>]: protectionPolicyStatus
[Id <String>]: The unique identifier for an entity.
Read-only.
[MailboxInclusionRules <IMicrosoftGraphMailboxProtectionRule[]>]: The rules associated with the Exchange protection policy.
[CreatedBy <IMicrosoftGraphIdentitySet>]: identitySet
[CreatedDateTime <DateTime?>]: The time of creation of the rule.
[Error <IMicrosoftGraphPublicError>]: publicError
[(Any) <Object>]: This indicates any property can be added to this object.
[Code <String>]: Represents the error code.
[Details <IMicrosoftGraphPublicErrorDetail[]>]: Details of the error.
[Code <String>]: The error code.
[Message <String>]: The error message.
[Target <String>]: The target of the error.
[InnerError <IMicrosoftGraphPublicInnerError>]: publicInnerError
[(Any) <Object>]: This indicates any property can be added to this object.
[Code <String>]: The error code.
[Details <IMicrosoftGraphPublicErrorDetail[]>]: A collection of error details.
[Message <String>]: The error message.
[Target <String>]: The target of the error.
[Message <String>]: A non-localized message for the developer.
[Target <String>]: The target of the error.
[IsAutoApplyEnabled <Boolean?>]: true indicates that the protection rule is dynamic; false that it's static.
[LastModifiedBy <IMicrosoftGraphIdentitySet>]: identitySet
[LastModifiedDateTime <DateTime?>]: Timestamp of the last modification made to the rule.
[Status <String>]: protectionRuleStatus
[Id <String>]: The unique identifier for an entity.
Read-only.
[MailboxExpression <String>]: Contains a mailbox expression.
For examples, see mailboxExpression examples.
[MailboxProtectionUnits <IMicrosoftGraphMailboxProtectionUnit[]>]: The protection units (mailboxes) that are protected under the Exchange protection policy.
[CreatedBy <IMicrosoftGraphIdentitySet>]: identitySet
[CreatedDateTime <DateTime?>]: The time of creation of the protection unit.
[Error <IMicrosoftGraphPublicError>]: publicError
[LastModifiedBy <IMicrosoftGraphIdentitySet>]: identitySet
[LastModifiedDateTime <DateTime?>]: Timestamp of the last modification of this protection unit.
[OffboardRequestedDateTime <DateTime?>]: The time when protection unit offboard was requested.
[PolicyId <String>]: The unique identifier of the protection policy based on which protection unit was created.
[ProtectionSources <String>]: protectionSource
[Status <String>]: protectionUnitStatus
[Id <String>]: The unique identifier for an entity.
Read-only.
[DirectoryObjectId <String>]: The ID of the directory object.
[MailboxType <String>]: mailboxType
[MailboxProtectionUnitsBulkAdditionJobs <IMicrosoftGraphMailboxProtectionUnitsBulkAdditionJob[]>]:
[CreatedBy <IMicrosoftGraphIdentitySet>]: identitySet
[CreatedDateTime <DateTime?>]: The time of creation of the job.
[DisplayName <String>]: The name of the protection units bulk addition job.
[Error <IMicrosoftGraphPublicError>]: publicError
[LastModifiedBy <IMicrosoftGraphIdentitySet>]: identitySet
[LastModifiedDateTime <DateTime?>]: Timestamp of the last modification made to the job.
[Status <String>]: protectionUnitsBulkJobStatus
[Id <String>]: The unique identifier for an entity.
Read-only.
[DirectoryObjectIds <String[]>]: The list of Exchange directoryObjectIds to add to the Exchange protection policy.
[Mailboxes <String[]>]: The list of Exchange email addresses to add to the Exchange protection policy.
CREATEDBY <IMicrosoftGraphIdentitySet>: identitySet
[(Any) <Object>]: This indicates any property can be added to this object.
[Application <IMicrosoftGraphIdentity>]: identity
[(Any) <Object>]: This indicates any property can be added to this object.
[DisplayName <String>]: The display name of the identity.
This property is read-only.
[Id <String>]: The identifier of the identity.
This property is read-only.
[Device <IMicrosoftGraphIdentity>]: identity
[User <IMicrosoftGraphIdentity>]: identity
INPUTOBJECT <IBackupRestoreIdentity>: Identity Parameter
[DriveProtectionRuleId <String>]: The unique identifier of driveProtectionRule
[DriveProtectionUnitId <String>]: The unique identifier of driveProtectionUnit
[DriveProtectionUnitsBulkAdditionJobId <String>]: The unique identifier of driveProtectionUnitsBulkAdditionJob
[DriveRestoreArtifactId <String>]: The unique identifier of driveRestoreArtifact
[DriveRestoreArtifactsBulkAdditionRequestId <String>]: The unique identifier of driveRestoreArtifactsBulkAdditionRequest
[ExchangeProtectionPolicyId <String>]: The unique identifier of exchangeProtectionPolicy
[ExchangeRestoreSessionId <String>]: The unique identifier of exchangeRestoreSession
[GranularMailboxRestoreArtifactId <String>]: The unique identifier of granularMailboxRestoreArtifact
[MailboxProtectionRuleId <String>]: The unique identifier of mailboxProtectionRule
[MailboxProtectionUnitId <String>]: The unique identifier of mailboxProtectionUnit
[MailboxProtectionUnitsBulkAdditionJobId <String>]: The unique identifier of mailboxProtectionUnitsBulkAdditionJob
[MailboxRestoreArtifactId <String>]: The unique identifier of mailboxRestoreArtifact
[MailboxRestoreArtifactsBulkAdditionRequestId <String>]: The unique identifier of mailboxRestoreArtifactsBulkAdditionRequest
[OneDriveForBusinessProtectionPolicyId <String>]: The unique identifier of oneDriveForBusinessProtectionPolicy
[OneDriveForBusinessRestoreSessionId <String>]: The unique identifier of oneDriveForBusinessRestoreSession
[ProtectionPolicyBaseId <String>]: The unique identifier of protectionPolicyBase
[ProtectionUnitBaseId <String>]: The unique identifier of protectionUnitBase
[RestorePointId <String>]: The unique identifier of restorePoint
[RestoreSessionBaseId <String>]: The unique identifier of restoreSessionBase
[ServiceAppId <String>]: The unique identifier of serviceApp
[SharePointProtectionPolicyId <String>]: The unique identifier of sharePointProtectionPolicy
[SharePointRestoreSessionId <String>]: The unique identifier of sharePointRestoreSession
[SiteProtectionRuleId <String>]: The unique identifier of siteProtectionRule
[SiteProtectionUnitId <String>]: The unique identifier of siteProtectionUnit
[SiteProtectionUnitsBulkAdditionJobId <String>]: The unique identifier of siteProtectionUnitsBulkAdditionJob
[SiteRestoreArtifactId <String>]: The unique identifier of siteRestoreArtifact
[SiteRestoreArtifactsBulkAdditionRequestId <String>]: The unique identifier of siteRestoreArtifactsBulkAdditionRequest
LASTMODIFIEDBY <IMicrosoftGraphIdentitySet>: identitySet
[(Any) <Object>]: This indicates any property can be added to this object.
[Application <IMicrosoftGraphIdentity>]: identity
[(Any) <Object>]: This indicates any property can be added to this object.
[DisplayName <String>]: The display name of the identity.
This property is read-only.
[Id <String>]: The identifier of the identity.
This property is read-only.
[Device <IMicrosoftGraphIdentity>]: identity
[User <IMicrosoftGraphIdentity>]: identity
MAILBOXINCLUSIONRULES <IMicrosoftGraphMailboxProtectionRule[]>: The rules associated with the Exchange protection policy.
[CreatedBy <IMicrosoftGraphIdentitySet>]: identitySet
[(Any) <Object>]: This indicates any property can be added to this object.
[Application <IMicrosoftGraphIdentity>]: identity
[(Any) <Object>]: This indicates any property can be added to this object.
[DisplayName <String>]: The display name of the identity.
This property is read-only.
[Id <String>]: The identifier of the identity.
This property is read-only.
[Device <IMicrosoftGraphIdentity>]: identity
[User <IMicrosoftGraphIdentity>]: identity
[CreatedDateTime <DateTime?>]: The time of creation of the rule.
[Error <IMicrosoftGraphPublicError>]: publicError
[(Any) <Object>]: This indicates any property can be added to this object.
[Code <String>]: Represents the error code.
[Details <IMicrosoftGraphPublicErrorDetail[]>]: Details of the error.
[Code <String>]: The error code.
[Message <String>]: The error message.
[Target <String>]: The target of the error.
[InnerError <IMicrosoftGraphPublicInnerError>]: publicInnerError
[(Any) <Object>]: This indicates any property can be added to this object.
[Code <String>]: The error code.
[Details <IMicrosoftGraphPublicErrorDetail[]>]: A collection of error details.
[Message <String>]: The error message.
[Target <String>]: The target of the error.
[Message <String>]: A non-localized message for the developer.
[Target <String>]: The target of the error.
[IsAutoApplyEnabled <Boolean?>]: true indicates that the protection rule is dynamic; false that it's static.
[LastModifiedBy <IMicrosoftGraphIdentitySet>]: identitySet
[LastModifiedDateTime <DateTime?>]: Timestamp of the last modification made to the rule.
[Status <String>]: protectionRuleStatus
[Id <String>]: The unique identifier for an entity.
Read-only.
[MailboxExpression <String>]: Contains a mailbox expression.
For examples, see mailboxExpression examples.
MAILBOXPROTECTIONUNITS <IMicrosoftGraphMailboxProtectionUnit[]>: The protection units (mailboxes) that are protected under the Exchange protection policy.
[CreatedBy <IMicrosoftGraphIdentitySet>]: identitySet
[(Any) <Object>]: This indicates any property can be added to this object.
[Application <IMicrosoftGraphIdentity>]: identity
[(Any) <Object>]: This indicates any property can be added to this object.
[DisplayName <String>]: The display name of the identity.
This property is read-only.
[Id <String>]: The identifier of the identity.
This property is read-only.
[Device <IMicrosoftGraphIdentity>]: identity
[User <IMicrosoftGraphIdentity>]: identity
[CreatedDateTime <DateTime?>]: The time of creation of the protection unit.
[Error <IMicrosoftGraphPublicError>]: publicError
[(Any) <Object>]: This indicates any property can be added to this object.
[Code <String>]: Represents the error code.
[Details <IMicrosoftGraphPublicErrorDetail[]>]: Details of the error.
[Code <String>]: The error code.
[Message <String>]: The error message.
[Target <String>]: The target of the error.
[InnerError <IMicrosoftGraphPublicInnerError>]: publicInnerError
[(Any) <Object>]: This indicates any property can be added to this object.
[Code <String>]: The error code.
[Details <IMicrosoftGraphPublicErrorDetail[]>]: A collection of error details.
[Message <String>]: The error message.
[Target <String>]: The target of the error.
[Message <String>]: A non-localized message for the developer.
[Target <String>]: The target of the error.
[LastModifiedBy <IMicrosoftGraphIdentitySet>]: identitySet
[LastModifiedDateTime <DateTime?>]: Timestamp of the last modification of this protection unit.
[OffboardRequestedDateTime <DateTime?>]: The time when protection unit offboard was requested.
[PolicyId <String>]: The unique identifier of the protection policy based on which protection unit was created.
[ProtectionSources <String>]: protectionSource
[Status <String>]: protectionUnitStatus
[Id <String>]: The unique identifier for an entity.
Read-only.
[DirectoryObjectId <String>]: The ID of the directory object.
[MailboxType <String>]: mailboxType
MAILBOXPROTECTIONUNITSBULKADDITIONJOBS <IMicrosoftGraphMailboxProtectionUnitsBulkAdditionJob[]>: .
[CreatedBy <IMicrosoftGraphIdentitySet>]: identitySet
[(Any) <Object>]: This indicates any property can be added to this object.
[Application <IMicrosoftGraphIdentity>]: identity
[(Any) <Object>]: This indicates any property can be added to this object.
[DisplayName <String>]: The display name of the identity.
This property is read-only.
[Id <String>]: The identifier of the identity.
This property is read-only.
[Device <IMicrosoftGraphIdentity>]: identity
[User <IMicrosoftGraphIdentity>]: identity
[CreatedDateTime <DateTime?>]: The time of creation of the job.
[DisplayName <String>]: The name of the protection units bulk addition job.
[Error <IMicrosoftGraphPublicError>]: publicError
[(Any) <Object>]: This indicates any property can be added to this object.
[Code <String>]: Represents the error code.
[Details <IMicrosoftGraphPublicErrorDetail[]>]: Details of the error.
[Code <String>]: The error code.
[Message <String>]: The error message.
[Target <String>]: The target of the error.
[InnerError <IMicrosoftGraphPublicInnerError>]: publicInnerError
[(Any) <Object>]: This indicates any property can be added to this object.
[Code <String>]: The error code.
[Details <IMicrosoftGraphPublicErrorDetail[]>]: A collection of error details.
[Message <String>]: The error message.
[Target <String>]: The target of the error.
[Message <String>]: A non-localized message for the developer.
[Target <String>]: The target of the error.
[LastModifiedBy <IMicrosoftGraphIdentitySet>]: identitySet
[LastModifiedDateTime <DateTime?>]: Timestamp of the last modification made to the job.
[Status <String>]: protectionUnitsBulkJobStatus
[Id <String>]: The unique identifier for an entity.
Read-only.
[DirectoryObjectIds <String[]>]: The list of Exchange directoryObjectIds to add to the Exchange protection policy.
[Mailboxes <String[]>]: The list of Exchange email addresses to add to the Exchange protection policy.
PROTECTIONPOLICYARTIFACTCOUNT <IMicrosoftGraphProtectionPolicyArtifactCount>: protectionPolicyArtifactCount
[(Any) <Object>]: This indicates any property can be added to this object.
[Completed <Int32?>]: The number of artifacts whose protection is completed.
[Failed <Int32?>]: The number of artifacts whose protection failed.
[InProgress <Int32?>]: The number of artifacts whose protection is in progress.
[Total <Int32?>]: The number of artifacts present in the protection policy.
RETENTIONSETTINGS <IMicrosoftGraphRetentionSetting[]>: Contains the retention setting details for the policy.
[Interval <String>]: The frequency of the backup.
[Period <TimeSpan?>]: The period of time to retain the protected data for a single Microsoft 365 service.