Set-UnifiedAuditLogRetentionPolicy

This cmdlet is available only in Security & Compliance Center PowerShell. For more information, see Security & Compliance Center PowerShell (https://docs.microsoft.com/powershell/exchange/scc-powershell).

Use the Set-UnifiedAuditLogRetentionPolicy cmdlet to modify audit log retention policies in the Security & Compliance Center.

For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax (https://docs.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).

Syntax

Set-UnifiedAuditLogRetentionPolicy
   [-Identity] <PolicyIdParameter>
   -Priority <Int32>
   -RetentionDuration <UnifiedAuditLogRetentionDuration>
   [-Confirm]
   [-Description <String>]
   [-Operations <MultiValuedProperty>]
   [-RecordTypes <MultiValuedProperty>]
   [-UserIds <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Description

Audit log retention policies are used to specify a retention duration for audit logs for that are generated by admin and user activity. An audit log retention policy can specify the retention duration based on the type of audited activities, the Microsoft 365 service that activities are performed in, or the users who performed the activities. For more information, see Manage audit log retention policies.

You need to be assigned permissions in the Security & Compliance Center before you can use this cmdlet. For more information, see Permissions in the Security & Compliance Center.

Examples

Example 1

Set-UnifiedAuditLogRetentionPolicy -Identity "eDiscovery audit retention" -RecordTypes Discovery,AeD -UserIds admin@contoso.onmicrosoft.com -RetentionDuration SixMonths -Priority 100

This example adds the AeD (for Advanced eDiscovery events) record type to the policy. It also configures that the policy is applied only to the audit logs for activities performed only by the user admin@contoso.onmicrosoft.com.

Example 2

Set-UnifiedAuditLogRetentionPolicy -Name "SearchQueryPerformed by app@sharepoint" -Operations SearchQueryPerformed,FileAccessed -UserIds $null -RetentionDuration SixMonths -Priority 10000

This example modifies an audit log retention policy and changes to retention duration to six months, adds an additional activity to the Operations parameter, and removes all values from the UserId property so that the policy will apply to all users.

Parameters

-Confirm

The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on if the cmdlet requires confirmation before proceeding.

  • Destructive cmdlets (for example, Remove-* cmdlets) have a built-in pause that forces you to acknowledge the command before proceeding. For these cmdlets, you can skip the confirmation prompt by using this exact syntax: -Confirm:$false.

  • Most other cmdlets (for example, New-* and Set-* cmdlets) don't have a built-in pause. For these cmdlets, specifying the Confirm switch without a value introduces a pause that forces you acknowledge the command before proceeding.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Office 365 Security & Compliance Center
-Description

The Description parameter specifies a description for the audit log retention policy. The maximum length is 256 characters. If the value contains spaces, enclose the value in quotation marks (").

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Office 365 Security & Compliance Center
-Identity

The Identity parameter specifies the unified audit log retention policy that you want to modify. You can use any value that uniquely identifies the policy. For example:

  • Name

  • Distingished name (DN)

  • GUID

Type:PolicyIdParameter
Position:0
Default value:None
Accept pipeline input:True (ByPropertyName, ByValue)
Accept wildcard characters:False
Applies to:Office 365 Security & Compliance Center
-Operations

The Operations parameter specifies the audit log operations that are retained by the policy. The values you specify will overwrite any existing entries. For a list of the available values for this parameter, see Audited activities.

To enter multiple values, use the following syntax: <value1>,<value2>,...<valueX>. If the values contain spaces or otherwise require quotation marks, use the following syntax: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Office 365 Security & Compliance Center
-Priority

The Priority parameter specifies a priority value for the policy that determines the order of policy processing. A higher integer value indicates a higher priority, the value 10000 is the highest priority, and policies can't have the same priority value.

Valid values and the default value for this parameter depend on the number of existing policies. For example, if there are 8 existing policies:

  • Valid priority values for the existing 8 policies are from 7 through 0.

  • Valid priority values for a new policy (the 9th policy) are from 8 through 0.

You must use a unique priority value when modifying audit log retention policies. This parameter is required when modifying an audit log retention policy.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Office 365 Security & Compliance Center
-RecordTypes

The RecordTypes parameter specifies the audit logs of a specific record type that are retained by the policy. The values you specify will overwrite any existing entries. Valid values are:

  • AeD

  • AirInvestigation

  • ApplicationAudit

  • AzureActiveDirectory

  • AzureActiveDirectoryAccountLogon

  • AzureActiveDirectoryStsLogon

  • CRM

  • Campaign

  • ComplianceDLPExchange

  • ComplianceDLPSharePoint

  • ComplianceDLPSharePointClassification

  • ComplianceSupervisionExchange

  • CustomerKeyServiceEncryption

  • DLPEndpoint

  • DataCenterSecurityCmdlet

  • DataGovernance

  • DataInsightsRestApiAudit

  • Discovery

  • ExchangeAdmin

  • ExchangeAggregatedOperation

  • ExchangeItem

  • ExchangeItemAggregated

  • ExchangeItemGroup

  • HRSignal

  • HygieneEvent

  • InformationBarrierPolicyApplication

  • InformationWorkerProtection

  • Kaizala

  • LabelContentExplorer

  • MIPLabel

  • MailSubmission

  • MicrosoftFlow

  • MicrosoftForms

  • MicrosoftStream

  • MicrosoftTeams

  • MicrosoftTeamsAdmin

  • MicrosoftTeamsAnalytics

  • MicrosoftTeamsDevice

  • MicrosoftTeamsShifts

  • MipAutoLabelExchangeItem

  • MipAutoLabelSharePointItem

  • MipAutoLabelSharePointPolicyLocation

  • OfficeNative

  • OneDrive

  • PowerAppsApp

  • PowerAppsPlan

  • PowerBIAudit

  • Project

  • Quarantine

  • SecurityComplianceAlerts

  • SecurityComplianceCenterEOPCmdlet

  • SecurityComplianceInsights

  • SharePoint

  • SharePointCommentOperation

  • SharePointContentTypeOperation

  • SharePointFieldOperation

  • SharePointFileOperation

  • SharePointListItemOperation

  • SharePointListOperation

  • SharePointSharingOperation

  • SkypeForBusinessCmdlets

  • SkypeForBusinessPSTNUsage

  • SkypeForBusinessUsersBlocked

  • Sway

  • SyntheticProbe

  • TeamsHealthcare

  • ThreatFinder

  • ThreatIntelligence

  • ThreatIntelligenceAtpContent

  • ThreatIntelligenceUrl

  • WorkplaceAnalytics

  • Yammer

You can specify multiple values separated by commas.

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RetentionDuration

The RetentionDuration parameter specifies how long audit log records are kept. Valid values are:

  • ThreeMonths

  • SixMonths

  • NineMonths

  • TwelveMonths

This parameter is required when modifying an audit log retention policy.

Type:UnifiedAuditLogRetentionDuration
Accepted values:ThreeMonths, SixMonths, NineMonths, TwelveMonths
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Office 365 Security & Compliance Center
-UserIds

The UserIds parameter specifies the audit logs that are retained by the policy based on the ID of the user who performed the action. The values you specify will overwrite any existing entries.

To enter multiple values, use the following syntax: <value1>,<value2>,...<valueX>. If the values contain spaces or otherwise require quotation marks, use the following syntax: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Office 365 Security & Compliance Center
-WhatIf

The WhatIf switch doesn't work in Security & Compliance Center PowerShell.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Office 365 Security & Compliance Center

Inputs

Outputs