Partilhar via


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

Utilize o Get-AppRetentionCompliancePolicy para ver as políticas de conformidade de retenção de aplicações. A retenção de aplicações & políticas de etiquetagem visam novas formas de definir o âmbito e gerir 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 utilizados para políticas com âmbitos de política adaptáveis e todas as políticas estáticas que abrangem Chats do Teams, canais do Teams e canais privados, conversas Viva Engage e Viva Engage mensagens da comunidade. Eventualmente, irá utilizar estes cmdlets para a maioria das localizações de retenção e tipos de política. Os cmdlets *-RetentionCompliance* continuarão a suportar principalmente as localizações do Exchange e do SharePoint. Para políticas criadas com os cmdlets *-AppRetentionCompliance*, só pode definir a lista de âmbitos incluídos ou excluídos para todas as cargas de trabalho incluídas, o que significa que provavelmente terá de 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 devolve uma lista de resumo de todas as políticas de conformidade de retenção de aplicações.

Exemplo 1

Get-AppRetentionCompliancePolicy -Identity "Contoso Viva Engage"

Este exemplo devolve informações detalhadas para a política de conformidade de retenção de aplicações denominada Contoso Viva Engage.

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.

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

{{ Fill 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: Conformidade do & de Segurança

O parâmetro Identidade especifica a política de conformidade de retenção de aplicações que pretende ver. É 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:0
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-RetentionRuleTypes

Aplicável: Conformidade do & de Segurança

O comutador RetentionRuleTypes especifica se pretende devolver o valor da propriedade RetentionRuleTypes 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-AppRetentionCompliancePolicy -RetentionRuleTypes | Format-Table -Auto Name,RetentionRuleTypes. Se não utilizar o comutador RetentionRuleTypes, o valor aparece 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 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.