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.