Set-RetentionCompliancePolicy

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

Use o cmdlet Set-RetentionCompliancePolicy para modificar as políticas de retenção existentes no portal de conformidade do Microsoft Purview.

Observação: a execução deste cmdlet causa uma sincronização completa em toda a sua organização, o que é uma operação significativa. Se você precisar atualizar várias políticas, aguarde até que a distribuição de política seja bem-sucedida antes de executar o cmdlet novamente para a próxima política. Para obter informações sobre o status da distribuição, consulte Get-RetentionCompliancePolicy.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Sintaxe

Identity

Set-RetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-AddExchangeLocation <MultiValuedProperty>]
    [-AddExchangeLocationException <MultiValuedProperty>]
    [-AddModernGroupLocation <MultiValuedProperty>]
    [-AddModernGroupLocationException <MultiValuedProperty>]
    [-AddOneDriveLocation <MultiValuedProperty>]
    [-AddOneDriveLocationException <MultiValuedProperty>]
    [-AddPublicFolderLocation <MultiValuedProperty>]
    [-AddSharePointLocation <MultiValuedProperty>]
    [-AddSharePointLocationException <MultiValuedProperty>]
    [-AddSkypeLocation <MultiValuedProperty>]
    [-AddSkypeLocationException <MultiValuedProperty>]
    [-Applications <MultiValuedProperty>]
    [-Comment <String>]
    [-Confirm]
    [-DeletedResources <String>]
    [-Enabled <Boolean>]
    [-EnforceSimulationPolicy <Boolean>]
    [-Force]
    [-PolicyTemplateInfo <PswsHashtable>]
    [-PolicyRBACScopes <MultiValuedProperty>]
    [-PriorityCleanup]
    [-RemoveExchangeLocation <MultiValuedProperty>]
    [-RemoveExchangeLocationException <MultiValuedProperty>]
    [-RemoveModernGroupLocation <MultiValuedProperty>]
    [-RemoveModernGroupLocationException <MultiValuedProperty>]
    [-RemoveOneDriveLocation <MultiValuedProperty>]
    [-RemoveOneDriveLocationException <MultiValuedProperty>]
    [-RemovePublicFolderLocation <MultiValuedProperty>]
    [-RemoveSharePointLocation <MultiValuedProperty>]
    [-RemoveSharePointLocationException <MultiValuedProperty>]
    [-RemoveSkypeLocation <MultiValuedProperty>]
    [-RemoveSkypeLocationException <MultiValuedProperty>]
    [-RestrictiveRetention <Boolean>]
    [-StartSimulation <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

AdaptiveScopeLocation

Set-RetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-AddAdaptiveScopeLocation <MultiValuedProperty>]
    [-Applications <MultiValuedProperty>]
    [-Comment <String>]
    [-Confirm]
    [-DeletedResources <String>]
    [-Enabled <Boolean>]
    [-EnforceSimulationPolicy <Boolean>]
    [-Force]
    [-PriorityCleanup]
    [-RemoveAdaptiveScopeLocation <MultiValuedProperty>]
    [-StartSimulation <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

RetryDistribution

Set-RetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-RetryDistribution]
    [-Confirm]
    [-DeletedResources <String>]
    [-EnforceSimulationPolicy <Boolean>]
    [-PriorityCleanup]
    [-StartSimulation <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

TeamLocation

Set-RetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-AddTeamsChannelLocation <MultiValuedProperty>]
    [-AddTeamsChannelLocationException <MultiValuedProperty>]
    [-AddTeamsChatLocation <MultiValuedProperty>]
    [-AddTeamsChatLocationException <MultiValuedProperty>]
    [-Comment <String>]
    [-Confirm]
    [-DeletedResources <String>]
    [-Enabled <Boolean>]
    [-EnforceSimulationPolicy <Boolean>]
    [-Force]
    [-PriorityCleanup]
    [-RemoveTeamsChannelLocation <MultiValuedProperty>]
    [-RemoveTeamsChannelLocationException <MultiValuedProperty>]
    [-RemoveTeamsChatLocation <MultiValuedProperty>]
    [-RemoveTeamsChatLocationException <MultiValuedProperty>]
    [-StartSimulation <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

Description

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.

Observação: não use um comando de Foreach-Object com tubulação ao adicionar ou remover locais de escopo: "Value1","Value2",..."ValueN" | Foreach-Object {Set-RetentionCompliancePolicy -Identity "Regulation 123 Compliance" -RemoveExchangeLocation $_}.

Exemplos

Exemplo 1

Set-RetentionCompliancePolicy -Identity "Regulation 123 Compliance" -AddExchangeLocation "Kitty Petersen" -AddSharePointLocation "https://contoso.sharepoint.com/sites/teams/finance" -RemovePublicFolderLocation All -Comment "Added new counsel, 9/9/14"

Este exemplo faz as seguintes alterações na política de retenção existente chamada "Regulamentação de conformidade 123":

  • Adiciona a caixa de correio para a usuária Brenda Fernandes.
  • Adiciona o site https://contoso.sharepoint.com/sites/teams/financedo SharePoint .
  • Remove as pastas públicas.
  • Atualiza o comentário.

Exemplo 2

$stringJson = @"
[{
     'EmailAddress': 'USSales@contoso.onmicrosoft.com',
     'SiteId': '9b2a8116-b9ec-4e2c-bf31-7eaa83697c4b'
}]
"@

Set-RetentionCompliancePolicy -Identity "Sales Policy" -RemoveModernGroupLocation "USSales@contoso.onmicrosoft.com" -DeletedResources $stringJson

O exemplo remove o grupo e o site excluídos do Microsoft 365 especificados da política especificada. Você identifica os recursos excluídos usando o endereço de email do Grupo do Microsoft 365 e a ID do site relacionado.

IMPORTANTE: antes de executar esse comando, leia as informações de Cuidado para o parâmetro DeletedResources sobre endereços SMTP duplicados.

Exemplo 3

$stringJson = @"
[{
     'EmailAddress': 'USSales@contoso.onmicrosoft.com',
     'SiteId': '8b2a8345-b9ec-3b6a-bf31-6eaa83697c4b'
}]
"@

Set-RetentionCompliancePolicy -Identity "Tenant Level Policy" -AddModernGroupLocationException "USSales@contoso.onmicrosoft.com" -DeletedResources $stringJson

O exemplo exclui o grupo e o site excluídos do Microsoft 365 especificados da política de nível de locatário especificada. Você identifica os recursos excluídos usando o endereço de email do Grupo do Microsoft 365 e a ID do site relacionado.

IMPORTANTE: antes de executar esse comando, leia as informações de Cuidado para o parâmetro DeletedResources sobre endereços SMTP duplicados.

Exemplo 4

$stringJson = @"
[{
     'EmailAddress': 'USSales2@contoso.onmicrosoft.com',
     'SiteId': '9b2a8116-b9ec-4e2c-bf31-7eaa83697c4b'
 },
{
     'EmailAddress': 'USSales2@contoso.onmicrosoft.com',
     'SiteId': '4afb7116-b9ec-4b2c-bf31-4abb83697c4b'
}]
"@

Set-RetentionCompliancePolicy -Identity "Sales Policy" -RemoveModernGroupLocation "USSales2@contoso.onmicrosoft.com" -DeletedResources $stringJson

Este exemplo é semelhante ao Exemplo 2, exceto que vários recursos excluídos são especificados.

IMPORTANTE: antes de executar esse comando, leia as informações de Cuidado para o parâmetro DeletedResources sobre endereços SMTP duplicados.

Exemplo 5

$stringJson = @"
[{
     'EmailAddress': 'SalesUser@contoso.onmicrosoft.com'
}]
"@

Set-RetentionCompliancePolicy -Identity "Teams Chat Retention Policy" -AddTeamsChatLocationException "SalesUser@contoso.onmicrosoft.com" -DeletedResources $stringJson

Este exemplo exclui a caixa de correio excluída temporariamente especificada ou o usuário de email da Política de Retenção do Teams mencionada. Você pode identificar os recursos excluídos usando a caixa de correio ou o endereço de email do usuário de email.

IMPORTANTE: antes de executar esse comando, leia as informações de Cuidado para o parâmetro DeletedResources sobre endereços SMTP duplicados.

Exemplo 6

$stringJson = @"
[{
     'EmailAddress': 'SalesUser1@contoso.onmicrosoft.com'
},
{
     'EmailAddress': 'SalesUser2@contoso.onmicrosoft.com'
}]
"@

Set-RetentionCompliancePolicy -Identity "Teams Chat Retention Policy" -AddTeamsChatLocationException "SalesUser1@contoso.onmicrosoft.com", "SalesUser2@contoso.onmicrosoft.com" -DeletedResources $stringJson

Este exemplo é semelhante ao Exemplo 5, exceto que vários recursos excluídos são especificados.

IMPORTANTE: antes de executar esse comando, leia as informações de Cuidado para o parâmetro DeletedResources sobre endereços SMTP duplicados.

As exclusões de política devem permanecer dentro dos limites com suporte para políticas de retenção: limites para políticas de retenção do Microsoft 365 e políticas de rótulos de retenção

Parâmetros

-AddAdaptiveScopeLocation

Aplicável: Segurança & Conformidade

O parâmetro AddAdaptiveScopeLocation especifica o local do escopo adaptável a ser adicionado à 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

Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AdaptiveScopeLocation
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AddExchangeLocation

Aplicável: Segurança & Conformidade

O parâmetro AddExchangeLocation especifica as caixas de correio a serem adicionadas à lista de caixas de correio incluídas quando você não estiver usando o valor All para o parâmetro ExchangeLocation. 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.

  • 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

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AddExchangeLocationException

Aplicável: Segurança & Conformidade

Esse parâmetro especifica as caixas de correio a serem adicionadas à lista de caixas de correio excluídas 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

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AddModernGroupLocation

Aplicável: Segurança & Conformidade

O parâmetro AddModernGroupLocation especifica os Grupos do Microsoft 365 a serem adicionados à lista de Grupos do Microsoft 365 incluídos quando você não estiver usando o valor Todos 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

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AddModernGroupLocationException

Aplicável: Segurança & Conformidade

O parâmetro AddModernGroupLocationException especifica os Grupos do Microsoft 365 a serem adicionados à lista de Grupos do Microsoft 365 excluídos quando você estiver usando o valor Todos 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

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AddOneDriveLocation

Aplicável: Segurança & Conformidade

O parâmetro AddOneDriveLocation especifica os sites do OneDrive a serem adicionados à lista de sites incluídos quando você não estiver usando o valor All 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

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AddOneDriveLocationException

Aplicável: Segurança & Conformidade

Esse parâmetro especifica os sites do OneDrive a serem adicionados à lista de sites 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".

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AddPublicFolderLocation

Aplicável: Segurança & Conformidade

O parâmetro AddPublicFolderLocation especifica que você deseja adicionar todas as pastas públicas à política de retenção. Use o valor All para esse parâmetro.

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AddSharePointLocation

Aplicável: Segurança & Conformidade

O parâmetro AddSharePointLocation especifica os sites do SharePoint a serem adicionados à lista de sites incluídos quando você não estiver usando 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".

Os sites do SharePoint não podem ser adicionados à política até que tenham sido indexados.

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AddSharePointLocationException

Aplicável: Segurança & Conformidade

Esse parâmetro especifica os sites do SharePoint a serem adicionados à lista de sites 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".

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AddSkypeLocation

Aplicável: Segurança & Conformidade

O parâmetro AddSkypeLocation especifica os usuários do Skype for Business Online a serem adicionados da lista de usuários incluídos do Skype for Business Online.

É 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

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AddSkypeLocationException

Aplicável: Segurança & Conformidade

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

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AddTeamsChannelLocation

Aplicável: Segurança & Conformidade

O parâmetro AddTeamsChannelLocation especifica as equipes a serem adicionadas à 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

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

TeamLocation
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AddTeamsChannelLocationException

Aplicável: Segurança & Conformidade

O parâmetro AddTeamsChannelLocationException especifica as equipes a serem adicionadas à lista de exclusão quando você usa o valor Todos 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

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

TeamLocation
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AddTeamsChatLocation

Aplicável: Segurança & Conformidade

O parâmetro AddTeamsChatLocation especifica os usuários do Teams a serem adicionados à 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

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

TeamLocation
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AddTeamsChatLocationException

Aplicável: Segurança & Conformidade

O parâmetro AddTeamsChatLocationException especifica os usuários do Teams a serem adicionados à lista de exclusão 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
  • 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

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

TeamLocation
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-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". Para retornar ao valor padrão tanto da caixa postal como do site SharePoint para os grupos Microsoft 365 selecionados, especifique "Group:Exchange,SharePoint".

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-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

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
TeamLocation
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-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

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DeletedResources

Aplicável: Segurança & Conformidade

O parâmetro DeletedResources especifica o usuário de email, caixa de correio ou grupo do Microsoft 365 excluído a ser removido ou adicionado como uma exclusão à respectiva lista de locais. Use esse parâmetro com os parâmetros AddModernGroupLocationException e RemoveModernGroupLocation para Grupos do Microsoft 365 excluídos ou com o parâmetro AddTeamsChatLocationException para caixas de correio excluídas ou usuários de email.

Um valor válido é uma cadeia de caracteres JSON. Consulte a seção Exemplos para obter exemplos de sintaxe e uso desse parâmetro.

CUIDADO: Ao usar um endereço SMTP com esse parâmetro, lembre-se de que o mesmo endereço também pode estar em uso para outras caixas de correio ou usuários de email. Para marcar se há caixas de correio adicionais ou usuários de email com o mesmo endereço SMTP, use o comando a seguir e substitua user@contoso.com pelo endereço SMTP para marcar:Get-Recipient -IncludeSoftDeletedRecipients user@contoso.com | Select-Object DisplayName, EmailAddresses, Description, Alias, RecipientTypeDetails, WhenSoftDeleted

Para impedir que caixas de correio ativas ou usuários de email com o mesmo endereço SMTP sejam excluídos, coloque a caixa de correio em Retenção de Litígio antes de executar o comando com o parâmetro DeletedResources.

Para obter mais informações sobre o cenário excluído do Grupo do Microsoft 365, consulte Saiba mais sobre a exclusão de grupo moderna sob retenção

Para obter mais informações sobre o cenário de caixa de correio inativa, consulte Saiba mais sobre caixas de correio inativas.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Enabled

Aplicável: Segurança & Conformidade

O parâmetro Enabled especifica se a política está habilitada. 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

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
TeamLocation
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-EnforceSimulationPolicy

Aplicável: Segurança & Conformidade

O parâmetro EnforceSimulationPolicy especifica se uma política de simulação deve ser imposta como uma política ativa. Os valores válidos são:

  • $true: Impor a política de simulação como uma política ativa.
  • $false: Não imponha a política de simulação como uma política ativa. Esse valor é o padrão.

Para obter mais informações sobre o modo de simulação, consulte Saiba sobre o modo de simulação.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-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

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
TeamLocation
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Identity

Aplicável: Segurança & Conformidade

O parâmetro Identity especifica a política de retenção que você deseja modificar. É possível usar qualquer valor que identifique a política com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID

Propriedades do parâmetro

Tipo:PolicyIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-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

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PolicyTemplateInfo

Aplicável: Segurança & Conformidade

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

Propriedades do parâmetro

Tipo:PswsHashtable
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PriorityCleanup

Aplicável: Segurança & Conformidade

A opção PriorityCleanup especifica se uma política de limpeza de prioridade deve ser atualizada. 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

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RemoveAdaptiveScopeLocation

Aplicável: Segurança & Conformidade

O parâmetro RemoveAdaptiveScopeLocation especifica o local do escopo adaptável a ser removido da 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

Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AdaptiveScopeLocation
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RemoveExchangeLocation

Aplicável: Segurança & Conformidade

O parâmetro RemoveExchangeLocation especifica as caixas de correio a serem removidas da lista de caixas de correio incluídas quando você não estiver usando o valor All para o parâmetro ExchangeLocation.

É possível usar qualquer valor que identifique a caixa de correio 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

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RemoveExchangeLocationException

Aplicável: Segurança & Conformidade

O parâmetro RemoveExchangeLocationException 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.

É possível usar qualquer valor que identifique a caixa de correio 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

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RemoveModernGroupLocation

Aplicável: Segurança & Conformidade

O parâmetro RemoveModernGroupLocation especifica os Grupos do Microsoft 365 a serem removidos da lista de grupos incluídos quando você não estiver usando 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

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RemoveModernGroupLocationException

Aplicável: Segurança & Conformidade

O parâmetro RemoveModernGroupLocationException especifica os Grupos do Microsoft 365 a serem removidos da lista de grupos excluídos quando você estiver usando 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

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RemoveOneDriveLocation

Aplicável: Segurança & Conformidade

O parâmetro RemoveOneDriveLocation especifica os sites do OneDrive a serem removidos da lista de sites incluídos quando você não estiver usando o valor All 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

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RemoveOneDriveLocationException

Aplicável: Segurança & Conformidade

Esse parâmetro especifica os sites do OneDrive a serem removidos da lista de sites 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".

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RemovePublicFolderLocation

Aplicável: Segurança & Conformidade

O parâmetro RemovePublicFolderLocation especifica que você deseja remover todas as pastas públicas da política de retenção. Use o valor All para esse parâmetro.

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RemoveSharePointLocation

Aplicável: Segurança & Conformidade

O parâmetro RemoveSharePointLocation especifica os sites do SharePoint a serem removidos da lista de sites incluídos quando você não estiver usando 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

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RemoveSharePointLocationException

Aplicável: Segurança & Conformidade

Esse parâmetro especifica os sites do SharePoint a serem removidos da lista de sites 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

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RemoveSkypeLocation

Aplicável: Segurança & Conformidade

O parâmetro RemoveSkypeLocation especifica os usuários do Skype for Business Online a serem removidos da lista de usuários incluídos do Skype for Business Online.

É 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

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RemoveSkypeLocationException

Aplicável: Segurança & Conformidade

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

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RemoveTeamsChannelLocation

Aplicável: Segurança & Conformidade

O parâmetro RemoveTeamsChannelLocation especifica as equipes a serem removidas da 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

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

TeamLocation
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RemoveTeamsChannelLocationException

Aplicável: Segurança & Conformidade

O parâmetro RemoveTeamsChannelLocationException especifica as equipes a serem removidas da lista de exclusão ao usar 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

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

TeamLocation
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RemoveTeamsChatLocation

Aplicável: Segurança & Conformidade

O parâmetro RemoveTeamsChatLocation especifica os usuários do Teams a serem removidos da 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

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

TeamLocation
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RemoveTeamsChatLocationException

Aplicável: Segurança & Conformidade

O parâmetro RemoveTeamsChatLocationException especifica os usuários do Teams a serem removidos da lista de exclusão 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
  • 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

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

TeamLocation
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RestrictiveRetention

Aplicável: Segurança & Conformidade

O parâmetro RestrictiveRetention especifica se o Bloqueio de Preservação está habilitado para uma política de retenção ou uma política de rótulo de retenção. 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. A única maneira de modificar a política de retenção é adicionando conteúdo a ela ou estendendo 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 para 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

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RetryDistribution

Aplicável: Segurança & Conformidade

O comutador RetryDistribution especifica se a política deve ser redistribuída para todos os locais do Exchange Online e do SharePoint. Não é preciso especificar um valor com essa opção.

Locais cujas distribuições iniciais tenham êxito não são incluídos na repetição. Ao usar essa opção, os erros de distribuição de política são relatados.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

RetryDistribution
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-StartSimulation

Aplicável: Segurança & Conformidade

O parâmetro StartSimulation especifica se a simulação deve ser iniciada para uma política que foi criada no modo de simulação. Os valores válidos são:

  • $true: Inicie a simulação.
  • $false: Não inicie a simulação. Esse valor é o padrão.

Para obter mais informações sobre o modo de simulação, consulte Saiba sobre o modo de simulação.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Aplicável: Segurança & Conformidade

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.