Set-CMEmailProfile
Establece un perfil de correo electrónico.
Syntax
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 Exchange ActiveSync.
Nota:
Ejecute cmdlets de Configuration Manager desde la unidad de sitio Configuration Manager, por ejemploPS 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 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 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 Exchange ActiveSync objeto de perfil de correo electrónico 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 Exchange ActiveSync objeto de perfil de correo electrónico 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
| Type: | String |
| Accepted values: | domain, ntdomain |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AccountName
Especifica el nombre para mostrar de la cuenta de correo electrónico.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AccountUserNameType
Especifica un tipo de nombre de usuario de cuenta. Los valores admitidos son:
- 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
Indique si los usuarios pueden mover mensajes de correo electrónico entre las distintas cuentas que han configurado en su dispositivo.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowThirdPartyApplication
Indica si los usuarios pueden enviar correo electrónico desde determinadas aplicaciones de correo electrónico de terceros no predeterminadas.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Especifica una descripción para el perfil de correo electrónico Exchange ActiveSync.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EmailAddressType
Especifica un tipo de dirección de correo electrónico. Los valores admitidos son:
- userPrincipalName
| Type: | String |
| Accepted values: | mail, userPrincipalName |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableSmime
Indica si el correo electrónico saliente se envía mediante el cifrado S/MIME.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Id
Especifica el CI_ID de un perfil de correo electrónico de Exchange ActiveSync.
| Type: | Int32 |
| Aliases: | CI_ID, CIId |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IdentityCertificate
Especifica un objeto de certificado de identidad. Para obtener un objeto de certificado de identidad, use el cmdlet Get-CMConfigurationPolicy.
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Especifica un Exchange ActiveSync objeto de perfil de correo electrónico. Para obtener un objeto de perfil de correo electrónico, use la función Get-CMEmailProfile.
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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
| 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 el nombre de un perfil de correo electrónico Exchange ActiveSync.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NewName
Especifica un nuevo nombre para un perfil de correo electrónico de Exchange ActiveSync.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | IResultObject[] |
| Aliases: | SupportedPlatforms |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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
| 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 si se sincroniza la lista de direcciones de correo electrónico que se han usado recientemente en el dispositivo.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SyncSchedule
Especifica la programación por la que los dispositivos sincronizarán los datos de la Exchange Server.
- Manual
- Quincemins
- ThirtyMins
- SixtyMins
- 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 |
-UseSsl
Indica si se usa la comunicación de capa de sockets seguros (SSL) al enviar correos electrónicos, recibir correos electrónicos y comunicarse con el Exchange Server.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Salidas
System.Object
Vínculos relacionados
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de