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 Konformitätsrichtlinien für die App-Aufbewahrung anzuzeigen. App-Aufbewahrungs- & Bezeichnungsrichtlinien zielen auf neue Möglichkeiten zum Festlegen und Verwalten von Richtlinien ab.
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 allen 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 Aufbewahrungsspeicherorte und Richtlinientypen. Die Cmdlets *-RetentionCompliance* unterstützen weiterhin hauptsächlich Exchange- und SharePoint-Speicherorte. Für Richtlinien, die mit den Cmdlets *-AppRetentionCompliance* erstellt wurden, können Sie nur die Liste der eingeschlossenen oder ausgeschlossenen Bereiche für alle eingeschlossenen Workloads festlegen. Dies 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
In diesem Beispiel wird eine Zusammenfassende Liste aller Konformitätsrichtlinien für die App-Aufbewahrung zurückgegeben.
Beispiel 1
Get-AppRetentionCompliancePolicy -Identity "Contoso Viva Engage"
In diesem Beispiel werden ausführliche Informationen für die Konformitätsrichtlinie für die App-Aufbewahrung mit dem Namen Contoso Viva Engage zurückgegeben.
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.
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
{{ 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: Security & Compliance
Der Parameter Identity gibt die Konformitätsrichtlinie für die 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
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: | 0 |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-RetentionRuleTypes
Anwendbar: Security & Compliance
Die Option RetentionRuleTypes gibt an, ob der Wert der RetentionRuleTypes-Eigenschaft 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.