Set-CMEmailProfile
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:
- 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:
- 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
- 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