Set-CMEmailProfile

  • Referencia
Módulo:
ConfigurationManager

Establece un perfil de correo electrónico.

Sintaxis

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

El cmdlet Set-CMEmailProfile actualiza la configuración de un perfil de correo electrónico de Exchange ActiveSync.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Actualización de un perfil por nombre

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

Este comando actualiza el nombre del perfil de correo electrónico de Exchange ActiveSync de EmailProfile1 a newEmailProfile1.

Ejemplo 2: Actualización de un perfil por identificador

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

Este comando actualiza el nombre del perfil de correo electrónico de Exchange ActiveSync con el identificador de 16795654 a newEmailProfile2.

Ejemplo 3: Actualización de un perfil como un objeto de entrada

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

El primer comando obtiene el objeto de perfil de correo electrónico de Exchange ActiveSync denominado EmailProfile3 y almacena el objeto en la variable $EmailProfile.

El segundo comando cambia el nombre del perfil de correo electrónico almacenado en $EmailProfile a newEmailProfile3.

Ejemplo 4: Uso de la canalización para actualizar un perfil

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

Este comando obtiene el objeto de perfil de correo electrónico de Exchange ActiveSync denominado EmailProfile4 y usa el operador de canalización para pasar el objeto a Set-CMEmailProfile, que cambia el nombre del objeto de perfil de correo electrónico a newEmailProfile4.

Parámetros

-AccountDomainActiveDirectory

Especifica el tipo de dominio de cuenta de Active Directory. Los valores admitidos son:

  • domain
  • ntdomain
Tipo:String
Valores aceptados:domain, ntdomain
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AccountDomainCustom

Especifica un dominio de cuenta personalizado. Este parámetro solo se puede usar si se especifica el valor sAMAccountName para el parámetro AccountUserNameType .

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AccountName

Especifica el nombre para mostrar de la cuenta de correo electrónico.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AccountUserNameType

Especifica un tipo de nombre de usuario de cuenta. Los valores admitidos son:

  • mail
  • sAMAccountName
  • userPrincipalName
Tipo:String
Valores aceptados:mail, sAMAccountName, userPrincipalName
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AllowMessageMove

Indique si los usuarios pueden mover mensajes de correo electrónico entre las distintas cuentas que han configurado en su dispositivo.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AllowThirdPartyApplication

Indica si los usuarios pueden enviar correo electrónico desde determinadas aplicaciones de correo electrónico de terceros no predeterminadas.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Description

Especifica una descripción para el perfil de correo electrónico de Exchange ActiveSync.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EmailAddressType

Especifica un tipo de dirección de correo electrónico. Los valores admitidos son:

  • mail
  • userPrincipalName
Tipo:String
Valores aceptados:mail, userPrincipalName
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EnableSmime

Indica si el correo electrónico saliente se envía mediante el cifrado S/MIME.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Id

Especifica el CI_ID de un perfil de correo electrónico de Exchange ActiveSync.

Tipo:Int32
Alias:CI_ID, CIId
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IdentityCertificate

Especifica un objeto de certificado de identidad. Para obtener un objeto de certificado de identidad, use el cmdlet Get-CMConfigurationPolicy.

Tipo:IResultObject
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

Especifica un objeto de perfil de correo electrónico de Exchange ActiveSync. Para obtener un objeto de perfil de correo electrónico, use la función Get-CMEmailProfile.

Tipo:IResultObject
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-MailSyncDays

Especifica el número de días de correo electrónico que se van a sincronizar. Los valores admitidos son:

  • Ilimitado
  • OneDay
  • Tres días
  • OneWeek
  • TwoWeeks
  • OneMonth
Tipo:MailNumberofDaysToSync
Valores aceptados:Unlimited, OneDay, ThreeDays, OneWeek, TwoWeeks, OneMonth
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifica el nombre de un perfil de correo electrónico de Exchange ActiveSync.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NewName

Especifica un nuevo nombre para un perfil de correo electrónico de Exchange ActiveSync.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PassThru

Agregue este parámetro para devolver un objeto que represente el elemento con el que está trabajando. De forma predeterminada, este cmdlet no puede generar ninguna salida.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SigningCertificate

Especifica un objeto de certificado de firma usado para la firma S/MIME. Para obtener un objeto de certificado de firma, use el cmdlet Get-CMConfigurationPolicy.

Tipo:IResultObject
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SupportedPlatform

Especifica los sistemas operativos en los que se instalará el perfil de correo electrónico. Para obtener un objeto de plataforma compatible, use el cmdlet Get-CMSupportedPlatform.

Tipo:IResultObject[]
Alias:SupportedPlatforms
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SyncContentType

Especifica un tipo de contenido que se va a sincronizar con los dispositivos. Los valores admitidos son:

  • Ninguno
  • Correo electrónico
  • Contactos
  • Calendario
  • Tareas
  • Notas
  • todas
Tipo:EasProfileSyncContentType
Alias:SyncContentTypes
Valores aceptados:None, Email, Contacts, Calendar, Tasks, Notes, All
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SynchronizeRecentlyUsed

Indica si se sincroniza la lista de direcciones de correo electrónico que se han usado recientemente en el dispositivo.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SyncSchedule

Especifica la programación por la que los dispositivos sincronizarán los datos de Exchange Server.

  • Manual
  • Quincemins
  • ThirtyMins
  • SixtyMins
  • AsArrive
Tipo:Schedule
Valores aceptados:Manual, FifteenMins, ThirtyMins, SixtyMins, AsArrive
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UseSsl

Indica si se usa la comunicación capa de sockets seguros (SSL) al enviar correos electrónicos, recibir correos electrónicos y comunicarse con Exchange Server.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object