Install-TransportAgent (RTM)
S’applique à : Exchange Server 2007
Dernière rubrique modifiée : 2007-06-11
La cmdlet Install-TransportAgent permet d'enregistrer un agent de transport sur un ordinateur sur lequel le rôle serveur de transport Edge ou serveur de transport Hub est installé dans une organisation Microsoft Exchange Server 2007.
Syntaxe
Install-TransportAgent -Name <String> -AssemblyPath <String> -TransportAgentFactory <String> [-DomainController <Fqdn>]
Description détaillée
La cmdlet Install-TransportAgent permet d'enregistrer un agent de transport sur un serveur de transport Edge ou de transport Hub.
.gif "Caution") Attention : |
|---|
| Les agents de transport ont un accès illimité aux messages électroniques qu'ils rencontrent. Exchange n'impose pas de restrictions au comportement d'un agent de transport. Les agents de transport instables ou qui contiennent des failles de sécurité peuvent affecter la stabilité et la sécurité d'Exchange. C'est pourquoi vous ne devez installer que des agents de transport totalement approuvés et qui ont été entièrement testés dans un environnement approprié. |
Pour exécuter la cmdlet Install-TransportAgent, vous devez utiliser un compte auquel ont été délégués :
- le rôle Administrateur de serveur Exchange et le groupe Administrateurs local pour le serveur cible.
Pour exécuter la cmdlet Install-TransportAgent sur un ordinateur sur lequel le rôle serveur de transport Edge est installé, vous devez ouvrir une session en utilisant un compte membre du groupe Administrateurs local sur cet ordinateur.
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 |
|---|---|---|---|
AssemblyPath |
Obligatoire |
System.String |
Ce paramètre spécifie l'emplacement de l'assembly Microsoft .NET de l'agent de transport. Les chemins d'accès au fichier conformes à la convention d'appellation UNC ne peuvent pas être utilisés. |
Name |
Obligatoire |
System.String |
Ce paramètre spécifie le nom complet de l'agent de transport à installer. Le nom ne peut pas comporter plus de 64 caractères. |
TransportAgentFactory |
Obligatoire |
System.String |
Ce paramètre spécifie le type de classe Microsoft .NET de la fabrique d'agents de transport. Le développeur de l'agent de transport en cours d'installation indique la fabrique de l'agent de transport et les informations connexes. Pour plus d'informations, consultez la documentation fournie par le développeur de l'agent de transport. |
DomainController |
Facultatif |
Microsoft.Exchange.Data.Fqdn |
Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui écrit ce changement de configuration dans le service d'annuaire Active Directory, incluez le paramètre DomainController dans la commande. Le paramètre DomainController n'est pas pris en charge sur les ordinateurs qui exécutent le rôle serveur de transport Edge. Le rôle serveur de transport Edge écrit et lit uniquement sur l'instance ADAM locale. |
Types d'entrées
Types de retours
Erreurs
| Erreur | Description |
|---|---|
|
Exceptions
| Exceptions | Description |
|---|---|
|
Exemple
L'exemple suivant décrit la procédure d'installation d'une application antivirus fictive sur un serveur de transport Edge ou de transport Hub.
Install-TransportAgent -Name "Antivirus for Exchange" -TransportAgentFactory "vendor.exchange.avTransportAgentfactory" -AssemblyPath "c:\Program Files\Vendor\TransportAgent\AvTransportAgentFactory.dll"