Set-CMEmailProfile

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

Vínculos relacionados

• Get-CMConfigurationPolicy
• Get-CMEmailProfile
• Get-CMSupportedPlatform
• New-CMEmailProfile