Compartilhar via

Set-CMEmailProfile

  • Referência
Módulo:
ConfigurationManager

Define um perfil de e-mail.

Sintaxe

Set-CMEmailProfile
   [-AccountDomainActiveDirectory <String>]
   [-AccountDomainCustom <String>]
   [-AccountName <String>]
   [-AccountUserNameType <String>]
   [-AllowMessageMove <Boolean>]
   [-AllowThirdPartyApplication <Boolean>]
   [-Description <String>]
   [-EmailAddressType <String>]
   [-EnableSmime <Boolean>]
   [-IdentityCertificate <IResultObject>]
   -InputObject <IResultObject>
   [-MailSyncDays <MailNumberofDaysToSync>]
   [-NewName <String>]
   [-PassThru]
   [-SigningCertificate <IResultObject>]
   [-SupportedPlatform <IResultObject[]>]
   [-SyncContentType <EasProfileSyncContentType>]
   [-SynchronizeRecentlyUsed <Boolean>]
   [-SyncSchedule <Schedule>]
   [-UseSsl <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMEmailProfile
   [-AccountDomainActiveDirectory <String>]
   [-AccountDomainCustom <String>]
   [-AccountName <String>]
   [-AccountUserNameType <String>]
   [-AllowMessageMove <Boolean>]
   [-AllowThirdPartyApplication <Boolean>]
   [-Description <String>]
   [-EmailAddressType <String>]
   [-EnableSmime <Boolean>]
   -Id <Int32>
   [-IdentityCertificate <IResultObject>]
   [-MailSyncDays <MailNumberofDaysToSync>]
   [-NewName <String>]
   [-PassThru]
   [-SigningCertificate <IResultObject>]
   [-SupportedPlatform <IResultObject[]>]
   [-SyncContentType <EasProfileSyncContentType>]
   [-SynchronizeRecentlyUsed <Boolean>]
   [-SyncSchedule <Schedule>]
   [-UseSsl <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMEmailProfile
   [-AccountDomainActiveDirectory <String>]
   [-AccountDomainCustom <String>]
   [-AccountName <String>]
   [-AccountUserNameType <String>]
   [-AllowMessageMove <Boolean>]
   [-AllowThirdPartyApplication <Boolean>]
   [-Description <String>]
   [-EmailAddressType <String>]
   [-EnableSmime <Boolean>]
   [-IdentityCertificate <IResultObject>]
   [-MailSyncDays <MailNumberofDaysToSync>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-SigningCertificate <IResultObject>]
   [-SupportedPlatform <IResultObject[]>]
   [-SyncContentType <EasProfileSyncContentType>]
   [-SynchronizeRecentlyUsed <Boolean>]
   [-SyncSchedule <Schedule>]
   [-UseSsl <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-CMEmailProfile atualiza as definições de 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: Atualizar um perfil por nome

PS XYZ:\> Set-CMEmailProfile -Name "EmailProfile1" -NewName "newEmailProfile1"

Este comando atualiza o nome do perfil de e-mail do Exchange ActiveSync de EmailProfile1 para newEmailProfile1.

Exemplo 2: Atualizar um perfil por ID

PS XYZ:\> Set-CMEmailProfile -Id 16795654 -NewName "newEmailProfile2"

Este comando atualiza o nome do perfil de e-mail do Exchange ActiveSync com o ID de 16795654 para newEmailProfile2.

Exemplo 3: Atualizar um perfil como um objeto de entrada

PS XYZ:\> $EmailProfile = Get-CMEmailProfile -Name "EmailProfile3"
PS XYZ:\> Set-CMEmailProfile -InputObject $EmailProfile -NewName "newEmailProfile3"

O primeiro comando obtém o objeto de perfil de e-mail do Exchange ActiveSync com o nome EmailProfile3 e armazena o objeto na variável $EmailProfile.

O segundo comando altera o nome do perfil de e-mail armazenado no $EmailProfile para newEmailProfile3.

Exemplo 4: Utilizar o pipeline para atualizar um perfil

PS XYZ:\> Get-CMEmailProfile -Name "EmailProfile4" | Set-CMEmailProfile -NewName "newEmailProfile4"

Este comando obtém o objeto de perfil de e-mail do Exchange ActiveSync denominado EmailProfile4 e utiliza o operador de pipeline para transmitir o objeto para Set-CMEmailProfile, que altera o nome do objeto de perfil de e-mail para newEmailProfile4.

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:False
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

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

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

-AllowThirdPartyApplication

Indica se 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:Boolean
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

-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 se o e-mail enviado é enviado através da encriptação S/MIME.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
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

-Id

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

Tipo:Int32
Aliases:CI_ID, CIId
Cargo:Named
Valor padrão:None
Obrigatório:True
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

-InputObject

Especifica um objeto de perfil de e-mail do Exchange ActiveSync. Para obter um objeto de perfil de e-mail, utilize a função Get-CMEmailProfile.

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
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 o nome de um 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

-NewName

Especifica um novo nome para um 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

-PassThru

Adicione este parâmetro para devolver um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
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:False
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 se a lista de endereços de e-mail que foram utilizados recentemente no dispositivo está sincronizada.

Tipo:Boolean
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

-UseSsl

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

Tipo:Boolean
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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object