Get-TransportServer
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-TransportServer permet d'afficher les informations de configuration de transport pour des ordinateurs sur lesquels le rôle serveur de transport Hub ou Edge est installé.
Syntaxe
Get-TransportServer [-Identity <TransportServerIdParameter>] [-DomainController <Fqdn>]
Description détaillée
La cmdlet Get-TransportServer permet d'afficher des informations de configuration pour tous les paramètres en relation avec le transport sur un serveur de transport Hub ou Edge.
Lorsque vous exécutez cette cmdlet sur un serveur de transport Hub, vous pouvez spécifier le serveur dont vous voulez extraire les informations de configuration de transport en spécifiant le nom du serveur dans le paramètre Identity. Si vous ne spécifiez pas le paramètre Identity lors de l'exécution de cette cmdlet sur un serveur de transport Hub, les informations de configuration pour tous les serveurs de transport Hub sont retournées.
Lorsque vous exécutez la cmdlet Get-TransportServer sur un serveur de transport Edge, vous ne pouvez pas spécifier le paramètre Identity. Cette cmdlet ne retourne les informations de configuration uniquement pour le serveur de transport Edge sur lequel elle est exécutée.
L'attribut ExchangeVersion renvoyé est la version minimale de Microsoft Exchange Server 2007 que vous pouvez utiliser pour gérer l'objet renvoyé. Cet attribut diffère de la version de Microsoft Exchange affichée dans la console de gestion Exchange lorsque vous sélectionnez Configuration du serveur.
Pour exécuter la cmdlet Get-TransportServer, vous devez utiliser un compte auquel a été délégué :
- le rôle Administrateurs Affichage seul d'Exchange.
Pour exécuter la cmdlet Get-TransportServer 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 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 extrait des données du 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 sur lesquels le rôle serveur de transport Edge est installé. Le rôle serveur de transport Edge écrit et lit uniquement sur l'instance locale Active Directory Application Mode (ADAM). |
Identity |
Facultatif |
Microsoft.Exchange.Configuration.Tasks.TransportServerIdParameter |
Lorsque vous utilisez ce paramètre sur un serveur de transport Hub, il retourne la configuration de transport du serveur spécifié. Vous ne pouvez pas utiliser ce paramètre lorsque vous exécutez la commande sur un serveur de transport Edge. Vous pouvez omettre le libellé du paramètre Identity. |
Erreurs
| Erreur | Description |
|---|---|
|
|
Exceptions
| Exceptions | Description |
|---|---|
|
|
Exemple
L'exemple de code suivant présente deux commandes utilisant la cmdlet Get-TransportServer.
Le premier exemple montre comment extraire une liste contenant un résumé de la configuration de transport pour tous les serveurs de transport Hub de l'organisation ou, si la commande est exécutée sur un serveur de transport Edge, le résumé de la configuration de transport pour le serveur local.
Le deuxième exemple montre comment extraire les informations détaillées de configuration de transport d'un serveur de transport Hub spécifique en canalisant les résultats de la cmdlet Get-TransportServer vers la cmdlet Format-List.
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-TransportServer
Get-TransportServer Hub1 | Format-List