Set-DataEncryptionPolicy

Módulo:
Exchange PowerShell

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

Use o cmdlet Set-DataEncryptionPolicy para modificar as 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.

Sintaxe

DCAdminPurgeKeyRequest 

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

TenantAdminPurgeKeyRequest 

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

RefreshKey 

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

ReplaceKey 

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

Description

Para executar esse cmdlet, você precisa ter permissões. Embora este artigo 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 denominada Caixas de Correio dos EUA.

Exemplo 2

Set-DataEncryptionPolicy -Identity "Europe Mailboxes" -Refresh

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

Parâmetros

-AzureKeyIDs

Aplicável: Exchange Online

{{ Preenche a descrição do AzureKeyIDs }}

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-Confirm

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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.

Este cmdlet tem uma pausa interna, portanto, use -Confirm:$false para ignorar a confirmação.

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

-Description

Aplicável: Exchange Online

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.

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

-DomainController

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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

Propriedades do parâmetro

Tipo:Fqdn
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

-Enabled

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

O parâmetro Enabled habilita ou desabilita 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.

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: Exchange Online, complemento de segurança interno para caixas de correio locais

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 a Azure Key Vault associada também foi excluída.

Propriedades do parâmetro

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

Conjuntos de parâmetros

TenantAdminPurgeKeyRequest
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
DCAdminPurgeKeyRequest
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: Exchange Online

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

Propriedades do parâmetro

Tipo:DataEncryptionPolicyIdParameter
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

-Name

Aplicável: Exchange Online

O parâmetro Name especifica o nome exclusivo para a política de criptografia de dados. 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:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PermanentDataPurgeContact

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-PermanentDataPurgeReason

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-PermanentDataPurgeRequested

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-Refresh

Aplicável: Exchange Online

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 na Azure Key Vault. Não é preciso especificar um valor com essa opção.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-Replace

Aplicável: Exchange Online

{{ Preencher Substituir Descrição }}

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-WhatIf

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. Não é preciso especificar um valor com essa opção.

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.