New-HoldCompliancePolicy

Referência

Módulo:: ExchangePowerShell

Aplica-se a:: Security & Compliance

Esse cmdlet está disponível apenas no PowerShell de Conformidade de Segurança & . Para obter mais informações, confira PowerShell de Conformidade de Segurança&.

Use o cmdlet New-HoldCompliancePolicy para criar novas políticas de preservação no portal de conformidade do Microsoft Purview.

Observação: o cmdlet New-HoldCompliancePolicy foi substituído pelo cmdlet New-RetentionCompliancePolicy. Se você tiver scripts que usam New-HoldCompliancePolicy, atualize-os para usar New-RetentionCompliancePolicy.

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

Syntax

New-HoldCompliancePolicy
   [-Name] <String>
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-ExchangeLocation <MultiValuedProperty>]
   [-Force]
   [-PublicFolderLocation <MultiValuedProperty>]
   [-SharePointLocation <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Description

Novas políticas não são válidas e não serão aplicadas até que uma regra de preservação seja adicionada à política.

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-HoldCompliancePolicy -Name "Regulation 123 Compliance" -ExchangeLocation "Kitty Petersen", "Scott Nakamura" -SharePointLocation "https://contoso.sharepoint.com/sites/teams/finance"

Este exemplo cria uma política de preservação chamada "Conformidade do Regulamento 123" para as caixas de correio de Kitty Petersen e Scott Nakamura e o site financeiro do SharePoint Online.

Parâmetros

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

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

-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

-Name

O parâmetro Name especifica o nome exclusivo da política de preservaçã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

-PublicFolderLocation

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

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