Add-ExchangeAdministrator
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2007-06-22
La cmdlet Add-ExchangeAdministrator permet d'ajouter un utilisateur ou un groupe à un rôle Microsoft Exchange Server 2007 particulier.
Syntaxe
Add-ExchangeAdministrator -Identity <SecurityPrincipalIdParameter> -Role <OrgAdmin | RecipientAdmin | ServerAdmin | ViewOnlyAdmin | PublicFolderAdmin> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Scope <String>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Pour exécuter la cmdlet Add-ExchangeAdministrator, vous devez utiliser un compte auquel a été délégué :
- le rôle Administrateur d'organisation Exchange.
Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
Microsoft.Exchange.Configuration.Tasks.SecurityPrincipalIdParameter |
Le paramètre Identity spécifie l'utilisateur à ajouter au rôle. |
Role |
Obligatoire |
Microsoft.Exchange.Management.RecipientTasks.DelegateRoleType |
Le paramètre Role renvoie uniquement le type de rôle spécifié. |
Scope |
Facultatif |
System.String |
Le paramètre Scope spécifie le nom du serveur pour lequel l'utilisateur dispose de privilèges d'administration. Scope est obligatoire lorsque vous définissez le rôle ServerAdmin. Lorsque le rôle est OrgAdmin ou MailboxAdmin, la portée est l'organisation tout entière. |
DomainController |
Facultatif |
Microsoft.Exchange.Data.Fqdn |
Le paramètre DomainController spécifie le contrôleur de domaine à utiliser pour écrire cette modification de configuration dans Active Directory. Utilisez le nom de domaine complet (FQDN) du contrôleur de domaine que vous voulez utiliser. |
Confirm |
Facultatif |
System.Management.Automation.SwitchParameter |
Le paramètre Confirm suspend le traitement par la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour 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
Les exemples de code suivants illustrent la commande Add-ExchangeAdministrator.
Le premier exemple ajoute l'utilisateur Ted au rôle OrgAdmin.
Le deuxième exemple ajoute l'utilisateur Iliana au rôle ServerAdmin sur le serveur Exchange 2007, Contoso-Mail-01.
Add-ExchangeAdministrator -Role OrgAdmin -Identity Contoso\Ted
Add-ExchangeAdministrator -Role ServerAdmin -Identity Contoso\Iliana -Scope Contoso-Mail-01