Get-AppRetentionCompliancePolicy
Dieses Cmdlet ist nur im Security & Compliance Center-PowerShell verfügbar. Weitere Informationen finden Sie unter Security & Compliance Center-PowerShell.
Verwenden Sie die Get-AppRetentionCompliancePolicy, um Compliancerichtlinien zur App-Aufbewahrung anzuzeigen. Richtlinien zur App-Aufbewahrung & -Bezeichnung zielen auf neue Möglichkeiten ab, Richtlinien festzulegen und zu verwalten.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Default (Standard)
Get-AppRetentionCompliancePolicy
[[-Identity] <PolicyIdParameter>]
[-DistributionDetail]
[-ErrorPolicyOnly]
[-RetentionRuleTypes]
[<CommonParameters>]
Beschreibung
*-AppRetentionCompliance*-Cmdlets werden für Richtlinien mit adaptiven Richtlinienbereichen und alle statischen Richtlinien verwendet, die Teams-Chats, Teams-Kanäle und private Kanäle, Viva Engage-Chats und Viva Engage-Communitynachrichten abdecken. Schließlich verwenden Sie diese Cmdlets für die meisten Aufbewahrungsorte und Richtlinientypen. Die *-RetentionCompliance*-Cmdlets unterstützen weiterhin primär Exchange- und SharePoint-Speicherorte. Für Richtlinien, die mit den *-AppRetentionCompliance*-Cmdlets erstellt wurden, können Sie nur die Liste der eingeschlossenen oder ausgeschlossenen Bereiche für alle enthaltenen Workloads festlegen, was bedeutet, dass Sie wahrscheinlich eine Richtlinie pro Workload erstellen müssen.
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-AppRetentionCompliancePolicy | Format-Table Name,GUID
Dieses Beispiel gibt eine Zusammenfassung aller Compliancerichtlinien für die App-Aufbewahrung zurück.
Beispiel 1
Get-AppRetentionCompliancePolicy -Identity "Contoso Viva Engage"
Dieses Beispiel gibt detaillierte Informationen für die App-Aufbewahrungs-Compliancerichtlinie namens Contoso Viva Engage zurück.
Parameter
-DistributionDetail
Anwendbar: Sicherheit & 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.
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: Sicherheit & Compliance
{{ Fill ErrorPolicyOnly 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 |
-Identity
Anwendbar: Sicherheit & Compliance
Der Parameter "Identity" gibt die Richtlinie zur App-Aufbewahrung an, die Sie anzeigen möchten. Sie können einen beliebigen Wert verwenden, der die Richtlinie eindeutig identifiziert. Beispiel:
- Name
- Distinguished Name (DN)
- GUID
Vorsicht: Der Wert $null oder ein nicht vorhandener Wert für den Identity-Parameter gibt alle Objekte so zurück, als ob Sie den Get-Befehl ohne den Identity-Parameter ausgeführt hätten. Überprüfen Sie, ob alle Wertelisten für den Parameter "Identity" 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: | 0 |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-RetentionRuleTypes
Anwendbar: Sicherheit & Compliance
Der Schalter RetentionRuleTypes gibt an, ob der Wert der Eigenschaft RetentionRuleTypes 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-AppRetentionCompliancePolicy -RetentionRuleTypes | Format-Table -Auto Name,RetentionRuleTypes. Wenn Sie den RetentionRuleTypes-Switch nicht verwenden, wird kein Wert 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 |
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.