Add-MailboxPermission

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2013-04-08

La cmdlet Add-MailboxPermission permet d’ajouter des autorisations à une boîte aux lettres.

Syntaxe

Add-MailboxPermission -Identity <MailboxIdParameter> -AccessRights <MailboxRights[]> -User <SecurityPrincipalIdParameter> [-Confirm [<SwitchParameter>]] [-Deny <SwitchParameter>] [-DomainController <Fqdn>] [-InheritanceType <None | All | Descendents | SelfAndChildren | Children>] [-WhatIf [<SwitchParameter>]]

Add-MailboxPermission -Identity <MailboxIdParameter> -Owner <SecurityPrincipalIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

Add-MailboxPermission [-Identity <MailboxIdParameter>] -Instance <MailboxAcePresentationObject> [-AccessRights <MailboxRights[]>] [-Confirm [<SwitchParameter>]] [-Deny <SwitchParameter>] [-DomainController <Fqdn>] [-InheritanceType <None | All | Descendents | SelfAndChildren | Children>] [-User <SecurityPrincipalIdParameter>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Cette cmdlet permet d'octroyer des autorisations à une boîte aux lettres. Elle permet par exemple d'octroyer à un utilisateur un accès complet à la boîte aux lettres d'un autre utilisateur.

Pour exécuter la cmdlet Add-MailboxPermission, vous devez utiliser un compte auquel a été délégué, au minimum, ce qui suit sur le serveur où se situe la boîte aux lettres :

  • Administrateur Exchange Server ou Administrateur de l'organisation Exchange

Par ailleurs, d'autres autorisations peuvent être requises dans les services de domaine Active Directory pour le compte utilisé pour exécuter certaines opérations. Pour vérifier que vous disposez des autorisations appropriées, l'autorisation Opérateurs de compte doit être déléguée au compte utilisé dans le domaine dans lequel figure le compte cible doté d'une boîte aux lettres.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Microsoft Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

AccessRights

Obligatoire

Microsoft.Exchange.Management.RecipientTasks.MailboxRights[]

AccessRights parameter spécifie les droits nécessaires pour effectuer l'opération. Les valeurs valides sont les suivantes :

  • FullAccess

  • ExternalAccount

  • DeleteItem

  • ReadPermission

  • ChangePermission

  • ChangeOwner

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Le paramètre Identity spécifie l'identité de la boîte aux lettres à laquelle des autorisations sont ajoutées.

> [!Note] > Le paramètre Identité requiert le nom complet de l'utilisateur entre guillemets.

Instance

Obligatoire

Microsoft.Exchange.Management.RecipientTasks.MailboxAcePresentationObject

Le paramètre Instance permet de transmettre un objet entier à la commande à traiter. Il est principalement utilisé dans les scripts où un objet entier doit être transmis à la commande.

Owner

Obligatoire

Microsoft.Exchange.Configuration.Tasks.SecurityPrincipalIdParameter

Le paramètre Owner spécifie le propriétaire de l'objet boîte aux lettres.

User

Obligatoire

Microsoft.Exchange.Configuration.Tasks.SecurityPrincipalIdParameter

Le paramètre User spécifie la boîte aux lettres d’utilisateur à laquelle les autorisations sont accordées sur l’autre boîte aux lettres.

Deny

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Deny refuse à l'utilisateur des autorisations sur la boîte aux lettres.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Pour spécifier le nom de domaine complet du contrôleur de domaine qui extrait des données du service d'annuaire Active Directory, incluez le paramètre DomainController dans la commande.

InheritanceType

Facultatif

System.DirectoryServices.ActiveDirectorySecurityInheritance

Ce paramètre permet de spécifier le niveau d'héritage des autorisations de « lecture » dans la structure des objets Active Directory.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Confirm suspend la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Vous n'avez pas besoin de spécifier une valeur avec le paramètre Confirm.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre WhatIf donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, vous pouvez afficher des changements potentiels sans devoir les appliquer. Il n’est pas nécessaire de spécifier une valeur pour le paramètre WhatIf.

Types d’entrées

Types de retours

Erreurs

Erreur Description

Exceptions

Exceptions Description

Exemple

Dans cet exemple, Ted Bremer obtient un accès complet à la boîte aux lettres d’Ellen Adam.

Note

Le nom complet de l’utilisateur doit être indiqué entre guillemets pour le paramètre Identity.

Add-MailboxPermission -Identity "Ellen Adams" -User TedBrem -AccessRights Fullaccess -InheritanceType all