Compartilhar via

New-CMEmailProfile

  • Referência
Módulo:
ConfigurationManager

Cria um perfil de e-mail.

Sintaxe

New-CMEmailProfile
   [-AccountDomainActiveDirectory <String>]
   [-AccountDomainCustom <String>]
   -AccountName <String>
   [-AccountUserNameType <String>]
   [-AllowMessageMove]
   [-AllowThirdPartyApplication]
   [-Description <String>]
   [-DoNotUseSsl]
   [-EmailAddressType <String>]
   [-EnableSmime]
   -ExchangeHost <String>
   [-IdentityCertificate <IResultObject>]
   [-MailSyncDays <MailNumberofDaysToSync>]
   -Name <String>
   [-SigningCertificate <IResultObject>]
   -SupportedPlatform <IResultObject[]>
   [-SyncContentType <EasProfileSyncContentType>]
   [-SynchronizeRecentlyUsed]
   [-SyncSchedule <Schedule>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet New-CMEmailProfile cria um perfil de e-mail do Exchange ActiveSync.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Criar um perfil de e-mail

PS XYZ:\> $Platform = Get-CMSupportedPlatform -Fast -Platform "Windows Phone"
PS XYZ:\> New-CMEmailProfile -AccountName "TestAccount1" -ExchangeHost "TestHost1" -Name "EmailProfile01" -SupportedPlatform $Platform[1] -AccountUserNameType sAMAccountName -AccountDomainActiveDirectory domain

O primeiro comando obtém todos os objetos de plataforma suportados para o Windows Phone e armazena os objetos na variável $Platform.

O segundo comando cria um e-mail com o nome EmailProfile01 com o segundo objeto de plataforma suportado do $Platform.

Parâmetros

-AccountDomainActiveDirectory

Especifica o tipo de domínio de conta do Active Directory. Os valores válidos são:

  • domínio
  • ntdomain
Tipo:String
Valores aceitos:domain, ntdomain
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AccountDomainCustom

Especifica um domínio de conta personalizado. Este parâmetro só pode ser utilizado se o valor sAMAccountName for especificado para o parâmetro AccountUserNameType .

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AccountName

Especifica o nome a apresentar da conta de e-mail.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AccountUserNameType

Especifica um tipo de nome de utilizador de conta. Os valores válidos são:

  • Email
  • sAMAccountName
  • userPrincipalName
Tipo:String
Valores aceitos:mail, sAMAccountName, userPrincipalName
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AllowMessageMove

Indica que os utilizadores têm permissão para mover mensagens de e-mail entre contas diferentes que tenham configurado no respetivo dispositivo.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AllowThirdPartyApplication

Indica que os utilizadores têm permissão para enviar e-mails a partir de determinadas aplicações de e-mail de terceiros não predefinidas.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Description

Especifica uma descrição para o perfil de e-mail do Exchange ActiveSync.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DoNotUseSsl

Indica que a comunicação SSL (Secure Sockets Layer) não é utilizada ao enviar e-mails, receber e-mails e comunicar com o Exchange Server.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EmailAddressType

Especifica um tipo de endereço de e-mail. Os valores válidos são:

  • Email
  • userPrincipalName
Tipo:String
Valores aceitos:mail, userPrincipalName
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableSmime

Indica que o e-mail a enviar é enviado através da encriptação S/MIME.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ExchangeHost

Especifica o nome do anfitrião do servidor Exchange que aloja os serviços do Exchange ActiveSync.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IdentityCertificate

Especifica um objeto de certificado de identidade. Para obter um objeto de certificado de identidade, utilize o cmdlet Get-CMConfigurationPolicy.

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MailSyncDays

Especifica o número de dias de e-mail a sincronizar. Os valores válidos são:

  • Ilimitado
  • OneDay
  • Três Dias
  • OneWeek
  • TwoWeeks
  • OneMonth
Tipo:MailNumberofDaysToSync
Valores aceitos:Unlimited, OneDay, ThreeDays, OneWeek, TwoWeeks, OneMonth
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica um nome para o perfil de e-mail do Exchange ActiveSync.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SigningCertificate

Especifica um objeto de certificado de assinatura utilizado para assinatura S/MIME. Para obter um objeto de certificado de assinatura, utilize o cmdlet Get-CMConfigurationPolicy.

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SupportedPlatform

Especifica os sistemas operativos nos quais o perfil de e-mail será instalado. Para obter um objeto de plataforma suportado, utilize o cmdlet Get-CMSupportedPlatform.

Tipo:IResultObject[]
Aliases:SupportedPlatforms
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SyncContentType

Especifica um tipo de conteúdo para sincronizar com os dispositivos. Os valores válidos são:

  • Nenhum
  • Email
  • Contatos
  • Calendário
  • Tarefas
  • Notas
  • Todos
Tipo:EasProfileSyncContentType
Aliases:SyncContentTypes
Valores aceitos:None, Email, Contacts, Calendar, Tasks, Notes, All
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SynchronizeRecentlyUsed

Indica que a lista de endereços de e-mail que foram utilizados recentemente no dispositivo está sincronizada.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SyncSchedule

Especifica a agenda através da qual os dispositivos irão sincronizar os dados do Exchange Server.

  • Manual
  • Quinze Administradores
  • Trinta Minutos
  • SessentaMins
  • AsArrive
Tipo:Schedule
Valores aceitos:Manual, FifteenMins, ThirtyMins, SixtyMins, AsArrive
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

IResultObject