Get-AppRetentionCompliancePolicy

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

Use a Get-AppRetentionCompliancePolicy para exibir as políticas de conformidade de retenção de aplicativos. As políticas de retenção & rotulagem de aplicativos visam novas maneiras de definir o escopo e gerenciar políticas.

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

Sintaxe

Default (Default)

Get-AppRetentionCompliancePolicy
    [[-Identity] <PolicyIdParameter>]
    [-DistributionDetail]
    [-ErrorPolicyOnly]
    [-RetentionRuleTypes]
    [<CommonParameters>]

Description

Os cmdlets *-AppRetentionCompliance* são usados para políticas com escopos de política adaptável e todas as políticas estáticas que abrangem Chats do Teams, canais do Teams e canais privados, chats do Viva Engage e mensagens da comunidade do Viva Engage. Eventualmente, você usará esses cmdlets para a maioria dos locais de retenção e tipos de política. Os cmdlets *-RetentionCompliance* continuarão a dar suporte principalmente aos locais do Exchange e do SharePoint. Para políticas criadas com os cmdlets *-AppRetentionCompliance*, você só pode definir a lista de escopos incluídos ou excluídos para todas as cargas de trabalho incluídas, o que significa que você provavelmente precisará criar uma política por carga de trabalho.

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-AppRetentionCompliancePolicy | Format-Table Name,GUID

Este exemplo retorna uma lista resumida de todas as políticas de conformidade de retenção de aplicativo.

Exemplo 1

Get-AppRetentionCompliancePolicy -Identity "Contoso Viva Engage"

Este exemplo retorna informações detalhadas para a política de conformidade de retenção de aplicativos chamada Contoso Viva Engage.

Parâmetros

-DistributionDetail

Aplicável: Segurança & Conformidade

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.

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: Segurança & Conformidade

{{ Preencher ErrorPolicyOnly Description }}

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: Segurança & Conformidade

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

  • Nome
  • DN (nome diferenciado)
  • GUID

Cuidado: O valor $null ou um valor inexistente para o parâmetro Identity retorna todos os objetos como se você tivesse executado o comando Get- sem o parâmetro Identity. Verifique se todas as listas de valores para o parâmetro Identity são precisas 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:0
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-RetentionRuleTypes

Aplicável: Segurança & Conformidade

A opção RetentionRuleTypes especifica se o valor da propriedade RetentionRuleTypes deve ser retornado 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-AppRetentionCompliancePolicy -RetentionRuleTypes | Format-Table -Auto Name,RetentionRuleTypes. Se você não usar a opção RetentionRuleTypes, o valor aparecerá em branco.

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 dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.