Get-RetentionCompliancePolicy
Dieses Cmdlet ist nur im Security & Compliance Center-PowerShell verfügbar. Weitere Informationen finden Sie unter Security & Compliance Center-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
Default (Standard)
Get-RetentionCompliancePolicy
[[-Identity] <PolicyIdParameter>]
[-DistributionDetail]
[-ErrorPolicyOnly]
[-ExcludeTeamsPolicy]
[-IncludeTestModeResults]
[-PriorityCleanup]
[-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. Die tatsächliche Workload, auf die die Richtlinie angewendet wird, wird nicht angezeigt.
- 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 Security & Compliance PowerShell zu verwenden, 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
Anwendbar: Security & Compliance
Der Schalter DistributionDetail gibt detaillierte Informationen zur Richtlinienverteilung in der Eigenschaft DistributionResults zurück. Sie müssen keinen Wert für diese Option angeben.
Wenn Sie diesen Switch nicht verwenden, sind die Werte der Eigenschaften DistributionStatus und *Location ungenau.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ErrorPolicyOnly
Anwendbar: Security & Compliance
Der Schalter ErrorPolicyOnly gibt an, ob nur Richtlinien angezeigt werden sollen, die Verteilungsfehler in den Ergebnissen aufweisen. Sie müssen keinen Wert für diese Option angeben.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ExcludeTeamsPolicy
Anwendbar: Security & Compliance
Die Option ExcludeTeamsPolicy gibt an, ob Teams-Richtlinien aus den Ergebnissen ausgeschlossen werden sollen. Sie müssen keinen Wert für diese Option angeben.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Identity
Anwendbar: Security & Compliance
Der Identity-Parameter gibt die Aufbewahrungsrichtlinie an, die Sie anzeigen möchten. Sie können einen beliebigen Wert verwenden, der die Richtlinie eindeutig identifiziert. Beispiel:
- Name
- Distinguished Name (DN)
- GUID
Achtung: Der Wert $null oder ein nicht vorhandener Wert für den Identity-Parameter gibt alle Objekte zurück, als ob Sie den Get-Befehl ohne den Identity-Parameter ausgeführt haben. Vergewissern Sie sich, dass listen von Werten für den Identity-Parameter korrekt sind und keine nicht vorhandenen $null-Werte enthalten.
Parametereigenschaften
| Typ: | PolicyIdParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-IncludeTestModeResults
Anwendbar: Security & Compliance
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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-PriorityCleanup
Anwendbar: Security & Compliance
{{ Fill PriorityCleanup Description }}
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-RetentionRuleTypes
Anwendbar: Security & Compliance
Die Option RetentionRuleTypes gibt an, ob der Wert der Eigenschaften RetentionRuleTypes und HasRules in den Ergebnissen zurückgegeben werden soll. Sie müssen keinen Wert für diese Option 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 Schalter RetentionRuleTypes nicht verwenden, werden die Werte RetentionRuleTypes leer und HasRules als False angezeigt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-TeamsPolicyOnly
Anwendbar: Security & Compliance
Die Option TeamsPolicyOnly gibt an, ob nur Teams-Richtlinien in den Ergebnissen angezeigt werden sollen. Sie müssen keinen Wert für diese Option angeben.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.