New-RetentionCompliancePolicy
Esse cmdlet está disponível apenas no PowerShell de Conformidade de Segurança & . Para obter mais informações, consulte PowerShell de Conformidade de Segurança&.
Use o cmdlet New-RetentionCompliancePolicy para criar novas políticas de retenção e novas políticas de rótulo de retenção no portal de conformidade do Microsoft Purview. A criação de uma nova política também requer o uso do cmdlet New-RetentionComplianceRule.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Syntax
New-RetentionCompliancePolicy
[-Name] <String>
[-Applications <MultiValuedProperty>]
[-Comment <String>]
[-Confirm]
[-Enabled <Boolean>]
[-ExchangeLocation <MultiValuedProperty>]
[-ExchangeLocationException <MultiValuedProperty>]
[-Force]
[-IsSimulation]
[-ModernGroupLocation <MultiValuedProperty>]
[-ModernGroupLocationException <MultiValuedProperty>]
[-OneDriveLocation <MultiValuedProperty>]
[-OneDriveLocationException <MultiValuedProperty>]
[-PolicyTemplateInfo <PswsHashtable>]
[-PublicFolderLocation <MultiValuedProperty>]
[-RestrictiveRetention <Boolean>]
[-RetainCloudAttachment <Boolean>]
[-SharePointLocation <MultiValuedProperty>]
[-SharePointLocationException <MultiValuedProperty>]
[-SkypeLocation <MultiValuedProperty>]
[-SkypeLocationException <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>] New-RetentionCompliancePolicy
[-Name] <String>
[-Comment <String>]
[-Confirm]
[-Enabled <Boolean>]
[-Force]
[-IsSimulation]
[-RestrictiveRetention <Boolean>]
[-RetainCloudAttachment <Boolean>]
[-TeamsChannelLocation <MultiValuedProperty>]
[-TeamsChannelLocationException <MultiValuedProperty>]
[-TeamsChatLocation <MultiValuedProperty>]
[-TeamsChatLocationException <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>] New-RetentionCompliancePolicy
[-Name] <String>
-AdaptiveScopeLocation <MultiValuedProperty>
[-Applications <MultiValuedProperty>]
[-Comment <String>]
[-Confirm]
[-Enabled <Boolean>]
[-Force]
[-IsSimulation]
[-RestrictiveRetention <Boolean>]
[-RetainCloudAttachment <Boolean>]
[-WhatIf]
[<CommonParameters>] Description
As políticas não são válidas até que uma regra seja adicionada (para políticas de retenção) ou um rótulo seja adicionado (para políticas de rótulo de retenção). Para obter mais informações, consulte New-RetentionComplianceRule. Além disso, pelo menos um parâmetro de local deve ser definido para criar uma política de retenção ou uma política de rótulo de retenção.
Para usar esse cmdlet no PowerShell de Conformidade de Segurança & , você precisa receber permissões. Para obter mais informações, confira Permissões no portal de conformidade do Microsoft Purview.
Exemplos
Exemplo 1
New-RetentionCompliancePolicy -Name "Regulation 123 Compliance" -ExchangeLocation "Kitty Petersen", "Scott Nakamura" -SharePointLocation "https://contoso.sharepoint.com/sites/teams/finance"Este exemplo cria uma política de retenção chamada "Regulação 123 Conformidade" para as caixas de correio de Kitty Petersen e Scott Nakamura e o site financeiro do SharePoint Online.
A próxima etapa é usar o cmdlet New-RetentionComplianceRule para adicionar uma regra à política de retenção.
Exemplo 2
New-RetentionCompliancePolicy -Name "Marketing Department" -Enabled $true -SharePointLocation https://contoso.sharepoint.com -RetainCloudAttachment $true -Comment "Regulatory compliance for Marketing Dept."Este exemplo cria uma nova política de rótulo de aplicação automática direcionada a anexos de nuvem chamado Departamento de Marketing com os detalhes especificados.
A próxima etapa é usar o cmdlet New-RetentionComplianceRule para adicionar um rótulo de retenção à política de rótulo de retenção.
Parâmetros
-AdaptiveScopeLocation
O parâmetro AdaptiveScopeLocation especifica o local de escopo adaptável a ser incluído na política. Você cria escopos adaptáveis usando o cmdlet New-AdaptiveScope. Você pode usar qualquer valor que identifique exclusivamente o escopo adaptável. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Applications
O parâmetro Aplicativos especifica o destino quando Grupos do Microsoft 365 são incluídos na política (o parâmetro ModernGroups é definido). Os valores válidos são:
Group:Exchangepara a caixa de correio conectada ao Grupo do Microsoft 365.Group:SharePointpara o site do SharePoint conectado ao Grupo do Microsoft 365."Group:Exchange,SharePoint"para a caixa de correio e o site do SharePoint que estão conectados ao Grupo do Microsoft 365.- em branco (
$null): esse é o valor padrão e é funcionalmente equivalente ao valor"Group:Exchange,SharePoint".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Comment
O parâmetro Comment especifica um comentário opcional. Se você especificar um valor que contenha espaços, coloque-o entre aspas ("), por exemplo: “Está é uma observação de administrador”.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Confirm
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, cmdlets New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Enabled
O parâmetro Enabled especifica se a política está habilitada ou desabilitada. Os valores válidos são:
- $true: a política está habilitada. Esse é o valor padrão.
- $true: a política está habilitada. Esse é o valor padrão.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-ExchangeLocation
O parâmetro ExchangeLocation especifica as caixas de correio a serem incluídas na política. Os valores válidos são:
- O parâmetro ExchangeLocation especifica as caixas de correio que devem ser incluídas na política. Os valores válidos são:
- Uma caixa de correio
- O valor All para todas as caixas de correio. Você só pode usar esse valor sozinho.
O valor All para todas as caixas de correio. Você só pode usar esse valor sozinho.
- Nome
- Nome
- Nome diferenciado (DN)
- GUID
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
Se nenhuma caixa de correio for especificada, nenhuma caixa de correio será colocada em espera.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-ExchangeLocationException
O parâmetro ExchangeLocationException especifica as caixas de correio a serem excluídas da política quando você usa o valor All para o parâmetro ExchangeLocation. Os valores válidos são:
- Este parâmetro especifica as caixas de correio a serem removidas da lista de caixas de correio excluídas quando você usa o valor All para o parâmetro ExchangeLocation. Os valores válidos são:
- Uma caixa de correio
O valor All para todas as caixas de correio. Você só pode usar esse valor sozinho.
- Nome
- Nome
- Nome diferenciado (DN)
- GUID
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Force
A opção Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.
Você pode usar essa opção para executar tarefas de modo programático onde a solicitação por entrada administrativa é inadequada.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-IsSimulation
A opção IsSimulation especifica que a política é criada no modo de simulação. 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-ModernGroupLocation
O parâmetro ModernGroupLocation especifica o Grupos do Microsoft 365 a ser incluído na política. Os valores válidos são:
- Um grupo do Microsoft 365
- O valor All para todos os Grupos do Microsoft 365. Você só pode usar esse valor sozinho.
Para identificar o Grupo do Microsoft 365, você pode usar qualquer valor que o identifique exclusivamente. Por exemplo:
- Nome
- Nome
- Nome diferenciado (DN)
- GUID
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-ModernGroupLocationException
O parâmetro ModernGroupLocationException especifica o Grupos do Microsoft 365 a excluir da política quando você usa o valor All para o parâmetro ModernGroupLocation.
Você pode usar qualquer valor que identifique exclusivamente o Grupo do Microsoft 365. Por exemplo:
- Nome
- Nome
- Nome diferenciado (DN)
- GUID
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Name
O parâmetro Name especifica o nome exclusivo da política de retenção. Se o valor contiver espaços, coloque-o entre aspas.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-OneDriveLocation
O parâmetro OneDriveLocation especifica os OneDrive for Business sites a serem incluídos. Identifique o site pelo respectivo valor de URL ou use o valor All para incluir todos os sites.
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-OneDriveLocationException
Esse parâmetro especifica os OneDrive for Business sites a serem excluídos quando você usa o valor Todos para o parâmetro OneDriveLocation. Você pode identificar o site pelo valor da URL.
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-PolicyTemplateInfo
Esse parâmetro está reservado para uso interno da Microsoft.
| Type: | PswsHashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-PublicFolderLocation
O parâmetro PublicFolderLocation especifica que você deseja incluir todas as pastas públicas na política de retenção. Use o valor All para esse parâmetro.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RestrictiveRetention
O parâmetro RestrictiveRetention especifica se o Bloqueio de Preservação está habilitado para a política. Os valores válidos são:
- $true: o Bloqueio de Preservação está habilitado para a política. Ninguém - incluindo um administrador - pode desativar a política ou torná-la menos restritiva.
- $false: O Bloqueio de Preservação não está habilitado para a política. Esse é o valor padrão.
Após o bloqueio de uma política, ninguém poderá desativá-la, desabilitá-la nem remover conteúdo dela. E não é possível modificar ou excluir conteúdo que está sujeito à política durante o período de retenção. As únicas formas possíveis de modificar a política de retenção são adicionando conteúdo a ela ou ampliando sua duração. Uma política bloqueada pode ser aumentada ou estendida, mas não pode ser reduzida, desabilitada ou desativada.
Portanto, antes de bloquear uma política de retenção, é fundamental que você entenda os requisitos de conformidade da sua organização e que não bloqueie uma política até ter certeza de que é o que você precisa.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RetainCloudAttachment
Observação: esse parâmetro está atualmente em Versão Prévia, não está disponível em todas as organizações e está sujeito a alterações.
O parâmetro RetainCloudAttachment especifica que essa é uma política de anexo de nuvem. Os valores válidos são:
- $true: a política é uma política de anexo de nuvem.
- $false: a política não é uma política de anexo de nuvem. Esse é o valor padrão.
Para o valor $true, você só pode usar os seguintes parâmetros de local:
- SharePointLocation e SharePointLocationException
- OneDriveLocation e OneDriveLocationException
- ModernGroupLocation e ModernGroupLocationException
Uma marca que usa uma política de anexo de nuvem para criar uma regra pode ser um rótulo de registro ou um rótulo regulatório. Você não pode usar uma marca de publicação para uma política de anexo de nuvem para criar uma regra; há suporte apenas para aplicar marcas.
O parâmetro RetainCloudAttachment não está disponível no cmdlet Set-RetentionCompliancePolicy.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-SharePointLocation
O parâmetro SharePointLocation especifica os sites do SharePoint Online a serem incluídos. Identifique o site pelo respectivo valor de URL ou use o valor All para incluir todos os sites.
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
Os sites do SharePoint Online não podem ser adicionados à política até que tenham sido indexados. Se nenhum site for especificado, nenhum site será colocado em espera.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-SharePointLocationException
Esse parâmetro especifica os sites do SharePoint Online a serem excluídos quando você usa o valor Todos para o parâmetro SharePointLocation. Você pode identificar o site pelo valor da URL.
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-SkypeLocation
O parâmetro SkypeLocation especifica os usuários do Skype for Business Online a serem incluídos na política.
É possível usar qualquer valor que identifique o usuário com exclusividade. Por exemplo:
- Nome
- Nome
- Nome diferenciado (DN)
- GUID
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-SkypeLocationException
Esse parâmetro está reservado para uso interno da Microsoft.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-TeamsChannelLocation
O parâmetro TeamsChannelLocation especifica o Teams a ser incluído na política.
Você pode usar qualquer valor que identifique exclusivamente a equipe. Por exemplo:
- Nome
- Endereço de email
- GUID
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-TeamsChannelLocationException
O parâmetro TeamsChannelLocationException especifica o Teams a ser excluído quando você usa o valor All para o parâmetro TeamsChannelLocation. Você pode usar qualquer valor que identifique exclusivamente a equipe. Por exemplo:
- Nome
- Endereço de email
- GUID
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-TeamsChatLocation
O parâmetro TeamsChatLocation especifica os usuários do Teams a serem incluídos na política.
É possível usar qualquer valor que identifique o usuário com exclusividade. Por exemplo:
- Nome
- Nome
- Nome diferenciado (DN)
- GUID
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-TeamsChatLocationException
O parâmetro TeamsChatLocationException especifica os usuários do Teams a serem excluídos quando você usa o valor All para o parâmetro TeamsChatLocation. É possível usar qualquer valor que identifique o usuário com exclusividade. Por exemplo:
- Nome
- Nome
- Nome diferenciado (DN)
- GUID
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-WhatIf
A opção WhatIf não funciona no PowerShell de Conformidade de Segurança & .
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |