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
-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
-ProtectionPolicyArtifactCount
protectionPolicyArtifactCount
To construct, see NOTES section for PROTECTIONPOLICYARTIFACTCOUNT properties and create a hash table.
The protection units (sites) that are protected under the site protection policy.
To construct, see NOTES section for SITEPROTECTIONUNITS 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 <IMicrosoftGraphSharePointProtectionPolicy>: sharePointProtectionPolicy
[(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.
[SiteInclusionRules <IMicrosoftGraphSiteProtectionRule[]>]: The rules associated with the SharePoint 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.
[SiteExpression <String>]: Contains a site expression.
For examples, see siteExpression example.
[SiteProtectionUnits <IMicrosoftGraphSiteProtectionUnit[]>]: The protection units (sites) that are protected under the site 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.
[SiteId <String>]: Unique identifier of the SharePoint site.
[SiteProtectionUnitsBulkAdditionJobs <IMicrosoftGraphSiteProtectionUnitsBulkAdditionJob[]>]:
[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.
[SiteIds <String[]>]: The list of SharePoint site IDs to add to the SharePoint protection policy.
[SiteWebUrls <String[]>]: The list of SharePoint site URLs to add to the SharePoint 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
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.
SITEINCLUSIONRULES <IMicrosoftGraphSiteProtectionRule[]>: The rules associated with the SharePoint 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.
[SiteExpression <String>]: Contains a site expression.
For examples, see siteExpression example.
SITEPROTECTIONUNITS <IMicrosoftGraphSiteProtectionUnit[]>: The protection units (sites) that are protected under the site 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.
[SiteId <String>]: Unique identifier of the SharePoint site.
SITEPROTECTIONUNITSBULKADDITIONJOBS <IMicrosoftGraphSiteProtectionUnitsBulkAdditionJob[]>: .
[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.
[SiteIds <String[]>]: The list of SharePoint site IDs to add to the SharePoint protection policy.
[SiteWebUrls <String[]>]: The list of SharePoint site URLs to add to the SharePoint protection policy.