Compartilhar via


New-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 New-AppRetentionCompliancePolicy para criar 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

New-AppRetentionCompliancePolicy
   [-Name] <String>
   -AdaptiveScopeLocation <MultiValuedProperty>
   -Applications <String[]>
   [-Confirm]
   [-Comment <String>]
   [-Enabled <Boolean>]
   [-Force]
   [-RestrictiveRetention <Boolean>]
   [-WhatIf]
   [<CommonParameters>]
New-AppRetentionCompliancePolicy
   [-Name] <String>
   -Applications <String[]>
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-ExchangeLocation <MultiValuedProperty>]
   [-ExchangeLocationException <MultiValuedProperty>]
   [-Force]
   [-ModernGroupLocation <MultiValuedProperty>]
   [-ModernGroupLocationException <MultiValuedProperty>]
   [-PolicyRBACScopes <MultiValuedProperty>]
   [-RestrictiveRetention <Boolean>]
   [-WhatIf]
   [<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 canais privados do Teams, 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

New-AppRetentionCompliancePolicy -Name "Regulation 567 Compliance" -Applications "User:MicrosoftTeams,VivaEngage","Group:MicrosoftTeams,VivaEngage" -ExchangeLocation "Jennifer Petersen","Kitty Nakamura"

Este exemplo cria uma política de retenção de âmbito estático denominada Conformidade do Regulamento 567 para o Viva Engage mensagens de utilizador de Jennifer Petersen e Kitty Nakamura.

Depois de criar a política de retenção, utilize o cmdlet New-AppRetentionComplianceRule para criar uma regra de retenção e atribuir-lhe a política de retenção.

Parâmetros

-AdaptiveScopeLocation

O parâmetro AdaptiveScopeLocation especifica a localização do âmbito adaptável a incluir na política. Pode criar âmbitos ajustáveis com o cmdlet New-AdaptiveScope. Pode utilizar qualquer valor que identifique exclusivamente o âmbito adaptável. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID
Tipo:MultiValuedProperty
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Security & Compliance

-Applications

O parâmetro Aplicações especifica as aplicações a incluir na política e é relevante apenas para os seguintes parâmetros de localização:

  • ExchangeLocation
  • ModernGroupLocation
  • AdaptiveScopeLocation

Este parâmetro utiliza a seguinte sintaxe: em que "LocationtType:App1,LocationType:App2,...LocationType:AppN LocationType é Utilizador ou Grupo. Por exemplo: "User:Exchange,User:OneDriveForBusiness,Group:Exchange,Group:SharePoint" ou "User:MicrosoftTeams","User:VivaEngage".

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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”.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a: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, 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 confirmar o comando antes de continuar.
Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Security & Compliance

-Enabled

O parâmetro Ativado ativa ou desativa a política. Os valores válidos são:

  • $true: a política está ativada. Esse é o valor padrão.
  • $true: a política está habilitada. Esse é o valor padrão.
Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Security & Compliance

-ExchangeLocation

O parâmetro ExchangeLocation especifica as caixas de correio a incluir 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 Tudo 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".

Tipo:MultiValuedProperty
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Security & Compliance

-ExchangeLocationException

O parâmetro ExchangeLocationException especifica as caixas de correio excluídas da política quando utiliza o valor Tudo 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".

Tipo:MultiValuedProperty
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Security & Compliance

-Force

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Security & Compliance

-ModernGroupLocation

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

  • Um Grupo do Microsoft 365
  • O valor Tudo para todos os Grupos do Microsoft 365. Você só pode usar esse valor sozinho.

Para identificar o Grupo do Microsoft 365, pode utilizar 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".

Tipo:MultiValuedProperty
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Security & Compliance

-ModernGroupLocationException

O parâmetro ModernGroupLocationException especifica o Grupos do Microsoft 365 a excluir da política quando utiliza o valor All para o parâmetro ModernGroupLocation.

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

Tipo:MultiValuedProperty
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Security & Compliance

-Name

O parâmetro Nome especifica um nome exclusivo para a política de conformidade de retenção de aplicações. O tamanho máximo é de 64 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Security & Compliance

-PolicyRBACScopes

Nota: Administração unidades não são atualmente suportadas, pelo que este parâmetro não está funcional. As informações aqui apresentadas destinam-se a fins informativos quando o suporte para unidades de administração é lançado.

O parâmetro PolicyRBACScopes especifica as unidades administrativas a atribuir à 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 só estão disponíveis no Microsoft Entra ID P1 ou P2. Pode criar e gerir unidades administrativas no Microsoft Graph PowerShell.

Tipo:MultiValuedProperty
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Security & Compliance

-RestrictiveRetention

O parâmetro RestrictiveRetention especifica se o Bloqueio de Preservação está ativado para a política. Os valores válidos são:

  • $true: O Bloqueio de Preservação está ativado 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á ativado para a política. Esse é o valor padrão.

Depois de uma política ter sido bloqueada, ninguém pode desativá-la ou desativá-la ou remover aplicações da política. As únicas formas de modificar a política são ao adicionar aplicações à mesma ou ao prolongar a duração. Uma política bloqueada pode ser aumentada ou expandida, mas não pode ser reduzida, desativada ou desativada.

Por conseguinte, antes de bloquear uma política, é fundamental que compreenda os requisitos de conformidade da sua organização e que não bloqueie uma política até ter a certeza de que é o que precisa.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Security & Compliance

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False
Aplica-se a:Security & Compliance