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.
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, 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 define os valores especificados para a configuração padrão do OME chamada "Configuração do OME".
Parâmetros
-BackgroundColor
Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais
O parâmetro BackgroundColor especifica a cor da tela 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 valor é o padrã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, complemento de segurança interno para caixas de correio locais
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer 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 reconhecer o comando antes de continuar.
Este cmdlet tem uma pausa interna, portanto, use -Confirm:$false para ignorar a confirmação.
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, complemento de segurança interno para caixas de correio locais
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, complemento de segurança interno para caixas de correio locais
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
Esse parâmetro está disponível apenas com uma assinatura da Criptografia Avançada de Mensagens do Microsoft 365.
O parâmetro ExternalMailExpiryInDays especifica o número de dias em que a mensagem criptografada 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 é possível atualizar o valor desse parâmetro na configuração padrão do OME. 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.
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, complemento de segurança interno para caixas de correio locais
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, complemento de segurança interno para caixas de correio locais
O parâmetro Image identifica e carrega uma imagem a 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 byte usando a seguinte sintaxe: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Você pode usar esse comando como o valor do parâmetro ou pode 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.
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, complemento de segurança interno para caixas de correio locais
O parâmetro IntroductionText especifica o texto que aparece ao lado do nome e do endereço de email 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, complemento de segurança interno para caixas de correio locais
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 valor é o padrão.
- $false: Os destinatários não podem usar uma senha única para exibir mensagens criptografadas. O destinatário deve entrar usando uma conta corporativa ou de estudante 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, complemento de segurança interno para caixas de correio locais
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, complemento de segurança interno para caixas de correio locais
O parâmetro PrivacyStatementUrl especifica o link da Política de Privacidade na mensagem de notificação de email criptografada.
Se você não usar esse parâmetro, o link Política de Privacidade vai para a política de privacidade padrão 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, complemento de segurança interno para caixas de correio locais
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, complemento de segurança interno para caixas de correio locais
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 (conta do Google, Yahoo e Microsoft). Os valores válidos são:
- $true: ID de rede social é permitido. Esse valor é o padrão.
- $false: ID de rede social não é permitido. Se o destinatário pode usar uma senha única ou se sua conta corporativa ou de estudante do Microsoft 365 é controlado pelo parâmetro OTPEnabled.
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, complemento de segurança interno para caixas de correio locais
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 dá suporte aos 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.