Condividi tramite


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-RetentionCompliancePolicy

In 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-List

In 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