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 dans le organization 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.
Syntaxe
Domain
Get-ExchangeServer
-Domain <Fqdn>
[-DomainController <Fqdn>]
[-Status]
[<CommonParameters>]
Identity
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 cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont 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 dans le organization.
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
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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é.
Propriétés des paramètres
| Type: | Fqdn |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Domain
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DomainController
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propriétés des paramètres
| Type: | Fqdn |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Identity
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Attention : la valeur $null ou une valeur inexistante pour le paramètre Identity retourne tous les objets comme si vous exécutiez la commande Get- sans le paramètre Identity. Vérifiez que les listes de valeurs du paramètre Identity sont exactes et ne contiennent pas de valeurs $null inexistantes.
Propriétés des paramètres
| Type: | ServerIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Identity
| Position: | 1 |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Status
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
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.