Compartilhar via


Set-OMEConfiguration

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

Use o cmdlet Set-OMEConfiguration para configurar 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

Set-OMEConfiguration
   [-Identity] <OMEConfigurationIdParameter>
   [-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

Set-OMEConfiguration -Identity "OME Configuration" -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 configura os valores especificados para a configuração OME padrão chamada "Configuração de OME".

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 HTML (#RRGGBB) entre aspas. Por exemplo, "#FFFFFF" é branco.
  • Um valor de nome de cor válido. Por exemplo, yellow é #ffff00. Para obter uma lista dos nomes de cores válidos, consulte Referência de cor de fundo.
  • $null (em branco). Esse é o valor padrão.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-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

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

Para remover o texto existente e usar o valor padrão, use o valor $null para esse parâmetro.

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

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

Para remover o texto existente e usar o valor padrão, use o valor $null para esse parâmetro.

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

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

Você não pode atualizar o valor desse parâmetro na configuração OME padrão. Você só pode modificar esse valor em uma configuração personalizada.

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 a configuração do OME que você deseja modificar. A configuração padrão do OME tem o valor de identidade "OME Configuration".

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

-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

Para remover uma imagem existente e usar a imagem padrão, use o valor $null para esse parâmetro.

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

-IntroductionText

O parâmetro IntroductionText especifica o texto que aparece ao lado do nome do remetente e do endereço de email. Se o valor contiver espaços, coloque-o entre aspas (").

Para remover o texto existente e usar o valor padrão, use o valor $null para esse parâmetro.

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

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

-PortalText

O parâmetro PortalText especifica o texto que aparece na parte superior do portal de exibição de emails criptografados. O comprimento máximo é de 128 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Para remover o texto existente e usar o valor padrão, use o valor $null para esse parâmetro.

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

-PrivacyStatementUrl

O parâmetro PrivacyStatementUrl especifica o link Da Instrução de Privacidade na mensagem de notificação de email criptografada.

Se você não usar esse parâmetro, o link da Instrução de Privacidade irá para a instrução padrão Microsoft privacidade.

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

-ReadButtonText

O parâmetro ReadButtonText especifica o texto que aparece no botão "Ler a mensagem". Se o valor contiver espaços, coloque-o entre aspas (").

Para remover o texto existente e usar o valor padrão, use o valor $null para esse parâmetro.

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

-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 e Microsoft conta). 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, Exchange Online Protection

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

Entradas

Input types

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Saídas

Output types

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.