Get-RetentionCompliancePolicy
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-RetentionCompliancePolicyIn diesem Beispiel werden zusammenfassende Informationen für alle Aufbewahrungsrichtlinien in Ihrer Organisation angezeigt.
Beispiel 2
Get-RetentionCompliancePolicy -Identity "Regulation 123 Compliance" -DistributionDetail | Format-ListIn 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 |