Set-CMEmailProfile
Définit un profil de messagerie.
Syntax
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 Configuration Manager applets de commande à 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 |
Accepted values: | domain, ntdomain |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AccountName
Spécifie le nom complet du compte de messagerie.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AccountUserNameType
Spécifie un type de nom d’utilisateur de compte. Les valeurs valides sont les suivantes :
- Samaccountname
- userPrincipalName
Type: | String |
Accepted values: | mail, sAMAccountName, userPrincipalName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Une invite de confirmation apparaît avant d’exécuter le cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Spécifie une description pour le profil de messagerie Exchange ActiveSync.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EmailAddressType
Spécifie un type d’adresse e-mail. Les valeurs valides sont les suivantes :
- userPrincipalName
Type: | String |
Accepted values: | mail, userPrincipalName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableSmime
Indique si le courrier sortant est envoyé à l’aide du chiffrement S/MIME.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Spécifie le CI_ID d’un profil de messagerie Exchange ActiveSync.
Type: | Int32 |
Aliases: | CI_ID, CIId |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Accepted values: | Unlimited, OneDay, ThreeDays, OneWeek, TwoWeeks, OneMonth |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Spécifie le nom d’un profil de messagerie Exchange ActiveSync.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewName
Spécifie un nouveau nom pour un profil de messagerie Exchange ActiveSync.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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[] |
Aliases: | SupportedPlatforms |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SyncContentType
Spécifie un type de contenu à synchroniser avec les appareils. Les valeurs valides sont les suivantes :
- Aucun
- Contacts
- Calendrier
- Tâches
- Remarques
- tous
Type: | EasProfileSyncContentType |
Aliases: | SyncContentTypes |
Accepted values: | None, Email, Contacts, Calendar, Tasks, Notes, All |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SyncSchedule
Spécifie la planification selon laquelle les appareils synchroniseront les données de l’Exchange Server.
- Manual
- Quinze minutes
- ThirtyMins
- SixtyMins
- AsArrive
Type: | Schedule |
Accepted values: | Manual, FifteenMins, ThirtyMins, SixtyMins, AsArrive |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 Exchange Server.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Sorties
System.Object
Liens associés
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour