Partilhar via

New-CaseHoldPolicy

Módulo:
Exchange PowerShell

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 cmdlet New-CaseHoldPolicy para criar novas políticas de retenção de casos no portal de conformidade do Microsoft Purview.

Observação

Este cmdlet causa uma sincronização completa na sua organização, o que é uma operação significativa. Se precisar de criar várias políticas, aguarde até que a distribuição da política seja bem-sucedida antes de executar o cmdlet novamente para a política seguinte. Para obter informações sobre o status de distribuição, veja Get-CaseHoldPolicy.

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

Sintaxe

Default (Padrão) 

New-CaseHoldPolicy
    [-Name] <String>
    -Case <String>
    [-Comment <String>]
    [-Confirm]
    [-Enabled <Boolean>]
    [-ExchangeLocation <MultiValuedProperty>]
    [-Force]
    [-PublicFolderLocation <MultiValuedProperty>]
    [-SharePointLocation <MultiValuedProperty>]
    [-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.

Exemplos

Exemplo 1

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

Este exemplo cria uma política de suspensão de casos denominada "Conformidade do Regulamento 123" para as caixas de correio de Kitty Petersen e Scott Nakamura e o site financeiro do SharePoint para o caso de Deteção de Dados Eletrónicos denominado "123 Caso de Conformidade".

Lembre-se de que após criar a política, é necessário criar a regra para a política usando o cmdlet New-CaseHoldRule.

Parâmetros

-Case

Aplicável: Conformidade do & de Segurança

O parâmetro Case especifica o caso de Descoberta Eletrônica que você deseja associar à política de bloqueio de caso. Você pode usar os seguintes valores para identificar o caso de Descoberta Eletrônica:

  • Nome
  • Identidade (valor GUID)

Você encontra esses valores executando o comando Get-ComplianceCase | Format-Table -Auto Name,Status,Identity

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-Comment

Aplicável: Conformidade do & de Segurança

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

(All)
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: Conformidade do & de Segurança

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.

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

-Enabled

Aplicável: Conformidade do & de Segurança

O parâmetro Enabled especifica se a política está habilitada ou desabilitada. Os valores válidos são:

  • $true: a política está ativada. Este valor é a predefiniçã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

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

-ExchangeLocation

Aplicável: Conformidade do & de Segurança

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

Para especificar uma caixa de correio ou um grupo de distribuição, pode utilizar os seguintes valores:

  • Nome
  • Endereço SMTP. Para especificar uma caixa de correio inativa, preceda o endereço com um ponto final (.).
  • Microsoft Entra ObjectId. Utilize os cmdlets Get-MgUser ou Get-MgGroup no Microsoft Graph PowerShell para localizar este valor.

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

Tipo:MultiValuedProperty
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: Conformidade do & de Segurança

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.

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

-Name

Aplicável: Conformidade do & de Segurança

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

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-PublicFolderLocation

Aplicável: Conformidade do & de Segurança

O parâmetro PublicFolderLocation especifica que você deseja incluir todas as pastas públicas na política de bloqueio de caso. 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

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

-SharePointLocation

Aplicável: Conformidade do & de Segurança

O parâmetro SharePointLocation especifica os sites sharePoint e OneDrive a incluir. Identifica um site pelo respetivo valor de URL.

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

Os sites não podem ser adicionados à política até serem indexados. Se nenhum site for especificado, nenhum site será colocado em espera.

Propriedades do parâmetro

Tipo:MultiValuedProperty
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: Conformidade do & de Segurança

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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.