Get-UnifiedAuditLogRetentionPolicy

  • 參考
模組:
ExchangePowerShell
適用於:
Security & Compliance

此 Cmdlet 僅適用于安全 & 性合規性 PowerShell。 如需詳細資訊，請參閱 安全 & 性合規性 PowerShell。

使用 Get-UnifiedAuditLogRetentionPolicy Cmdlet 在 Microsoft 365 Defender 入口網站或Microsoft Purview 合規性入口網站中檢視稽核記錄保留原則的屬性。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

Get-UnifiedAuditLogRetentionPolicy
   [-Operation <String>]
   [-RecordType <AuditRecordType>]
   [-RetentionDuration <UnifiedAuditLogRetentionDuration>]
   [-UserId <String>]
   [<CommonParameters>]

Description

稽核記錄保留原則可用來為系統管理員和使用者活動所產生的稽核記錄指定保留期間。 稽核記錄保留原則可以根據稽核的活動類型、活動執行的Microsoft 365 服務，或執行活動的使用者來指定保留期間。 如需詳細資訊，請參閱管理稽核記錄保留原則。

若要在安全 & 性合規性 PowerShell 中使用此 Cmdlet，您必須獲指派許可權。 如需詳細資訊，請參閱Microsoft 365 Defender入口網站中的許可權或Microsoft Purview 合規性入口網站中的許可權。

範例

範例 1

Get-UnifiedAuditLogRetentionPolicy | Sort-Object -Property Priority | Format-List Priority,Name,Description,RecordTypes,Operations,UserIds,RetentionDuration

此範例會列出組織中所有稽核記錄保留原則的可設定屬性。 此命令也會以最高到最低優先順序的順序列出原則。

範例 2

Get-UnifiedAuditLogRetentionPolicy -RecordType ExchangeItem | Format-List Name,Description,RecordTypes,Operations,UserIds,RetentionDuration,Priority

本範例列出適用于稽核記錄類型 ExchangeItem 之所有稽核記錄保留原則的可設定屬性。

參數

-Operation

Operations 參數會依原則中指定的作業來篩選結果。 如需此參數可用值的清單，請參閱 稽核的活動。

您可以輸入多個以逗號分隔的值。 如果值包含空格或需要引號，請使用下列語法： "Value1","Value2",..."ValueN" 。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RecordType

RecordType 參數會依原則中定義的記錄類型來篩選結果。 如需可用值的詳細資訊，請參閱 AuditLogRecordType。

Type:AuditRecordType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RetentionDuration

RetentionDuration 參數會依原則中指定的保留期間來篩選原則結果。 有效值為：

  • ThreeMonths
  • SixMonths
  • NineMonths
  • TwelveMonths
  • TenYears
Type:UnifiedAuditLogRetentionDuration
Accepted values:ThreeMonths, SixMonths, NineMonths, TwelveMonths, TenYears
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-UserId

UserIds 參數會依原則中指定之使用者的識別碼來篩選原則結果。

您可以輸入多個以逗號分隔的值。 如果值包含空格或需要引號，請使用下列語法： "Value1","Value2",..."ValueN" 。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance