Set-DataEncryptionPolicy

Referência

Módulo:: ExchangePowerShell

Aplica-se a:: Exchange Online, Exchange Online Protection

Esse cmdlet só está disponível no serviço baseado em nuvem.

Use o cmdlet Set-DataEncryptionPolicy para modificar políticas de criptografia de dados no Exchange Online.

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

Syntax

Set-DataEncryptionPolicy
   [-Identity] <DataEncryptionPolicyIdParameter>
   -PermanentDataPurgeReason <String>
   [-PermanentDataPurgeContact <String>]
   [-Confirm]
   [-Description <String>]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-Force]
   [-Name <String>]
   [-WhatIf]
   [<CommonParameters>]

Set-DataEncryptionPolicy
   [-Identity] <DataEncryptionPolicyIdParameter>
   -PermanentDataPurgeContact <String>
   -PermanentDataPurgeReason <String>
   [-PermanentDataPurgeRequested]
   [-Confirm]
   [-Description <String>]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-Force]
   [-Name <String>]
   [-WhatIf]
   [<CommonParameters>]

Set-DataEncryptionPolicy
   [-Identity] <DataEncryptionPolicyIdParameter>
   [-Refresh]
   [-Confirm]
   [-Description <String>]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-Name <String>]
   [-WhatIf]
   [<CommonParameters>]

Description

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

Set-DataEncryptionPolicy -Identity "US Mailboxes" -Enabled $false

Este exemplo desabilitou a política de criptografia de dados chamada Caixas de Correio dos EUA.

Exemplo 2

Set-DataEncryptionPolicy -Identity "Europe Mailboxes" -Refresh

Este exemplo atualiza a política de criptografia de dados chamada Europe Mailboxes depois que uma das chaves associadas foi girada no Key Vault do Azure.

Parâmetros

-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:	Exchange Online, Exchange Online Protection

-Description

O parâmetro Description especifica uma descrição opcional para a política de criptografia de dados. Se o valor contiver espaços, coloque-o entre aspas.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-DomainController

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

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Enabled

O parâmetro Habilitado habilita ou desabilitar a política de criptografia de dados. Os valores válidos são:

$true: a política está habilitada.
$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:	Exchange Online, Exchange Online Protection

-Force

A opção Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.

Use essa opção para excluir todos os dados criptografados pela política de criptografia de dados (a opção PermanentDataPurgeRequested), mas o Key Vault associado do Azure também foi excluído.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Identity

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

Nome
DN (nome diferenciado)
GUID

Type:	DataEncryptionPolicyIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online

-Name

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-PermanentDataPurgeContact

O parâmetro PermanentDataPurgeContact especifica um contato para a limpeza de todos os dados criptografados pela política de criptografia de dados. Se o valor contiver espaços, coloque-o entre aspas.

Você precisa usar esse parâmetro com os parâmetros PermanentDataPurgeRequested e PermanentDataPurgeReason.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-PermanentDataPurgeReason

O parâmetro PermanentDataPurgeReason especifica um motivo descritivo para a limpeza de todos os dados criptografados pela política de criptografia de dados. Se o valor contiver espaços, coloque-o entre aspas.

Você precisa usar esse parâmetro com os parâmetros PermanentDataPurgeRequested e PermanentDataPurgeContact.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-PermanentDataPurgeRequested

A opção PermanentDataPurgeRequested especifica se deve iniciar a exclusão de todos os dados criptografados pela política de criptografia de dados. Não é preciso especificar um valor com essa opção.

Você precisa usar essa opção com os parâmetros PermanentDataPurgeReason e PermanentDataPurgeContact.

Depois de usar essa opção, você não poderá atribuir a política de criptografia de dados a outras caixas de correio.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Refresh

Use a opção Atualizar para atualizar a política de criptografia de dados no Exchange Online depois de girar qualquer uma das chaves associadas no Key Vault do Azure. Não é preciso especificar um valor com essa opção.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection