New-OMEConfiguration
Esse cmdlet só está disponível no serviço baseado em nuvem.
Use 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.
Syntax
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 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
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 de OME chamada "Contoso Marketing" com os valores especificados. Parâmetros não utilizados obtêm os valores padrão.
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 (hex triplet) disponível (por exemplo,
0x000000é branco). - Um valor de texto disponível (por exemplo,
yellowé 0x00FFFF00). - $null (em branco). Esse é o valor padrão.
Para obter mais informações, confira Adicionar a marca da sua organização às suas mensagens criptografadas.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Confirm
Esse parâmetro está reservado para uso interno da Microsoft.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-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 (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-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 (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-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.
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 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 (").
| Type: | OrganizationIdParameter |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-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
| Type: | Byte[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-IntroductionText
O parâmetro IntroductionText especifica o texto padrão que acompanha mensagens de email criptografadas. O texto padrão aparece abaixo do endereço de email do destinatário para exibir a mensagem criptografada. Se o valor contiver espaços, coloque-o entre aspas (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-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 |
-PortalText
O parâmetro PortalText especifica o texto que aparece na parte superior do portal de exibição de email criptografado. O comprimento máximo é de 128 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-PrivacyStatementUrl
{{ Preencher PrivacyStatementUrl Description }}
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ReadButtonText
O parâmetro ReadButtonText especifica o texto que aparece no botão "Mensagem de Leitura". Se o valor contiver espaços, coloque-o entre aspas (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-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 etc.). 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 |
-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 |
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários