Get-TransportAgent
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2007-06-28
La cmdlet Get-TransportAgent permet d'afficher la configuration d'un agent de transport sur un ordinateur sur lequel le rôle serveur de transport Edge ou de transport Hub est installé dans une organisation Microsoft Exchange Server 2007.
Syntaxe
Get-TransportAgent [-Identity <String>] [-DomainController <Fqdn>]
Description détaillée
La cmdlet Get-TransportAgent permet d'afficher la configuration d'un agent de transport sur un serveur de transport Edge ou un serveur de transport Hub.
Pour exécuter la cmdlet Get-TransportAgent, vous devez utiliser un compte auquel a été délégué :
- le rôle Administrateur Affichage seul d'Exchange.
Pour exécuter la cmdlet Get-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 |
|---|---|---|---|
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. |
Identity |
Facultatif |
System.String |
Ce paramètre spécifie le nom de l'agent de transport à afficher. Le nom ne peut pas comporter plus de 64 caractères. |
Types d'entrées
Types de retours
Erreurs
| Erreur | Description |
|---|---|
Exceptions
| Exceptions | Description |
|---|---|
Exemple
Le premier exemple montre comment afficher une liste récapitulative des agents de transport installés sur un serveur de transport Edge ou un serveur de transport Hub.
Le deuxième exemple montre comment afficher des informations sur un agent de transport spécifique sous la forme d'une liste. La commande Get-TransportAgent est canalisée vers la commande Format-List pour afficher la configuration détaillée de la règle de transport spécifiée.
Pour plus d'informations sur le traitement en pipeline, consultez la rubrique Traitement en pipeline.
Pour plus d'informations sur l'utilisation de la sortie d'une commande, consultez la rubrique Utilisation de la sortie d'une commande.
Get-TransportAgent
Get-TransportAgent -Identity "Edge Rule Agent" | Format-List