Get-RetentionCompliancePolicy

  • Referenz
Modul:
ExchangePowerShell
Gilt für::
Security & Compliance

Dieses Cmdlet ist nur in PowerShell zur Sicherheitskonformität & verfügbar. Weitere Informationen finden Sie unter Security & Compliance PowerShell.

Verwenden Sie die Get-RetentionCompliancePolicy, um vorhandene Aufbewahrungsrichtlinien im Microsoft Purview-Complianceportal anzuzeigen.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

Get-RetentionCompliancePolicy
   [[-Identity] <PolicyIdParameter>]
   [-DistributionDetail]
   [-ErrorPolicyOnly]
   [-ExcludeTeamsPolicy]
   [-IncludeTestModeResults]
   [-RetentionRuleTypes]
   [-TeamsPolicyOnly]
   [<CommonParameters>]

Beschreibung

In dieser Liste werden die Eigenschaften erläutert, die standardmäßig angezeigt werden.

  • Name: Der eindeutige Name der Richtlinie.
  • Workload: Derzeit werden alle Workloads (Exchange, SharePoint, OneDriveForBusiness, Skype, ModernGroup) angezeigt, und es wird nicht die tatsächliche Workload angezeigt, auf die die Richtlinie angewendet wird.
  • Enabled: Der Wert True bedeutet, dass die Richtlinie aktiviert ist.
  • Mode: Der aktuelle Betriebsmodus der Richtlinie. Die möglichen Werte sind Test (der Inhalt wird getestet, aber es werden keine Regeln erzwungen), AuditAndNotify (wenn inhalte den in der Richtlinie angegebenen Bedingungen entsprechen, wird die Regel nicht erzwungen, aber Benachrichtigungs-E-Mails werden gesendet) oder Enforce (alle Aspekte der Richtlinie werden aktiviert und erzwungen).

Um dieses Cmdlet in PowerShell für Sicherheitskonformität & verwenden zu können, müssen Ihnen Berechtigungen zugewiesen werden. Weitere Informationen finden Sie unter Berechtigungen im Microsoft Purview-Complianceportal.

Beispiele

Beispiel 1

Get-RetentionCompliancePolicy

In diesem Beispiel werden zusammenfassende Informationen für alle Aufbewahrungsrichtlinien in Ihrer Organisation angezeigt.

Beispiel 2

Get-RetentionCompliancePolicy -Identity "Regulation 123 Compliance" -DistributionDetail | Format-List

In diesem Beispiel werden detaillierte Informationen für die Richtlinie mit dem Namen „Regulation 123 Compliance“ angezeigt, darunter genaue Werte für die Eigenschaften DistributionStatus und *Location.

Parameter

-DistributionDetail

Der Schalter DistributionDetail gibt detaillierte Informationen zur Richtlinienverteilung in der Eigenschaft DistributionResults zurück. Sie müssen bei dieser Option keinen Wert angeben.

Wenn Sie diesen Switch nicht verwenden, sind die Werte der Eigenschaften DistributionStatus und *Location ungenau.

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

-ErrorPolicyOnly

Der Schalter ErrorPolicyOnly gibt an, ob nur Richtlinien angezeigt werden sollen, die Verteilungsfehler in den Ergebnissen aufweisen. Sie müssen bei dieser Option keinen Wert angeben.

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

-ExcludeTeamsPolicy

Die Option ExcludeTeamsPolicy gibt an, ob Teams-Richtlinien aus den Ergebnissen ausgeschlossen werden sollen. Sie müssen keinen Wert für diese Option angeben.

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

-Identity

Der Identity-Parameter gibt die Aufbewahrungsrichtlinie an, die Sie anzeigen möchten. Sie können einen beliebigen Wert verwenden, der die Richtlinie eindeutig identifiziert. Zum Beispiel:

  • Name
  • Distinguished Name (DN)
  • GUID
Type:PolicyIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Security & Compliance

-IncludeTestModeResults

Der IncludeTestModeResults-Schalter gibt an, ob die status des Testmodus in die Richtliniendetails eingeschlossen werden soll. Sie müssen keinen Wert für diese Option angeben.

Weitere Informationen zum Simulationsmodus finden Sie unter Informationen zum Simulationsmodus.

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

-RetentionRuleTypes

Die Option RetentionRuleTypes gibt an, ob der Wert der RetentionRuleTypes-Eigenschaft in den Ergebnissen zurückgegeben werden soll. Sie müssen bei dieser Option keinen Wert angeben.

Um die RetentionRuleTypes-Eigenschaft anzuzeigen, müssen Sie den Befehl an ein Formatierungs-Cmdlet weiterleiten. Beispiel: Get-RetentionCompliancePolicy -RetentionRuleTypes | Format-Table -Auto Name,RetentionRuleTypes. Wenn Sie den RetentionRuleTypes-Switch nicht verwenden, wird kein Wert angezeigt.

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

-TeamsPolicyOnly

Die Option TeamsPolicyOnly gibt an, ob nur Teams-Richtlinien in den Ergebnissen angezeigt werden sollen. Sie müssen bei dieser Option keinen Wert angeben.

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