New-RetentionCompliancePolicy

Sintaxe

Default

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>]
    [-PolicyRBACScopes <MultiValuedProperty>]
    [-PolicyTemplateInfo <PswsHashtable>]
    [-PriorityCleanup]
    [-PublicFolderLocation <MultiValuedProperty>]
    [-RestrictiveRetention <Boolean>]
    [-RetainCloudAttachment <Boolean>]
    [-SharePointLocation <MultiValuedProperty>]
    [-SharePointLocationException <MultiValuedProperty>]
    [-SkipPriorityCleanupConfirmation]
    [-SkypeLocation <MultiValuedProperty>]
    [-SkypeLocationException <MultiValuedProperty>]
    [-WhatIf]
    [<CommonParameters>]

TeamLocation

New-RetentionCompliancePolicy
    [-Name] <String>
    [-Comment <String>]
    [-Confirm]
    [-Enabled <Boolean>]
    [-Force]
    [-IsSimulation]
    [-PriorityCleanup]
    [-RestrictiveRetention <Boolean>]
    [-RetainCloudAttachment <Boolean>]
    [-SkipPriorityCleanupConfirmation]
    [-TeamsChannelLocation <MultiValuedProperty>]
    [-TeamsChannelLocationException <MultiValuedProperty>]
    [-TeamsChatLocation <MultiValuedProperty>]
    [-TeamsChatLocationException <MultiValuedProperty>]
    [-WhatIf]
    [<CommonParameters>]

AdaptiveScopeLocation

New-RetentionCompliancePolicy
    [-Name] <String>
    -AdaptiveScopeLocation <MultiValuedProperty>
    [-Applications <MultiValuedProperty>]
    [-Comment <String>]
    [-Confirm]
    [-Enabled <Boolean>]
    [-Force]
    [-IsSimulation]
    [-PriorityCleanup]
    [-RestrictiveRetention <Boolean>]
    [-RetainCloudAttachment <Boolean>]
    [-SkipPriorityCleanupConfirmation]
    [-WhatIf]
    [<CommonParameters>]

Description

Exemplos

Exemplo 1

New-RetentionCompliancePolicy -Name "Regulation 123 Compliance" -ExchangeLocation "Kitty Petersen", "Scott Nakamura" -SharePointLocation "https://contoso.sharepoint.com/sites/teams/finance"

Exemplo 2

New-RetentionCompliancePolicy -Name "Marketing Department" -Enabled $true -SharePointLocation https://contoso.sharepoint.com -RetainCloudAttachment $true -Comment "Regulatory compliance for Marketing Dept."

Parâmetros

-AdaptiveScopeLocation

Aplicável: Segurança & Conformidade

O parâmetro AdaptiveScopeLocation especifica o local do 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

Propriedades do parâmetro

Conjuntos de parâmetros

-Applications

Aplicável: Segurança & Conformidade

O parâmetro Applications especifica o destino quando os Grupos do Microsoft 365 são incluídos na política (o parâmetro ModernGroups está definido). Os valores válidos são:

• Group:Exchange para a caixa de correio que está conectada ao Grupo do Microsoft 365.
• Group:SharePoint para 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.
• blank ($null): esse valor é o padrão e é funcionalmente equivalente ao valor "Group:Exchange,SharePoint".

Propriedades do parâmetro

Conjuntos de parâmetros

-Comment

Aplicável: Segurança & Conformidade

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

Propriedades do parâmetro

Conjuntos de parâmetros

-Confirm

Aplicável: Segurança & Conformidade

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.

• Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
• A maioria dos outros cmdlets (por exemplo, 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 reconhecer o comando antes de continuar.

Propriedades do parâmetro

Conjuntos de parâmetros

-Enabled

Aplicável: Segurança & Conformidade

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 valor é o padrão.
• $true: a política está habilitada. Esse é o valor padrão.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExchangeLocation

Aplicável: Segurança & Conformidade

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

Propriedades do parâmetro

Conjuntos de parâmetros

-ExchangeLocationException

Aplicável: Segurança & Conformidade

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

Propriedades do parâmetro

Conjuntos de parâmetros

-Force

Aplicável: Segurança & Conformidade

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.

Propriedades do parâmetro

Conjuntos de parâmetros

-IsSimulation

Aplicável: Segurança & Conformidade

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.

Propriedades do parâmetro

Conjuntos de parâmetros

-ModernGroupLocation

Aplicável: Segurança & Conformidade

O parâmetro ModernGroupLocation especifica os Grupos do Microsoft 365 a serem incluídos na política. Os valores válidos são:

• Um Grupo do Microsoft 365
• O valor Todos 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".

Propriedades do parâmetro

Conjuntos de parâmetros

-ModernGroupLocationException

Aplicável: Segurança & Conformidade

O parâmetro ModernGroupLocationException especifica os Grupos do Microsoft 365 a serem excluídos 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".

Propriedades do parâmetro

Conjuntos de parâmetros

-Name

Aplicável: Segurança & Conformidade

O parâmetro Name especifica o nome exclusivo da política de retenção. Se o valor contiver espaços, coloque-o entre aspas.

Propriedades do parâmetro

Conjuntos de parâmetros

-OneDriveLocation

Aplicável: Segurança & Conformidade

O parâmetro OneDriveLocation especifica os sites do OneDrive 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".

Propriedades do parâmetro

Conjuntos de parâmetros

-OneDriveLocationException

Aplicável: Segurança & Conformidade

Esse parâmetro especifica os sites do OneDrive a serem excluídos ao usar 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".

Propriedades do parâmetro

Conjuntos de parâmetros

-PolicyRBACScopes

Aplicável: Segurança & Conformidade

Observação: as unidades de Administração não são compatíveis no momento, portanto, este parâmetro não é funcional. As informações apresentadas aqui são para fins informativos quando o suporte para unidades administrativas é lançado.

O parâmetro PolicyRBACScopes especifica as unidades administrativas a serem atribuídas à política. Um valor válido é o Microsoft Entra ObjectID (valor GUID) da unidade administrativa. Vários valores, separados por vírgulas, podem ser especificados.

As unidades administrativas estão disponíveis somente no Microsoft Entra ID P1 ou P2. Você cria e gerencia unidades administrativas no Microsoft Graph PowerShell.

Propriedades do parâmetro

Conjuntos de parâmetros

-PolicyTemplateInfo

Aplicável: Segurança & Conformidade

Esse parâmetro está reservado para uso interno da Microsoft.

Propriedades do parâmetro

Conjuntos de parâmetros

-PriorityCleanup

Aplicável: Segurança & Conformidade

A opção PriorityCleanup especifica se uma política de limpeza de prioridade deve ser criada. Não é preciso especificar um valor com essa opção.

As políticas de limpeza prioritária agilizam a exclusão de conteúdo confidencial substituindo quaisquer configurações de retenção existentes ou retenções de Descoberta Eletrônica. Para obter mais informações, consulte Limpeza prioritária.

Propriedades do parâmetro

Conjuntos de parâmetros

-PublicFolderLocation

Aplicável: Segurança & Conformidade

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.

Propriedades do parâmetro

Conjuntos de parâmetros

-RestrictiveRetention

Aplicável: Segurança & Conformidade

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 valor é o padrão.

Depois que uma política é bloqueada, ninguém pode desativá-la ou desabilitá-la ou remover conteúdo da política. E não é possível modificar ou excluir conteúdo 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.

Propriedades do parâmetro

Conjuntos de parâmetros

-RetainCloudAttachment

Aplicável: Segurança & Conformidade

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 na nuvem. Os valores válidos são:

• $true: A política é uma política de anexo na nuvem.
• $false: a política não é uma política de anexo de nuvem. Esse valor é o padrão.

Para o valor $true, você só pode usar os seguintes parâmetros de localização:

• 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 uma gravadora de registro ou uma etiqueta regulatória. Você não pode usar uma marca de publicação para uma política de anexo em nuvem para criar uma regra; Há suporte apenas para tags Aplicar.

O parâmetro RetainCloudAttachment não está disponível no cmdlet Set-RetentionCompliancePolicy.

Propriedades do parâmetro

Conjuntos de parâmetros

-SharePointLocation

Aplicável: Segurança & Conformidade

O parâmetro SharePointLocation especifica os sites do SharePoint 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 não podem ser adicionados à política até que tenham sido indexados. Se nenhum site for especificado, nenhum site será colocado em espera.

Propriedades do parâmetro

Conjuntos de parâmetros

-SharePointLocationException

Aplicável: Segurança & Conformidade

Esse parâmetro especifica os sites do SharePoint a serem excluídos quando você usa o valor All 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".

Propriedades do parâmetro

Conjuntos de parâmetros

-SkipPriorityCleanupConfirmation

Aplicável: Segurança & Conformidade

{{ Preencher SkipPriorityCleanupConfirmation Description }}

Propriedades do parâmetro

Conjuntos de parâmetros

-SkypeLocation

Aplicável: Segurança & Conformidade

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

Propriedades do parâmetro

Conjuntos de parâmetros

-SkypeLocationException

Aplicável: Segurança & Conformidade

Esse parâmetro está reservado para uso interno da Microsoft.

Propriedades do parâmetro

Conjuntos de parâmetros

-TeamsChannelLocation

Aplicável: Segurança & Conformidade

O parâmetro TeamsChannelLocation especifica as equipes a serem incluídas 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".

Propriedades do parâmetro

Conjuntos de parâmetros

-TeamsChannelLocationException

Aplicável: Segurança & Conformidade

O parâmetro TeamsChannelLocationException especifica as equipes a serem excluídas 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".

Propriedades do parâmetro

Conjuntos de parâmetros

-TeamsChatLocation

Aplicável: Segurança & Conformidade

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

Propriedades do parâmetro

Conjuntos de parâmetros

-TeamsChatLocationException

Aplicável: Segurança & Conformidade

O parâmetro TeamsChatLocationException especifica os usuários do Teams a serem excluídos quando você usa o valor Todos 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".

Propriedades do parâmetro

Conjuntos de parâmetros

-WhatIf

Aplicável: Segurança & Conformidade

A opção WhatIf não funciona no PowerShell de Segurança e Conformidade.

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters