New-M365DataAtRestEncryptionPolicy

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Exchange Online

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

Use o cmdlet New-M365DataAtRestEncryptionPolicy para criar uma nova política de criptografia Microsoft 365 dados em repouso.

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

Syntax

New-M365DataAtRestEncryptionPolicy
   [-Name] <String>
   -AzureKeyIDs <MultiValuedProperty>
   [-Confirm]
   [-Description <String>]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Description

Use o cmdlet New-M365DataAtRestEncryptionPolicy para criar um Microsoft política de criptografia de 365 dados em repouso para uso de várias cargas de trabalho. Para obter mais informações, consulte Visão geral da Chave do Cliente M365 no nível do locatário e Criar um DEP para uso com várias cargas de trabalho para todos os usuários locatários.

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

New-M365DataAtRestEncryptionPolicy -Name "Default_Policy" -AzureKeyIDs "https://contosoWestUSvault01.vault.azure.net/keys/Key_01","https://contosoEastUSvault01.vault.azure.net/keys/Key_02" -Description "Tenant default policy"

Este exemplo cria um Microsoft política de criptografia de várias cargas de trabalho de 365 dados em repouso chamada Default_Policy com as chaves e a descrição especificadas do Azure Key Vault para todos os usuários em seu locatário.

Parâmetros

-AzureKeyIDs

O parâmetro AzureKeyIDs especifica a URL da chave de criptografia no Azure Key Vault usada para criptografia. Por exemplo, https://contoso.vault.azure.net/keys/key1/.

Você pode especificar vários valores separados por vírgulas usando a seguinte sintaxe: "AzureKeyID1","AzureKeyID2",..."AzureKeyIDN".

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

-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

-Description

O parâmetro Description especifica uma descrição opcional para a política.

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

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

-Name

O parâmetro Name especifica um nome exclusivo para a política de criptografia Microsoft 365 dados em repouso. Se o valor contiver espaços, coloque-o entre aspas (").

Type:String
Position:0
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