Set-ImapSubscription

 

S’applique à :Exchange Online

Dernière rubrique modifiée :2015-10-05

Cette cmdlet est disponible uniquement dans le service en nuage.

La cmdlet Set-ImapSubscription permet de modifier les propriétés d'un abonnement IMAP existant configuré dans la boîte aux lettres en nuage d'un utilisateur.

Set-ImapSubscription -Identity <AggregationSubscriptionIdParameter> [-Mailbox <MailboxIdParameter>] <COMMON PARAMETERS>

Set-ImapSubscription -Identity <AggregationSubscriptionIdParameter> [-DisplayName <String>] [-EmailAddress <SmtpAddress>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-IncomingAuth <Basic | Ntlm>] [-IncomingPassword <SecureString>] [-IncomingPort <Int32>] [-IncomingSecurity <None | Ssl | Tls>] [-IncomingServer <Fqdn>] [-IncomingUserName <String>] [-Mailbox <MailboxIdParameter>] <COMMON PARAMETERS>

Set-ImapSubscription -Identity <AggregationSubscriptionIdParameter> [-Mailbox <MailboxIdParameter>] [-ValidateSecret <String>] <COMMON PARAMETERS>

Set-ImapSubscription -Identity <AggregationSubscriptionIdParameter> [-Mailbox <MailboxIdParameter>] [-ResendVerification <SwitchParameter>] <COMMON PARAMETERS>

Set-ImapSubscription -Identity <AggregationSubscriptionIdParameter> [-Mailbox <MailboxIdParameter>] <COMMON PARAMETERS>

COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Cet exemple illustre la modification du nom complet de l'abonnement IMAP appelé « IMAP Fabrikam » qui est configuré dans la boîte aux lettres en nuage de l'utilisateur « Kim Akers ».

Set-ImapSubscription "Fabrikam IMAP" -Mailbox "Kim Akers" -DisplayName "Kim's Fabrikam Mail"

Cet exemple illustre la modification de la valeur du serveur IMAP pour imap.contoso.com pour l'abonnement IMAP appelé « Brian Contoso Mail » qui est configuré dans la boîte aux lettres en nuage de l'utilisateur « Brian Johnston ».

Set-ImapSubscription "Brian Contoso Mail" -Mailbox "Brian Johnson" -IncomingServer imap.contoso.com -Force

Vous pouvez définir les propriétés de l'abonnement IMAP, comme le serveur IMAP, le numéro de port TCP, la méthode de cryptage et la méthode d'authentification.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour voir les autorisations qui vous sont nécessaires, voir Entrée « Abonnements » dans la rubrique Autorisations des fonctionnalités dans Exchange Online.

 

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.AggregationSubscriptionIdParameter

Le paramètre Identity indique l’abonnement IMAP. Vous pouvez identifier l’abonnement par l’une des méthodes suivantes :

  • Spécifier l’identificateur global unique de l’abonnement (GUID), qui est son nom canonique (CN).

  • Utiliser le paramètre Mailbox pour spécifier la boîte aux lettres contenant l’abonnement, puis le nom de l’abonnement.

Vous pouvez trouver les valeurs identifiant un abonnement IMAP, telles que Identity et Name, en exécutant cette commande : Get-ImapSubscription -Mailbox <mailbox>.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Confirm spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

  • Les cmdlets destructives (par exemple, les cmdlets Remove-*) ont une pause intégrée qui vous oblige à confirmer la commande avant de poursuivre. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.

  • La plupart des autres cmdlets (par exemple, les cmdlets New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.

DisplayName

Facultatif

System.String

Le paramètre DisplayName spécifie le nom convivial de l’abonnement.

EmailAddress

Facultatif

Microsoft.Exchange.Data.SmtpAddress

Le paramètre EmailAddress spécifie l’adresse de messagerie électronique de la boîte aux lettres IMAP.

Enabled

Facultatif

System.Boolean

Le paramètre Enabled spécifie si l'abonnement IMAP est activé. Ce paramètre accepte la valeur $true ou $false. La valeur par défaut est $true.

Force

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Force indique à la commande de modifier les paramètres d'abonnement spécifiés même si ceux-ci ne peuvent pas être vérifiés par le serveur IMAP distant.

IncomingAuth

Facultatif

Microsoft.Exchange.Data.IMAPAuthenticationMechanism

Le paramètre IncomingAuth définit la méthode d'authentification utilisée par les clients IMAP pour accéder au serveur IMAP. La valeur valide est Basic ou Ntlm. La valeur par défaut est Basic.

IncomingPassword

Facultatif

System.Security.SecureString

Le paramètre IncomingPassword spécifie le mot de passe utilisé pour se connecter à la boîte aux lettres IMAP. Vous devez spécifier la valeur de ce paramètre dans un format sécurisé, par exemple (ConvertTo-SecureString -String '<password>' -AsPlainText -Force).

IncomingPort

Facultatif

System.Int32

Le paramètre IncomingPort spécifie le numéro de port TCP utilisé par les clients IMAP pour se connecter au serveur IMAP. Les valeurs types sont 143 pour les connexions non chiffrées et 993 pour les connexions chiffrées. Par défaut, la valeur du paramètre IncomingPort est définie sur 143 si vous ne définissez pas le paramètre IncomingSecurity sur Ssl ou Tls. Si vous définissez le paramètre IncomingSecurity sur Ssl ou Tls, la valeur du paramètre IncomingPort est définie sur 993. Vous pouvez remplacer les valeurs par défaut en spécifiant un nombre entier pour le paramètre IncomingPort.

IncomingSecurity

Facultatif

Microsoft.Exchange.Data.IMAPSecurityMechanism

Le paramètre IncomingSecurity spécifie la méthode de chiffrement utilisée par les clients IMAP pour se connecter au serveur IMAP. La valeur valide est None, Ssl ou Tls. La valeur par défaut est None.

IncomingServer

Facultatif

Microsoft.Exchange.Data.Fqdn

Le paramètre IncomingServer spécifie le nom de domaine complet (FDQN) du serveur IMAP, par exemple, incoming.contoso.com.

IncomingUserName

Facultatif

System.String

Le paramètre IncomingUserName spécifie le nom d’utilisateur utilisé pour la connexion à la boîte aux lettres IMAP.

Mailbox

Facultatif

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Le paramètre Mailbox spécifie la boîte aux lettres dans le nuage qui contient l'abonnement IMAP. Vous pouvez utiliser n'importe quelle valeur qui identifie de manière unique la boîte aux lettres.

Par exemple :

  • Nom

  • Nom complet

  • Alias

  • Nom unique

  • Nom unique canonique

  • <domain name>\<account name>

  • Adresse de messagerie

  • GUID

  • LegacyExchangeDN

  • SamAccountName

  • Identifiant utilisateur ou nom d’utilisateur principal (UPN)

ResendVerification

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre ResendVerification génère des données de vérification pour l'abonnement IMAP. Ce test s'inscrit dans le processus de vérification qui permet à l'utilisateur d'envoyer des messages depuis sa boîte aux lettres en nuage à l'aide de l'adresse De de la boîte aux lettres IMAP abonnée.

Il n'est pas possible de spécifier le paramètre ResendVerification avec d'autres paramètres qui modifient les paramètres de l'abonnement. De même, les paramètres ResendVerification et ValidateSecret s'excluent mutuellement.

ValidateSecret

Facultatif

System.String

Le paramètre ValidateSecret valide les données de vérification pour l'abonnement IMAP. Ce test s'inscrit dans le processus de vérification qui permet à l'utilisateur d'envoyer des messages depuis leur boîte aux lettres dans le nuage à l'aide de l'adresse De de la boîte aux lettres IMAP abonnée.

Il n'est pas possible de spécifier le paramètre ValidateSecret avec d'autres paramètres qui modifient les paramètres de l'abonnement. De même, les paramètres ResendVerification et ValidateSecret s'excluent mutuellement.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Pour visualiser les types d’entrées acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type d’entrée pour une cmdlet est vide, la cmdlet n’accepte pas les données d’entrée.

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.

 
Afficher: