Get-RetentionCompliancePolicy
Este cmdlet está disponível apenas no PowerShell de Segurança e Conformidade. Para obter mais informações, consulte PowerShell de Segurança e Conformidade..
Utilize o Get-RetentionCompliancePolicy para ver as 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.
Sintaxe
Default (Default)
Get-RetentionCompliancePolicy
[[-Identity] <PolicyIdParameter>]
[-DistributionDetail]
[-ErrorPolicyOnly]
[-ExcludeTeamsPolicy]
[-IncludeTestModeResults]
[-PriorityCleanup]
[-RetentionRuleTypes]
[-TeamsPolicyOnly]
[<CommonParameters>]
Description
Esta lista descreve as propriedades que são apresentadas por predefinição.
- Nome: o nome exclusivo da política.
- Carga de trabalho: atualmente, mostra todas as cargas de trabalho (Exchange, SharePoint, OneDriveForBusiness, Skype, ModernGroup). Não mostra a carga de trabalho real na qual a política é aplicada.
- Ativado: o valor Verdadeiro significa que a política está ativada.
- Modo: o modo de funcionamento atual da política. Os valores possíveis são Test (o conteúdo é testado, mas não são impostas regras), AuditAndNotify (quando o conteúdo corresponde às condições especificadas pela política, a regra não é imposta, mas os e-mails de notificação são enviados) ou Impor (todos os aspetos da política são ativados e impostos).
Para usar este cmdlet no PowerShell de Segurança e Conformidade, 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 apresenta informações detalhadas sobre a política denominada "Conformidade do Regulamento 123", incluindo valores precisos para as propriedades DistributionStatus e *Location.
Parâmetros
-DistributionDetail
Aplicável: Conformidade do & de Segurança
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 não utilizar este comutador, os valores dos valores da propriedade DistributionStatus e *Location serão imprecisos.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ErrorPolicyOnly
Aplicável: Conformidade do & de Segurança
O comutador ErrorPolicyOnly especifica se pretende mostrar apenas as políticas que têm erros de distribuição nos resultados. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ExcludeTeamsPolicy
Aplicável: Conformidade do & de Segurança
O comutador ExcludeTeamsPolicy especifica se pretende excluir as políticas do Teams dos resultados. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Conformidade do & de Segurança
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
Atenção: o valor $null ou um valor inexistente para o parâmetro Identidade devolve todos os objetos como se tivesse executado o comando Get- sem o parâmetro Identity. Verifique se as listas de valores do parâmetro Identity estão corretas e não contêm valores de $null inexistentes.
Propriedades do parâmetro
| Tipo: | PolicyIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-IncludeTestModeResults
Aplicável: Conformidade do & de Segurança
O comutador IncludeTestModeResults especifica se deve incluir a 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PriorityCleanup
Aplicável: Conformidade do & de Segurança
{{ Prioridade de PreenchimentoDesução do Preenchimento }}
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RetentionRuleTypes
Aplicável: Conformidade do & de Segurança
O comutador RetentionRuleTypes especifica se pretende devolver o valor das propriedades RetentionRuleTypes e HasRules nos resultados. Não é preciso especificar um valor com essa opção.
Para ver a propriedade RetentionRuleTypes, tem de encaminhar o comando para um cmdlet de formatação. Por exemplo, Get-RetentionCompliancePolicy -RetentionRuleTypes | Format-Table -Auto Name,RetentionRuleTypes. Se não utilizar o comutador RetentionRuleTypes, os valores RetentionRuleTypes aparecem em branco e HasRules aparece como Falso.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-TeamsPolicyOnly
Aplicável: Conformidade do & de Segurança
O comutador TeamsPolicyOnly especifica se pretende mostrar apenas as políticas do Teams nos resultados. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.