Cmdlets do Windows PowerShell para políticas de retenção e rótulos de retenção

Diretrizes de licenciamento do Microsoft 365 para segurança e conformidade.

Use as seções a seguir para identificar os cmdlets main PowerShell que estão disponíveis para políticas de retenção e rótulos de retenção que talvez seja necessário para configuração em escala, scripts automatizados ou cenários avançados de configuração. Para obter a lista completa de cmdlets, consulte a lista de retenção de política e conformidade da documentação do PowerShell.

Antes de usar esses cmdlets, primeiro você deve se conectar ao PowerShell de Conformidade do & de Segurança.

Nas descrições a seguir, uma política de retenção pode se referir a uma política de retenção (sem rótulos) ou a uma política de rótulo de retenção. Cada política define se ela é estática ou adaptável e os locais para a política ser aplicada.

Quando você usa políticas de retenção, a política exige uma regra para concluir a configuração, por exemplo, uma regra que define as configurações de retenção, como reter por cinco anos e, em seguida, excluir.

Quando você usa rótulos de retenção, eles contêm as configurações de retenção e suas políticas precisam de regras diferentes:

• Uma política de rótulo de retenção que você publica precisa de uma regra que define quais rótulos devem ser exibidos em aplicativos.
• Uma política de rótulo de retenção de aplicação automática precisa de uma regra que defina o rótulo a ser aplicado e as condições para aplicar o rótulo.

Dica

Se você não for um cliente E5, use a avaliação de soluções do Microsoft Purview de 90 dias para explorar como recursos adicionais do Purview podem ajudar sua organização a gerenciar as necessidades de segurança e conformidade de dados. Comece agora no hub de avaliações portal de conformidade do Microsoft Purview. Saiba mais sobre os termos de inscrição e avaliação.

Cmdlets de retenção para a maioria dos locais

Use os cmdlets na tabela a seguir quando os locais forem caixas de correio do Exchange, sites do SharePoint ou sites clássicos e de comunicação do SharePoint, contas do OneDrive, caixas de correio do Grupo Microsoft 365 & sites, Skype for Business, pastas públicas do Exchange, mensagens de chat do Teams ou mensagens de canal do Teams.

Não use esses cmdlets quando os locais forem para mensagens de canal privado do Teams, Viva Engage mensagens de usuário ou Viva Engage mensagens da comunidade. Esses locais têm cmdlets alternativos que são identificados na [próxima seção](#retention-cmdlets-specific-to-teams-private-channels-and-Viva Engage).

Cmdlet	Descrição	Locais aplicáveis
Enable-ComplianceTagStorage Get-ComplianceTagStorage	Uma operação única para criar armazenamento ou exibir esse armazenamento para rótulos de retenção	Caixas de correio do Exchange Sites do SharePoint (ou sites clássicos e de comunicação do SharePoint) Contas OneDrive Caixas de correio do Grupo Microsoft 365 & sites
Get-ComplianceTag New-ComplianceTag Remove-ComplianceTag Set-ComplianceTag	Exibir, criar, excluir, configurar rótulos de retenção	Caixas de correio do Exchange Sites do SharePoint (ou sites clássicos e de comunicação do SharePoint) Contas OneDrive Caixas de correio do Grupo Microsoft 365 & sites
Get-RecordReviewNotificationTemplateConfig Set-RecordReviewNotificationTemplateConfig	Exibir ou configurar as configurações de notificação de revisão de disposição e lembrete	Caixas de correio do Exchange Sites do SharePoint (ou sites clássicos e de comunicação do SharePoint) Contas OneDrive Caixas de correio do Grupo Microsoft 365 & sites
Get-RetentionCompliancePolicy New-RetentionCompliancePolicy Remove-RetentionCompliancePolicy Set-RetentionCompliancePolicy	Exibir, criar, excluir, configurar políticas de retenção e políticas de rótulo de retenção	Email do Exchange Sites do SharePoint (ou sites clássicos e de comunicação do SharePoint) Contas OneDrive Caixas de correio do Grupo Microsoft 365 & sites Skype for Business Pastas públicas do Exchange Mensagens de chat de equipes Mensagens do canal do Teams
Get-RetentionComplianceRule New-RetentionComplianceRule Set-RetentionComplianceRule Remove-RetentionComplianceRule	Exibir, criar, configurar, excluir configurações (regras) para políticas de retenção e rótulos de retenção	Email do Exchange Sites do SharePoint (ou sites clássicos e de comunicação do SharePoint) Contas OneDrive Caixas de correio do Grupo Microsoft 365 & sites Skype for Business Pastas públicas do Exchange Mensagens de chat de equipes Mensagens do canal do Teams

Cmdlets de retenção específicos para canais privados do Teams e Viva Engage

Use os cmdlets a seguir quando os locais forem para mensagens de canal privado do Teams, Viva Engage mensagens de usuário ou Viva Engage mensagens da comunidade.

Quando os locais são para mensagens de chat do Teams, mensagens de canal do Teams, email do Exchange, sites do SharePoint (ou sites clássicos e de comunicação do SharePoint), contas do OneDrive, caixas de correio do Grupo microsoft 365 & sites, Skype for Business ou pastas públicas do Exchange, use os cmdlets listados na seção anterior.

Cmdlet	Descrição	Locais aplicáveis
Get-AppRetentionCompliancePolicy New-AppRetentionCompliancePolicy Remove-AppRetentionCompliancePolicy Set-AppRetentionCompliancePolicy	Exibir, criar, excluir, configurar políticas de retenção	Mensagens do canal privado do Teams Viva Engage mensagens de usuário Viva Engage mensagens da comunidade
Get-AppRetentionComplianceRule New-AppRetentionComplianceRule Remove-AppRetentionComplianceRule Set-AppRetentionComplianceRule	Exibir, criar, configurar, excluir configurações (regras) para políticas de retenção	Mensagens do canal privado do Teams Viva Engage mensagens de usuário Viva Engage mensagens da comunidade

Instruções de configuração

Use as páginas de ajuda associadas a cada cmdlet para obter informações e exemplos detalhados.

Para obter ajuda guiada para criar e publicar rótulos de retenção, consulte Criar e publicar rótulos de retenção usando o PowerShell.