New-Subscription

 

S’applique à :Exchange Online

Dernière rubrique modifiée :2015-09-08

Cette cmdlet est disponible uniquement dans le service en nuage.

La cmdlet New-Subscription permet aux utilisateurs de créer des abonnements Hotmail, POP ou IMAP dans leur propre boîte aux lettres informatique. Un administrateur ne peut pas utiliser cette cmdlet pour créer des abonnements dans la boîte aux lettres d’un autre utilisateur.

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

New-Subscription -EmailAddress <SmtpAddress> -Name <String> -Password <SecureString> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-Force <SwitchParameter>] [-Hotmail <SwitchParameter>] [-Imap <SwitchParameter>] [-Mailbox <MailboxIdParameter>] [-Pop <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Cet exemple illustre la création d'un abonnement Constoso dans la boîte aux lettres de l'utilisateur Brian Johnson. Les informations de la boîte aux lettres distante sont les suivantes :

  • Adresse électronique : brian@contoso.com

  • Mot de passe : Pa$$word1

New-Subscription -Name Contoso -EmailAddress brian@contoso.com -Password (ConvertTo-SecureString -String 'Pa$$word1' -AsPlainText -Force)

La cmdlet New-Subscription crée une connexion entre la boîte aux lettres d’un utilisateur dans le nuage et une boîte aux lettres Hotmail, POP ou IMAP distante. La boîte aux lettres dans le nuage interroge périodiquement la boîte aux lettres distante pour savoir si elle a reçu de nouveaux messages. Si vous ne spécifiez pas le type de boîte aux lettres distante, la cmdlet essaie automatiquement de configurer l’abonnement en utilisant tous les types d’abonnement disponibles.

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

EmailAddress

Obligatoire

Microsoft.Exchange.Data.SmtpAddress

Le paramètre EmailAddress spécifie l’adresse de messagerie de l’abonnement.

Name

Requis

System.String

Le paramètre Name spécifie le nom de l’abonnement. Le nom de l’abonnement ne doit pas nécessairement être globalement unique. Le nom doit être unique par rapport aux autres abonnements existant dans la même boîte aux lettres.

Password

Obligatoire

System.Security.SecureString

Le paramètre Password spécifie le mot de passe utilisé pour se connecter à la boîte aux lettres.

Ce paramètre utilise la syntaxe (ConvertTo-SecureString -String '<password>' -AsPlainText -Force). Pour être invité à entrer le mot de passe et à le stocker en tant que variable, vous pouvez également exécuter la commande $password = Read-Host "Enter password" -AsSecureString, puis utiliser la valeur $password pour ce paramètre.

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. Si vous ne spécifiez pas de valeur pour le paramètre DisplayName, la valeur du paramètre EmailAddress est utilisée.

Force

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Force spécifie s’il faut supprimer les messages d’avertissement ou de confirmation. Vous pouvez utiliser ce commutateur pour exécuter des tâches par programme, lorsqu’une intervention administrative est inappropriée. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Hotmail

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Hotmail spécifie que l’abonnement est un abonnement Hotmail. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Imap

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Imap spécifie que l’abonnement est un abonnement IMAP. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

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. 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)

Pop

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Pop spécifie que l’abonnement est un abonnement POP. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

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: