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

Descrição do serviço Microsoft Purview

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

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

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 é estática ou adaptável e os locais para a política a ser aplicada.

Quando você usa políticas de retenção, a política requer 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, esses rótulos 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 defina quais rótulos devem ser exibidos nos 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.

Cmdlets de retenção para locais mais antigos

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 & sites do Grupo do Microsoft 365, Skype for Business, pastas públicas do Exchange, chats do Teams e interações do Copilot ou mensagens de canal do Teams.

Não use esses cmdlets quando os locais forem para mensagens de canal privado do Teams (somente pré-migração aplicável), mensagens de usuário do Viva Engage, mensagens da comunidade do Viva Engage, chats do Teams (sem interações do Copilot), experiências do Microsoft Copilot, aplicativos de IA corporativos ou outros aplicativos de IA. Esses locais têm cmdlets alternativos identificados na próxima seção.

Cmdlets de retenção para locais mais recentes

Use os cmdlets a seguir quando os locais forem para mensagens de canal privado do Teams (somente pré-migração aplicável), mensagens de usuário do Viva Engage, mensagens da comunidade do Viva Engage, chats do Teams, experiências do Microsoft Copilot, aplicativos de IA empresariais, outros aplicativos de IA e registros de chamadas do Teams.

Quando os locais forem para chats do Teams e interações do Copilot, 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 & sites do Grupo do Microsoft 365, Skype for Business ou pastas públicas do Exchange, use os cmdlets listados na seção anterior.

Instruções de configuração

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

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.