Share via

New-CMEmailProfile

  • Referência
Módulo:
ConfigurationManager

Cria um perfil de email.

Syntax

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 email Exchange ActiveSync.

Observação

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

Exemplos

Exemplo 1: criar um perfil de email

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 com suporte para Windows Phone e armazena os objetos na variável $Platform.

O segundo comando cria um email chamado EmailProfile01 usando o segundo objeto de plataforma com suporte do $Platform.

Parâmetros

-AccountDomainActiveDirectory

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

  • domínio
  • ntdomain
Type:String
Accepted values:domain, ntdomain
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AccountDomainCustom

Especifica um domínio de conta personalizada. Esse parâmetro só poderá ser usado se o valor sAMAccountName for especificado para o parâmetro AccountUserNameType .

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AccountName

Especifica o nome de exibição da conta de email.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AccountUserNameType

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

  • Email
  • Samaccountname
  • userPrincipalName
Type:String
Accepted values:mail, sAMAccountName, userPrincipalName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowMessageMove

Indica que os usuários podem mover mensagens de email entre diferentes contas configuradas em seu dispositivo.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowThirdPartyApplication

Indica que os usuários podem enviar email de determinados aplicativos de email de terceiros não padrão.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Especifica uma descrição do perfil de email Exchange ActiveSync.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DoNotUseSsl

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EmailAddressType

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

  • Email
  • userPrincipalName
Type:String
Accepted values:mail, userPrincipalName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableSmime

Indica que o email de saída é enviado usando criptografia S/MIME.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExchangeHost

Especifica o nome do host do servidor exchange que hospeda serviços Exchange ActiveSync.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IdentityCertificate

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

Type:IResultObject
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MailSyncDays

Especifica o número de dias de email a serem sincronizados. Os valores válidos são:

  • Ilimitado
  • OneDay
  • ThreeDays
  • OneWeek
  • TwoWeeks
  • OneMonth
Type:MailNumberofDaysToSync
Accepted values:Unlimited, OneDay, ThreeDays, OneWeek, TwoWeeks, OneMonth
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica um nome para o perfil de email Exchange ActiveSync.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SigningCertificate

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

Type:IResultObject
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SupportedPlatform

Especifica os sistemas operacionais nos quais o perfil de email será instalado. Para obter um objeto de plataforma com suporte, use o cmdlet Get-CMSupportedPlatform.

Type:IResultObject[]
Aliases:SupportedPlatforms
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SyncContentType

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

  • Nenhum
  • Email
  • Contatos
  • Calendário
  • Tarefas
  • Observações
  • Todas
Type:EasProfileSyncContentType
Aliases:SyncContentTypes
Accepted values:None, Email, Contacts, Calendar, Tasks, Notes, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SynchronizeRecentlyUsed

Indica que a lista de endereços de email que foram usados recentemente no dispositivo está sincronizada.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SyncSchedule

Especifica o cronograma pelo qual os dispositivos sincronizarão os dados do Exchange Server.

  • Manual
  • QuinzeMins
  • TrintaMins
  • SessentaMins
  • AsArrive
Type:Schedule
Accepted values:Manual, FifteenMins, ThirtyMins, SixtyMins, AsArrive
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

Saídas

IResultObject