Set-CMEmailProfile
Define um perfil de email.
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 configurações de um perfil de email Exchange ActiveSync.
Observação
Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>
. Para obter mais informações, confira 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 email Exchange ActiveSync do 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 email Exchange ActiveSync com a 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 email Exchange ActiveSync chamado EmailProfile3 e armazena o objeto na variável $EmailProfile.
O segundo comando altera o nome do perfil de email armazenado em $EmailProfile para newEmailProfile3.
Exemplo 4: use o pipeline para atualizar um perfil
PS XYZ:\> Get-CMEmailProfile -Name "EmailProfile4" | Set-CMEmailProfile -NewName "newEmailProfile4"
Esse comando obtém o objeto de perfil de email Exchange ActiveSync chamado EmailProfile4 e usa o operador de pipeline para passar o objeto para Set-CMEmailProfile, que altera o nome do objeto de perfil de email para newEmailProfile4.
Parâmetros
-AccountDomainActiveDirectory
Especifica o tipo de domínio da 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 personalizada. Esse parâmetro só poderá ser usado 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 de exibição da conta de email.
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 usuário da 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 usuários têm permissão para mover mensagens de email entre contas diferentes configuradas em seu 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 usuários podem enviar email de determinados aplicativos de email não padrão e de terceiros.
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 do perfil de email Exchange ActiveSync.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DisableWildcardHandling
Esse parâmetro trata caracteres curinga como valores de caractere literal. Você 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 email. 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 email de saída é enviado usando criptografia S/MIME.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ForceWildcardHandling
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você 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 email 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, use 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 email Exchange ActiveSync. Para obter um objeto de perfil de email, use 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 email a serem sincronizados. Os valores válidos são:
- Ilimitado
- OneDay
- ThreeDays
- 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 email 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 email 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 esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma 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 usado para assinatura S/MIME. Para obter um objeto de certificado de assinatura, use 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 operacionais nos quais o perfil de email será instalado. Para obter um objeto de plataforma com suporte, use 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 dispositivos. Os valores válidos são:
- Nenhum
- Contatos
- Calendário
- Tarefas
- Observações
- Todas
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 email que foram usados 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 o cronograma pelo qual os dispositivos sincronizarão os dados do Exchange Server.
- Manual
- QuinzeMins
- TrintaMins
- 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) é usada ao enviar emails, receber emails e se 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
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de