Partager via

Set-CMEmailProfile

  • Référence
Module:
ConfigurationManager

Définit un profil de messagerie.

Syntaxe

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

L’applet de commande Set-CMEmailProfile met à jour les paramètres d’un profil de messagerie Exchange ActiveSync.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Mettre à jour un profil par nom

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

Cette commande met à jour le nom du profil de messagerie Exchange ActiveSync de EmailProfile1 vers newEmailProfile1.

Exemple 2 : Mettre à jour un profil par ID

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

Cette commande met à jour le nom du profil de messagerie Exchange ActiveSync avec l’ID de 16795654 sur newEmailProfile2.

Exemple 3 : Mettre à jour un profil en tant qu’objet d’entrée

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

La première commande obtient l’objet de profil de messagerie Exchange ActiveSync nommé EmailProfile3 et stocke l’objet dans la variable $EmailProfile.

La deuxième commande remplace le nom du profil de messagerie stocké dans $EmailProfile par newEmailProfile3.

Exemple 4 : Utiliser le pipeline pour mettre à jour un profil

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

Cette commande obtient l’objet de profil de messagerie Exchange ActiveSync nommé EmailProfile4 et utilise l’opérateur de pipeline pour passer l’objet à Set-CMEmailProfile, qui remplace le nom de l’objet de profil de messagerie par newEmailProfile4.

Paramètres

-AccountDomainActiveDirectory

Spécifie le type de domaine de compte Active Directory. Les valeurs valides sont les suivantes :

  • domaine
  • ntdomain
Type:String
Valeurs acceptées:domain, ntdomain
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AccountDomainCustom

Spécifie un domaine de compte personnalisé. Ce paramètre ne peut être utilisé que si la valeur sAMAccountName est spécifiée pour le paramètre AccountUserNameType .

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AccountName

Spécifie le nom complet du compte de messagerie.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AccountUserNameType

Spécifie un type de nom d’utilisateur de compte. Les valeurs valides sont les suivantes :

  • mail
  • sAMAccountName
  • userPrincipalName
Type:String
Valeurs acceptées:mail, sAMAccountName, userPrincipalName
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AllowMessageMove

Indiquez si les utilisateurs sont autorisés à déplacer des messages électroniques entre les différents comptes qu’ils ont configurés sur leur appareil.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AllowThirdPartyApplication

Indique si les utilisateurs sont autorisés à envoyer des e-mails à partir de certaines applications de messagerie tierces non par défaut.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Description

Spécifie une description pour le profil de messagerie Exchange ActiveSync.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EmailAddressType

Spécifie un type d’adresse e-mail. Les valeurs valides sont les suivantes :

  • mail
  • userPrincipalName
Type:String
Valeurs acceptées:mail, userPrincipalName
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableSmime

Indique si le courrier sortant est envoyé à l’aide du chiffrement S/MIME.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Id

Spécifie le CI_ID d’un profil de messagerie Exchange ActiveSync.

Type:Int32
Alias:CI_ID, CIId
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-IdentityCertificate

Spécifie un objet de certificat d’identité. Pour obtenir un objet de certificat d’identité, utilisez l’applet de commande Get-CMConfigurationPolicy.

Type:IResultObject
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Spécifie un objet de profil de messagerie Exchange ActiveSync. Pour obtenir un objet de profil de messagerie, utilisez la fonction Get-CMEmailProfile.

Type:IResultObject
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-MailSyncDays

Spécifie le nombre de jours d’e-mail à synchroniser. Les valeurs valides sont les suivantes :

  • Illimité
  • OneDay
  • Trois jours
  • OneWeek
  • Deux semaines
  • OneMonth
Type:MailNumberofDaysToSync
Valeurs acceptées:Unlimited, OneDay, ThreeDays, OneWeek, TwoWeeks, OneMonth
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie le nom d’un profil de messagerie Exchange ActiveSync.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NewName

Spécifie un nouveau nom pour un profil de messagerie Exchange ActiveSync.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PassThru

Ajoutez ce paramètre pour renvoyer un objet qui représente l’élément avec lequel vous travaillez. Par défaut, cette applet de commande peut ne pas générer de sortie.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SigningCertificate

Spécifie un objet de certificat de signature utilisé pour la signature S/MIME. Pour obtenir un objet de certificat de signature, utilisez l’applet de commande Get-CMConfigurationPolicy.

Type:IResultObject
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SupportedPlatform

Spécifie les systèmes d’exploitation sur lesquels le profil de messagerie sera installé. Pour obtenir un objet de plateforme pris en charge, utilisez l’applet de commande Get-CMSupportedPlatform.

Type:IResultObject[]
Alias:SupportedPlatforms
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SyncContentType

Spécifie un type de contenu à synchroniser avec les appareils. Les valeurs valides sont les suivantes :

  • Aucune
  • E-mail
  • Contacts
  • Calendrier
  • Tâches
  • Notes
  • tous
Type:EasProfileSyncContentType
Alias:SyncContentTypes
Valeurs acceptées:None, Email, Contacts, Calendar, Tasks, Notes, All
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SynchronizeRecentlyUsed

Indique si la liste des adresses e-mail qui ont été récemment utilisées sur l’appareil est synchronisée.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SyncSchedule

Spécifie la planification selon laquelle les appareils synchroniseront les données à partir d’Exchange Server.

  • Manuel
  • Quinze minutes
  • ThirtyMins
  • SixtyMins
  • AsArrive
Type:Schedule
Valeurs acceptées:Manual, FifteenMins, ThirtyMins, SixtyMins, AsArrive
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UseSsl

Indique si la communication SSL (Secure Sockets Layer) est utilisée lors de l’envoi d’e-mails, de la réception d’e-mails et de la communication avec le serveur Exchange.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object