Get-RetentionCompliancePolicy
Questo cmdlet è disponibile solo in PowerShell conformità alla sicurezza & . Per altre informazioni, vedere PowerShell conformità alla sicurezza&.
Usare il Get-RetentionCompliancePolicy per visualizzare i criteri di conservazione esistenti nel Portale di conformità di Microsoft Purview.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Get-RetentionCompliancePolicy
[[-Identity] <PolicyIdParameter>]
[-DistributionDetail]
[-ErrorPolicyOnly]
[-ExcludeTeamsPolicy]
[-IncludeTestModeResults]
[-RetentionRuleTypes]
[-TeamsPolicyOnly]
[<CommonParameters>] Descrizione
In questo elenco vengono descritte le proprietà visualizzate per impostazione predefinita.
- Name: il nome univoco del criterio.
- Carico di lavoro: al momento mostrerà tutti i carichi di lavoro (Exchange, SharePoint, OneDriveForBusiness, Skype, ModernGroup) e non mostrerà il carico di lavoro effettivo su cui vengono applicati i criteri.
- Enabled: il valore True indica che il criterio è abilitato.
- Mode: la modalità operativa corrente del criterio. I valori possibili sono Test (il contenuto viene testato, ma non vengono applicate regole), AuditAndNotify (quando il contenuto corrisponde alle condizioni specificate dai criteri, la regola non viene applicata, ma vengono inviati messaggi di posta elettronica di notifica) o Imponi (tutti gli aspetti dei criteri sono abilitati e applicati).
Per usare questo cmdlet in Security & Compliance PowerShell, è necessario disporre delle autorizzazioni. Per ulteriori informazioni, vedere Autorizzazioni nel portale di conformità di Microsoft Purview.
Esempio
Esempio 1
Get-RetentionCompliancePolicyIn questo esempio vengono visualizzate informazioni di riepilogo per tutti i criteri di conservazione nell'organizzazione.
Esempio 2
Get-RetentionCompliancePolicy -Identity "Regulation 123 Compliance" -DistributionDetail | Format-ListIn questo esempio vengono visualizzate informazioni dettagliate per il criterio denominato "Regulation 123 Compliance", includendo valori precisi per le proprietà DistributionStatus e *Location.
Parametri
-DistributionDetail
L'opzione DistributionDetail restituisce informazioni dettagliate sulla distribuzione dei criteri nella proprietà DistributionResults. Con questa opzione non è necessario specificare alcun valore.
Se non si usa questa opzione, i valori di proprietà DistributionStatus e *Location non saranno precisi.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-ErrorPolicyOnly
L'opzione ErrorPolicyOnly specifica se visualizzare solo i criteri che presentano errori di distribuzione nei risultati. Con questa opzione non è necessario specificare alcun valore.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-ExcludeTeamsPolicy
L'opzione ExcludeTeamsPolicy specifica se escludere i criteri di Teams dai risultati. Con questa opzione non è necessario specificare alcun valore.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Identity
Il parametro Identity consente di specificare il criterio di conservazione da visualizzare. È possibile utilizzare qualsiasi valore che identifichi il criterio in modo univoco. Ad esempio:
- Nome
- Nome distinto (DN)
- GUID
| Type: | PolicyIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-IncludeTestModeResults
L'opzione IncludeTestModeResults specifica se includere lo stato della modalità di test nei dettagli dei criteri. Con questa opzione non è necessario specificare alcun valore.
Per altre informazioni sulla modalità di simulazione, vedere Informazioni sulla modalità di simulazione.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RetentionRuleTypes
L'opzione RetentionRuleTypes specifica se restituire il valore della proprietà RetentionRuleTypes nei risultati. Con questa opzione non è necessario specificare alcun valore.
Per visualizzare la proprietà RetentionRuleTypes, è necessario inviare il comando a un cmdlet di formattazione. Ad esempio, Get-RetentionCompliancePolicy -RetentionRuleTypes | Format-Table -Auto Name,RetentionRuleTypes. Se non si usa l'opzione RetentionRuleTypes, il valore verrà visualizzato vuoto.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-TeamsPolicyOnly
L'opzione TeamsPolicyOnly specifica se visualizzare solo i criteri di Teams nei risultati. Con questa opzione non è necessario specificare alcun valore.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |