Set-OMEConfiguration
Esse cmdlet só está disponível no serviço baseado em nuvem.
Utilize 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.
Sintaxe
Default (Default)
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 artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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 predefinida denominada "Configuração OME".
Parâmetros
-BackgroundColor
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
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 cores de fundo. - $null (em branco). Este valor é a predefinição.
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 |
-Confirm
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
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, 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 confirmar 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 |
-DisclaimerText
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
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.
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 |
-EmailText
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
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.
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 |
-ExternalMailExpiryInDays
Aplicável: Exchange Online
Este parâmetro só está disponível com uma subscrição do Microsoft 365 Advanced Message Encryption.
O parâmetro ExternalMailExpiryInDays especifica o número de dias em que a mensagem encriptada está disponível para destinatários externos no portal do Microsoft 365. Um valor válido é um número inteiro de 0 a 730. O valor 0 significa que as mensagens nunca expiram. O valor padrão é 0.
Não pode atualizar o valor deste parâmetro na configuração OME predefinida. Só pode modificar este valor numa configuração personalizada.
Na saída do cmdlet Get-OMEConfiguration, o valor deste parâmetro é apresentado na propriedade ExternalMailExpiryInterval.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Int32
| 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, Suplemento de segurança incorporado para caixas de correio no local
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".
Propriedades do parâmetro
| Tipo: | OMEConfigurationIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Image
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro Imagem identifica e carrega uma imagem a apresentar na mensagem de e-mail e no Centro de administração do Microsoft 365.
Um valor válido para este parâmetro requer que leia o ficheiro para um objeto codificado por bytes com a seguinte sintaxe: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Pode utilizar este comando como o valor do parâmetro ou escrever a saída numa variável ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) e utilizar 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.
Propriedades do parâmetro
| Tipo: | Byte[] |
| 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 |
-IntroductionText
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro IntroductionText especifica o texto que aparece junto ao nome e endereço de e-mail do remetente. 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.
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 |
-OTPEnabled
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
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 utilizar um código de acesso único para ver mensagens encriptadas. Este valor é a predefinição.
- $false: os destinatários não podem utilizar um código de acesso único para ver mensagens encriptadas. O destinatário tem de iniciar sessão com uma conta escolar ou profissional do Microsoft 365.
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 |
-PortalText
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
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.
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 |
-PrivacyStatementUrl
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro PrivacyStatementUrl especifica a ligação Declaração de Privacidade na mensagem de notificação por e-mail encriptada.
Se não utilizar este parâmetro, a ligação Declaração de Privacidade será adicionada à declaração de privacidade predefinida da Microsoft.
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 |
-ReadButtonText
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
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.
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 |
-SocialIdSignIn
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro SocialIdSignIn especifica se um utilizador tem permissão para ver uma mensagem encriptada no Centro de administração do Microsoft 365 utilizando o seu próprio ID de rede social (Google, Yahoo e conta Microsoft). Os valores válidos são:
- $true: o início de sessão de ID de rede social é permitido. Este valor é a predefinição.
- $false: O início de sessão no ID da rede social não é permitido. O parâmetro OTPEnabled controla se o destinatário pode utilizar um código de acesso único ou a respetiva conta escolar ou profissional do Microsoft 365.
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 |
-WhatIf
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
Esse parâmetro está reservado para uso interno da Microsoft.
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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
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.