Compartilhar via

New-OMEConfiguration

  • 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-OMEConfiguration para criar uma configuração de Criptografia de Mensagens do Microsoft Purview.

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

Syntax

New-OMEConfiguration
   [-Identity] <OrganizationIdParameter>
   [-BackgroundColor <String>]
   [-Confirm]
   [-DisclaimerText <String>]
   [-EmailText <String>]
   [-ExternalMailExpiryInDays <Int32>]
   [-Image <Byte[]>]
   [-IntroductionText <String>]
   [-OTPEnabled <Boolean>]
   [-PortalText <String>]
   [-PrivacyStatementUrl <String>]
   [-ReadButtonText <String>]
   [-SocialIdSignIn <Boolean>]
   [-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

New-OMEConfiguration -Identity "Contoso Marketing" -EmailText "Encrypted message enclosed." -PortalText "This portal is encrypted." -DisclaimerText "Encryption security disclaimer." -Image ([System.IO.File]::ReadAllBytes('C:\Temp\OME Logo.gif'))

Este exemplo cria uma nova configuração de OME chamada "Contoso Marketing" com os valores especificados. Parâmetros não utilizados obtêm os valores padrão.

Parâmetros

-BackgroundColor

O parâmetro BackgroundColor especifica a cor de fundo. Os valores válidos são:

  • Um valor de código de cor hexadecimal (hex triplet) disponível (por exemplo, 0x000000 é branco).
  • Um valor de texto disponível (por exemplo, yellow é 0x00FFFF00).
  • $null (em branco). Esse é o valor padrão.

Para obter mais informações, confira Adicionar a marca da sua organização às suas mensagens criptografadas.

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

-Confirm

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

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

-DisclaimerText

O parâmetro DisclaimerText especifica o texto do aviso de isenção do email que contém a mensagem criptografada. O tamanho máximo é 1024 caracteres. 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

-EmailText

O parâmetro EmailText especifica o texto padrão que acompanha mensagens de email criptografadas. O texto padrão exibido acima das instruções para exibir mensagens criptografadas. O tamanho máximo é 1024 caracteres. 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

-ExternalMailExpiryInDays

Esse parâmetro só está disponível com uma assinatura Microsoft 365 Advanced Message Encryption.

O parâmetro ExternalMailExpiryInDays especifica o número de dias em que a mensagem criptografada está disponível para destinatários externos no portal Microsoft 365. Um valor válido é um inteiro de 0 a 730. O valor 0 significa que as mensagens nunca expirarão. O valor padrão é 0.

Na saída do cmdlet Get-OMEConfiguration, o valor desse parâmetro é exibido na propriedade ExternalMailExpiryInterval.

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

-Identity

O parâmetro Identity especifica um nome exclusivo para o objeto de configuração OME. O tamanho máximo é de 64 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

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

-Image

O parâmetro Image identifica e carrega uma imagem que será exibida na mensagem de email e no Centro de administração do Microsoft 365.

Um valor válido para esse parâmetro exige que você leia o arquivo em um objeto codificado por bytes usando a seguinte sintaxe: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Você pode usar esse comando como o valor do parâmetro ou gravar a saída em uma variável ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) e usar a variável como o valor do parâmetro ($data).

  • Formatos de arquivo com suporte: .png, .jpg, .bmp ou .tiff
  • Tamanho ideal do arquivo de logotipo: menos que 40 KB
  • Dimensões ideais da imagem de logotipo: 170x70 pixels
Type:Byte[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-IntroductionText

O parâmetro IntroductionText especifica o texto padrão que acompanha mensagens de email criptografadas. O texto padrão aparece abaixo do endereço de email do destinatário para exibir a mensagem criptografada. 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

-OTPEnabled

O parâmetro OTPEnabled especifica se deve ser permitido que os destinatários usem uma senha de uso único para exibir mensagens criptografadas. Os valores válidos são:

  • $true: os destinatários podem usar uma senha única para exibir mensagens criptografadas. Esse é o valor padrão.
  • $false: os destinatários não podem usar uma senha única para exibir mensagens criptografadas. O destinatário é obrigado a entrar usando uma conta de trabalho ou de estudante Microsoft 365.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-PortalText

O parâmetro PortalText especifica o texto que aparece na parte superior do portal de exibição de email criptografado. O comprimento máximo é de 128 caracteres. 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

-PrivacyStatementUrl

{{ Preencher PrivacyStatementUrl Description }}

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

-ReadButtonText

O parâmetro ReadButtonText especifica o texto que aparece no botão "Mensagem de Leitura". 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

-SocialIdSignIn

O parâmetro SocialIdSignIn especifica se um usuário tem permissão para exibir uma mensagem criptografada no Centro de administração do Microsoft 365 usando sua própria ID de rede social (Google, Yahoo etc.). Os valores válidos são:

  • $true: a entrada da ID da rede social é permitida. Esse é o valor padrão.
  • $false: A entrada da ID da rede social não é permitida. Se o destinatário pode usar uma senha única ou sua Microsoft conta de trabalho ou de estudante 365 é controlada pelo parâmetro OTPEnabled.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-WhatIf

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

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