New-MailboxFolder

 

S’applique à :Exchange Online, Exchange Server 2016

Dernière rubrique modifiée :2016-03-31

Cette cmdlet est disponible dans Exchange Server 2016 sur site et dans le service en nuage. Certains paramètres peuvent être propres à un environnement ou à un autre.

La cmdlet New-MailboxFolder permet de créer des dossiers dans votre propre boîte aux lettres. Les administrateurs ne peuvent pas utiliser cette cmdlet pour créer des dossiers dans d’autres boîtes aux lettres (la cmdlet est uniquement disponible avec le rôle utilisateur MyBaseOptions).

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

New-MailboxFolder -Name <String> -Parent <MailboxFolderIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

Cet exemple crée le dossier Personnel dans le dossier Boîte de réception de la boîte aux lettres de Jean-Charles.

New-MailboxFolder -Parent Tony:\Inbox -Name Personal

Cet exemple crée le dossier Personnel dans la hiérarchie du dossier racine de la boîte aux lettres de Jean-Charles.

New-MailboxFolder -Parent Tony -Name Personal

Cet exemple crée le dossier Personal dans le dossier Inbox dans la boîte aux lettres de Tony qui exécute la commande.

New-MailboxFolder -Parent :\Inbox -Name Personal

Si aucun dossier parent n’est spécifié, la cmdlet crée un dossier de courrier dans la hiérarchie du dossier racine de la boîte aux lettres. Si la boîte aux lettres n’est pas spécifiée, la cmdlet crée le dossier dans la boîte aux lettres de l’utilisateur qui exécute actuellement la tâche. Lorsqu’elle est exécutée, la cmdlet renvoie le nom du nouveau dossier et le chemin d’accès au dossier en tant que sortie.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, 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 rechercher les autorisations nécessaires pour exécuter une cmdlet ou un paramètre dans votre organisation, consultez la rubrique Rechercher les autorisations requises pour exécuter les cmdlets Exchange..

 

Paramètre Obligatoire Type Description

Name

Requis

System.String

Le paramètre Name spécifie le nom du nouveau dossier. Si la valeur contient des espaces, mettez le nom entre guillemets (").

Parent

Obligatoire

Microsoft.Exchange.Configuration.Tasks.MailboxFolderIdParameter

Le paramètre Parent spécifie les valeurs de l’identité de boîte aux lettres et le dossier parent sous lequel le nouveau dossier doit être créé. Si le dossier parent n’est pas spécifié, la cmdlet crée le dossier dans la hiérarchie du dossier racine de la boîte aux lettres spécifiée. Pour définir des valeurs pour ce paramètre, vous devez utiliser la syntaxe suivante : Identité de la boîte aux lettres>:<Parent

Les valeurs valides pour <Mailbox Identity> sont les identificateurs uniques de 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)

Les valeurs de <Parent> peuvent être l’identificateur d’un objet banque d’informations et une chaîne de chemin d’accès comme \Boîte de réception\Personnel.

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.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre est disponible uniquement dans Exchange 2016 sur site.

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : dc01.contoso.com.

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: