New-OMEConfiguration
Esse cmdlet só está disponível no serviço baseado em nuvem.
Utilize 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.
Sintaxe
Default (Padrão)
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 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
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 OME denominada "Contoso Marketing" com os valores especificados. Os parâmetros não utilizados obtêm os valores predefinidos.
Parâmetros
-BackgroundColor
Aplicável: Exchange Online
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) html disponível (por exemplo,
0x000000é branco). - Um valor de texto disponível (por exemplo,
yellowé 0x00FFFF00). - $null (em branco). Este valor é a predefinição.
Para obter mais informações, confira Adicionar a marca da sua organização às suas mensagens criptografadas.
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
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: | 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
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 (").
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
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 (").
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.
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
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 (").
Propriedades do parâmetro
| Tipo: | OrganizationIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Image
Aplicável: Exchange Online
O parâmetro Imagem identifica e carrega uma imagem que é apresentada 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
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
O parâmetro IntroductionText especifica o texto predefinido que acompanha as mensagens de e-mail encriptadas. O texto predefinido é apresentado abaixo do endereço de e-mail do destinatário para ver a mensagem encriptada. Se o valor contiver espaços, coloque-o entre aspas (").
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
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
O parâmetro PortalText especifica o texto que aparece na parte superior do portal de visualização de e-mail encriptado. O comprimento máximo é de 128 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").
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
{{ Fill PrivacyStatementUrl Description }}
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
O parâmetro ReadButtonText especifica o texto que aparece no botão "Ler Mensagem". Se o valor contiver espaços, coloque-o entre aspas (").
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
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, etc.). 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
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.