Get-ExchangeServer
La cmdlet est disponible uniquement dans Exchange en local.
Utilisez l’applet de commande Get-ExchangeServer pour afficher les propriétés des serveurs Exchange.
Lorsque vous exécutez l’applet de commande Get-ExchangeServer sans paramètre, elle retourne les attributs de tous les serveurs de l’organisation Exchange. Pour renvoyer des propriétés de serveur spécifiques (notamment les informations relatives au contrôleur de domaine) lorsque la cmdlet Get-ExchangeServer doit contacter directement des serveurs ou effectuer un calcul lent ou complexe, assurez-vous que vous utilisez le paramètre Status.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntax
Get-ExchangeServer
-Domain <Fqdn>
[-DomainController <Fqdn>]
[-Status]
[<CommonParameters>]
Get-ExchangeServer
[[-Identity] <ServerIdParameter>]
[-DomainController <Fqdn>]
[-Status]
[<CommonParameters>]
Description
L’attribut ExchangeVersion retourné est la version minimale de Microsoft Exchange que vous pouvez utiliser pour gérer l’objet retourné. Cet attribut n’est pas identique à la version d’Exchange affichée dans le Centre d’administration Exchange lorsque vous sélectionnez Configuration du serveur.
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.
Exemples
Exemple 1
Get-ExchangeServer | Format-List
Cet exemple retourne une liste récapitulative de tous les serveurs Exchange de l’organisation.
Exemple 2
Get-ExchangeServer -Identity Mailbox01 | Format-List
Cet exemple retourne des informations détaillées sur le serveur Exchange nommé Mailbox01.
Paramètres
-Domain
Le paramètre Domain filtre les résultats par nom de domaine complet (FQDN) du domaine (par exemple, contoso.com).
Vous ne pouvez pas utiliser ce paramètre avec le paramètre Identité.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : « dc01.contoso.com ».
Les serveurs de transport Edge ne prennent pas en charge le paramètre DomainController. Un serveur de transport Edge utilise l’instance locale des services AD LDS (Active Directory Lightweight Directory Services) pour lire et écrire des données.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Le paramètre Identity spécifie le serveur Exchange que vous souhaitez afficher. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique le serveur Exchange. Par exemple :
- Nom
- GUID
- Nom unique (DN)
- ExchangeLegacyDN
Vous ne pouvez pas utiliser ce paramètre avec le paramètre Domain.
Type: | ServerIdParameter |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Status
Le commutateur Status spécifie s’il faut inclure des valeurs de propriété supplémentaires dans les résultats, par exemple l’état Watson, StaticDomainControllers et l’utilisation du contrôleur de domaine d’exécution. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Pour afficher des valeurs supplémentaires, vous devez canaliser la sortie vers une cmdlet de mise en forme, par exemple la cmdlet Format-List.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
Entrées
Input types
Pour visualiser les types d'entrées acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type d'entrée pour une cmdlet est vide, la cmdlet n'accepte pas les données d'entrée.
Sorties
Output types
Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.