Set-CMEmailProfile
SYNOPSIS
Define um perfil de e-mail.
SYNTAX
ByValue (Padrão)
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>]
ById
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>]
ByName
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 Exchange ActiveSync.
Nota
Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.
EXAMPLES
Exemplo 1: Atualizar um perfil pelo nome
PS XYZ:\> Set-CMEmailProfile -Name "EmailProfile1" -NewName "newEmailProfile1"
Este comando atualiza o nome do Exchange ActiveSync perfil de e-mail do EmailProfile1 para o 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 Exchange ActiveSync com o ID de 16795654 para o 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 Exchange ActiveSync chamado EmailProfile3 e armazena o objeto na variável $EmailProfile.
O segundo comando altera o nome do perfil de e-mail armazenado em $EmailProfile para o newEmailProfile3.
Exemplo 4: Utilize o pipeline para atualizar um perfil
PS XYZ:\> Get-CMEmailProfile -Name "EmailProfile4" | Set-CMEmailProfile -NewName "newEmailProfile4"
Este comando obtém o Exchange ActiveSync objeto de perfil de e-mail chamado EmailProfile4 e utiliza o operador do pipeline para passar o objeto para Set-CMEmailProfile, que altera o nome do objeto de perfil de e-mail para o novo EmailMailProfile4.
PARAMETERS
-AccountDomainActiveDirectory
Especifica o tipo de domínio de conta ative diretoria. Os valores válidos são:
- domínio
- ntdomain
Type: String
Parameter Sets: (All)
Aliases:
Accepted values: domain, ntdomain
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: 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.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Nome da conta
Especifica o nome de exibição para a conta de e-mail.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AccountUserNameType
Especifica um tipo de nome de utilizador de conta. Os valores válidos são:
- correio
- sAMAccountName
- userPrincipalName
Type: String
Parameter Sets: (All)
Aliases:
Accepted values: mail, sAMAccountName, userPrincipalName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Permitir AMessageMove
Indique se os utilizadores estão autorizados a mover mensagens de correio eletrónico entre diferentes contas que configuraram no seu dispositivo.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AllowThirdPartyApplication
Indica se os utilizadores estão autorizados a enviar e-mails de determinadas aplicações de e-mail não padrão, de terceiros.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Descrição
Especifica uma descrição para o perfil de e-mail Exchange ActiveSync.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EmailAddressType
Especifica um tipo de endereço de e-mail. Os valores válidos são:
- correio
- userPrincipalName
Type: String
Parameter Sets: (All)
Aliases:
Accepted values: mail, userPrincipalName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Ativar AMime
Indica se o e-mail de saída é enviado usando encriptação S/MIME.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- ID
Especifica a CI_ID para um perfil de e-mail Exchange ActiveSync.
Type: Int32
Parameter Sets: ById
Aliases: CI_ID, CIId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Certificado de Identidade
Especifica um objeto de certificado de identidade. Para obter um objeto de certificado de identidade, utilize o Get-CMConfigurationPolicy cmdlet.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Especifica um objeto de perfil de e-mail Exchange ActiveSync. Para obter um objeto de perfil de e-mail, utilize a função Get-CMEmailProfile.
Type: IResultObject
Parameter Sets: ByValue
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-MailSyncDays
Especifica o número de dias de e-mail para sincronizar. Os valores válidos são:
- Ilimitado
- OneDay
- Três Dias
- OneWeek
- Duas Semanas
- OneMonth
Type: MailNumberofDaysToSync
Parameter Sets: (All)
Aliases:
Accepted values: Unlimited, OneDay, ThreeDays, OneWeek, TwoWeeks, OneMonth
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Especifica o nome de um perfil de e-mail Exchange ActiveSync.
Type: String
Parameter Sets: ByName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Novo Nome
Especifica um novo nome para um perfil de e-mail Exchange ActiveSync.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- PassThru
Adicione este parâmetro para devolver um objeto que represente o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AssinaturaCertificada
Especifica um objeto de certificado de assinatura utilizado para a assinatura S/MIME. Para obter um objeto de certificado de assinatura, utilize o Get-CMConfigurationPolicy cmdlet.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SuportadoPlatform
Especifica os sistemas operativos nos quais o perfil de e-mail será instalado. Para obter um objeto de plataforma suportado, utilize o Get-CMSupportedPlatform cmdlet.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: SupportedPlatforms
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SyncContentType
Especifica um tipo de conteúdo para sincronizar os dispositivos. Os valores válidos são:
- Nenhuma
- Contactos
- Calendário
- Tarefas
- Notas
- Todos
Type: EasProfileSyncContentType
Parameter Sets: (All)
Aliases: SyncContentTypes
Accepted values: None, Email, Contacts, Calendar, Tasks, Notes, All
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SyncSchedule
Especifica o calendário através do qual os dispositivos sincronizarão os dados do Exchange Server.
- Manual
- QuinzeMins
- TrintaMins
- SessentaMins
- AsArrive
Type: Schedule
Parameter Sets: (All)
Aliases:
Accepted values: Manual, FifteenMins, ThirtyMins, SixtyMins, AsArrive
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SincronizaçãoRecentlyUsed
Indica se a lista de endereços de e-mail que foram recentemente utilizados no dispositivo está sincronizada.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Utilizar OSSL
Indica se a comunicação Secure Sockets Layer (SSL) é utilizada no envio de e-mails, receção de e-mails e comunicação com o Exchange Server.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- O QueIf
Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.