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 :
|
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.
Notes
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