Get-RetentionCompliancePolicy

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Security & Compliance

Esse cmdlet está disponível apenas no PowerShell de Conformidade de Segurança & . Para obter mais informações, consulte PowerShell de Conformidade de Segurança&.

Use o Get-RetentionCompliancePolicy para exibir políticas de retenção existentes no portal de conformidade do Microsoft Purview.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Get-RetentionCompliancePolicy
   [[-Identity] <PolicyIdParameter>]
   [-DistributionDetail]
   [-ErrorPolicyOnly]
   [-ExcludeTeamsPolicy]
   [-IncludeTestModeResults]
   [-RetentionRuleTypes]
   [-TeamsPolicyOnly]
   [<CommonParameters>]

Description

Esta lista descreve as propriedades exibidas por padrão.

  • Nome: o nome exclusivo da política.
  • Carga de trabalho: no momento, ele mostrará todas as cargas de trabalho (Exchange, SharePoint, OneDriveForBusiness, Skype, ModernGroup) e não mostrará a carga de trabalho real na qual a política é aplicada.
  • Habilitado: o valor True significa que a política está habilitada.
  • Modo: o modo operacional atual da política. Os valores possíveis são Teste (o conteúdo é testado, mas nenhuma regra é imposta), AuditAndNotify (quando o conteúdo corresponde às condições especificadas pela política, a regra não é imposta, mas emails de notificação são enviados) ou Impor (todos os aspectos da política são habilitados e imposto).

Para usar esse cmdlet no PowerShell de Conformidade de Segurança & , você precisa receber permissões. Para obter mais informações, confira Permissões no portal de conformidade do Microsoft Purview.

Exemplos

Exemplo 1

Get-RetentionCompliancePolicy

Este exemplo exibe informações de resumo de todas as políticas de retenção da sua organização.

Exemplo 2

Get-RetentionCompliancePolicy -Identity "Regulation 123 Compliance" -DistributionDetail | Format-List

Este exemplo exibe informações detalhadas para a política chamada "Conformidade do Regulamento 123", incluindo valores precisos para as propriedades DistributionStatus e *Location.

Parâmetros

-DistributionDetail

A opção DistributionDetail retorna informações detalhadas de distribuição de políticas na propriedade DistributionResults. Não é preciso especificar um valor com essa opção.

Se você não usar essa opção, os valores dos valores de propriedade DistributionStatus e *Location serão imprecisos.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ErrorPolicyOnly

A opção ErrorPolicyOnly especifica se deve mostrar apenas políticas com erros de distribuição nos resultados. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ExcludeTeamsPolicy

A opção ExcludeTeamsPolicy especifica se as políticas do Teams devem ser excluídas dos resultados. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Identity

O parâmetro Identity especifica a política de retenção que você deseja exibir. É possível usar qualquer valor que identifique a política com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID
Type:PolicyIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Security & Compliance

-IncludeTestModeResults

A opção IncludeTestModeResults especifica se deve incluir o status do modo de teste nos detalhes da política. Não é preciso especificar um valor com essa opção.

Para obter mais informações sobre o modo de simulação, consulte Saiba sobre o modo de simulação.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RetentionRuleTypes

A opção RetentionRuleTypes especifica se deve retornar o valor da propriedade RetentionRuleTypes nos resultados. Não é preciso especificar um valor com essa opção.

Para ver a propriedade RetentionRuleTypes, você precisa canalizar o comando para um cmdlet de formatação. Por exemplo, Get-RetentionCompliancePolicy -RetentionRuleTypes | Format-Table -Auto Name,RetentionRuleTypes. Se você não usar a opção RetentionRuleTypes, o valor aparecerá em branco.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-TeamsPolicyOnly

A opção TeamsPolicyOnly especifica se deve mostrar apenas as políticas do Teams nos resultados. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance