Condividi tramite

Set-CMEmailProfile

  • Riferimento
Modulo:
ConfigurationManager

Imposta un profilo di posta elettronica.

Sintassi

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>]

Descrizione

Il cmdlet Set-CMEmailProfile aggiorna le impostazioni di un profilo di posta elettronica di Exchange ActiveSync.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Aggiornare un profilo in base al nome

PS XYZ:\> Set-CMEmailProfile -Name "EmailProfile1" -NewName "newEmailProfile1"

Questo comando aggiorna il nome del profilo di posta elettronica di Exchange ActiveSync da EmailProfile1 a newEmailProfile1.

Esempio 2: Aggiornare un profilo in base all'ID

PS XYZ:\> Set-CMEmailProfile -Id 16795654 -NewName "newEmailProfile2"

Questo comando aggiorna il nome del profilo di posta elettronica di Exchange ActiveSync con l'ID di 16795654 a newEmailProfile2.

Esempio 3: Aggiornare un profilo come oggetto di input

PS XYZ:\> $EmailProfile = Get-CMEmailProfile -Name "EmailProfile3"
PS XYZ:\> Set-CMEmailProfile -InputObject $EmailProfile -NewName "newEmailProfile3"

Il primo comando ottiene l'oggetto profilo di posta elettronica di Exchange ActiveSync denominato EmailProfile3 e archivia l'oggetto nella variabile $EmailProfile.

Il secondo comando modifica il nome del profilo di posta elettronica archiviato in $EmailProfile in newEmailProfile3.

Esempio 4: Usare la pipeline per aggiornare un profilo

PS XYZ:\> Get-CMEmailProfile -Name "EmailProfile4" | Set-CMEmailProfile -NewName "newEmailProfile4"

Questo comando ottiene l'oggetto profilo di posta elettronica di Exchange ActiveSync denominato EmailProfile4 e usa l'operatore della pipeline per passare l'oggetto a Set-CMEmailProfile, che modifica il nome dell'oggetto profilo di posta elettronica in newEmailProfile4.

Parametri

-AccountDomainActiveDirectory

Specifica il tipo di dominio dell'account Active Directory. I valori validi sono:

  • dominio
  • ntdomain
Tipo:String
Valori accettati:domain, ntdomain
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AccountDomainCustom

Specifica un dominio account personalizzato. Questo parametro può essere utilizzato solo se viene specificato il valore sAMAccountName per il parametro AccountUserNameType .

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AccountName

Specifica il nome visualizzato per l'account di posta elettronica.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AccountUserNameType

Specifica un tipo di nome utente dell'account. I valori validi sono:

  • posta elettronica
  • sAMAccountName
  • userPrincipalName
Tipo:String
Valori accettati:mail, sAMAccountName, userPrincipalName
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AllowMessageMove

Indicare se agli utenti è consentito spostare i messaggi di posta elettronica tra account diversi configurati nel dispositivo.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AllowThirdPartyApplication

Indica se agli utenti è consentito inviare messaggi di posta elettronica da determinate applicazioni di posta elettronica di terze parti non predefinite.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Description

Specifica una descrizione per il profilo di posta elettronica di Exchange ActiveSync.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EmailAddressType

Specifica un tipo di indirizzo di posta elettronica. I valori validi sono:

  • posta elettronica
  • userPrincipalName
Tipo:String
Valori accettati:mail, userPrincipalName
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnableSmime

Indica se la posta elettronica in uscita viene inviata usando la crittografia S/MIME.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

Specifica la CI_ID per un profilo di posta elettronica di Exchange ActiveSync.

Tipo:Int32
Alias:CI_ID, CIId
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IdentityCertificate

Specifica un oggetto certificato di identità. Per ottenere un oggetto certificato di identità, usare il cmdlet Get-CMConfigurationPolicy.

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specifica un oggetto profilo di posta elettronica di Exchange ActiveSync. Per ottenere un oggetto profilo di posta elettronica, usare la funzione Get-CMEmailProfile.

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-MailSyncDays

Specifica il numero di giorni di posta elettronica da sincronizzare. I valori validi sono:

  • Illimitati
  • OneDay
  • Tre giorni
  • OneWeek
  • TwoWeeks
  • OneMonth
Tipo:MailNumberofDaysToSync
Valori accettati:Unlimited, OneDay, ThreeDays, OneWeek, TwoWeeks, OneMonth
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica il nome di un profilo di posta elettronica di Exchange ActiveSync.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NewName

Specifica un nuovo nome per un profilo di posta elettronica di Exchange ActiveSync.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassThru

Aggiungere questo parametro per restituire un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet potrebbe non generare alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SigningCertificate

Specifica un oggetto certificato di firma utilizzato per la firma S/MIME. Per ottenere un oggetto certificato di firma, usare il cmdlet Get-CMConfigurationPolicy.

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SupportedPlatform

Specifica i sistemi operativi in cui verrà installato il profilo di posta elettronica. Per ottenere un oggetto piattaforma supportato, usare il cmdlet Get-CMSupportedPlatform.

Tipo:IResultObject[]
Alias:SupportedPlatforms
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SyncContentType

Specifica un tipo di contenuto da sincronizzare con i dispositivi. I valori validi sono:

  • Nessuno
  • Posta elettronica
  • Contacts
  • Calendario
  • Attività
  • Note
  • Tutti
Tipo:EasProfileSyncContentType
Alias:SyncContentTypes
Valori accettati:None, Email, Contacts, Calendar, Tasks, Notes, All
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SynchronizeRecentlyUsed

Indica se l'elenco di indirizzi di posta elettronica usati di recente nel dispositivo è sincronizzato.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SyncSchedule

Specifica la pianificazione in base alla quale i dispositivi sincronizzano i dati da Exchange Server.

  • Manuale
  • Quindici minuti
  • Trenta minuti
  • SixtyMins
  • AsArrive
Tipo:Schedule
Valori accettati:Manual, FifteenMins, ThirtyMins, SixtyMins, AsArrive
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UseSsl

Indica se la comunicazione SSL (Secure Sockets Layer) viene usata quando si inviano messaggi di posta elettronica, si ricevono messaggi di posta elettronica e si comunica con Exchange Server.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object