Set-PopSubscription

 

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-PopSubscription permet de modifier les propriétés d’un abonnement POP existant configuré dans la boîte aux lettres dans le nuage d’un utilisateur.

Pour plus d'informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir SyntaxeSyntaxe de cmdlet Exchange.

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

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

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

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

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

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

Cet exemple modifie la valeur du paramètre LeaveOnServer pour l’abonnement POP Ayla Contoso configuré dans la boîte aux lettres dans le nuage de l'utilisateur Ayla Kol.

Set-PopSubscription "Ayla Contoso" -Mailbox "Ayla Kol" -LeaveOnServer $false

Vous pouvez définir les propriétés de l’abonnement POP, comme le serveur POP, 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 spécifie l’abonnement POP. 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 d’identification d’un abonnement POP, telles que Identity et Name, en exécutant la commande suivante : Get-PopSubscription -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 POP.

Enabled

Facultatif

System.Boolean

Le paramètre Enabled spécifie si l’abonnement POP 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 POP distant.

IncomingAuth

Facultatif

Microsoft.Exchange.Transport.Sync.Common.Subscription.Pop.AuthenticationMechanism

Le paramètre IncomingAuth définit la méthode d’authentification employée par les clients POP pour accéder au serveur POP. Les valeurs valides sont Basic ou Spa, ce qui correspond à une méthode d’authentification de mot de passe sécurisée. Si vous ne spécifiez pas de valeur pour le paramètre IncomingAuth, la valeur Basic est utilisée.

IncomingPassword

Facultatif

System.Security.SecureString

Le paramètre IncomingPassword spécifie le mot de passe utilisé pour se connecter à la boîte aux lettres POP. 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 Incoming Port spécifie le numéro de port TCP employé par les clients POP pour se connecter au serveur POP. Les valeurs typiques sont 110 pour les connexions non chiffrées et 995 pour les connexions chiffrées. Par défaut, la valeur du paramètre IncomingPort est définie sur 110 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 995. Vous pouvez remplacer les valeurs par défaut en spécifiant un nombre entier pour le paramètre IncomingPort.

IncomingSecurity

Facultatif

Microsoft.Exchange.Transport.Sync.Common.Subscription.Pop.SecurityMechanism

Le paramètre IncomingSecurity spécifie la méthode de chiffrement employée par les clients POP pour se connecter au serveur POP. Les valeurs valides sont None, Ssl ou Tls. Si vous ne spécifiez pas de valeur pour le paramètre IncomingSecurity, la valeur None est utilisée.

IncomingServer

Facultatif

Microsoft.Exchange.Data.Fqdn

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

IncomingUserName

Facultatif

System.String

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

LeaveOnServer

Facultatif

System.Boolean

Le paramètre LeaveOnServer configure le comportement des messages extraits dans la boîte aux lettres POP. Lorsque le paramètre LeaveOnServer a la valeur $true, les messages extraits sont conservés dans la boîte aux lettres POP. Quand il a la valeur $false, les messages extraits sont supprimés de la boîte aux lettres POP. La valeur par défaut est $true.

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 POP. 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 POP. Ceci 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 POP 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 POP. Ceci 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 POP 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: