Set-M365DataAtRestEncryptionPolicy

Módulo:
Exchange PowerShell

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

Use o cmdlet Set-M365DataAtRestEncryptionPolicy para modificar as políticas de criptografia de dados em repouso do Microsoft 365 no Exchange Online.

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

Sintaxe

TenantAdminPurgeKeyRequest 

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

RefreshKey 

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

ReplaceKey 

Set-M365DataAtRestEncryptionPolicy
    [-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-M365DataAtRestEncryptionPolicy -Identity "Tenant Default Policy" -Enabled $false

Este exemplo desabilitou a política de criptografia de dados em repouso do Microsoft 365 chamada Política Padrão do Locatário.

Exemplo 2

Set-M365DataAtRestEncryptionPolicy -Identity "Tenant Default Policy" -Refresh

Este exemplo atualiza a política de criptografia de dados em repouso do Microsoft 365 chamada Política Padrão do Locatário 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.

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.

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 especifica se a política está habilitada ou desabilitada. 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

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

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

DCAdminPurgeKeyRequest
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
TenantAdminPurgeKeyRequest
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 em repouso 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:0
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 um nome exclusivo para a política de criptografia de dados em repouso do Microsoft 365. 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

-Refresh

Aplicável: Exchange Online

Use a opção Atualizar para atualizar a política de criptografia de dados em repouso do Microsoft 365 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.