Get-ExchangeCertificate
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-ExchangeCertificate permet d'afficher les certificats qui se trouvent dans la banque d'informations de certificats locale.
Syntaxe
Get-ExchangeCertificate [-Thumbprint <String>] [-DomainName <MultiValuedProperty>]
Get-ExchangeCertificate [-DomainName <MultiValuedProperty>] [-Instance <X509Certificate2>]
Description détaillée
Pour exécuter la cmdlet Get-ExchangeCertificate, 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-ExchangeCertificate 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 Microsoft Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
DomainName |
Facultatif |
Microsoft.Exchange.Data.MultiValuedProperty |
Ce paramètre permet de renvoyer tous les certificats contenant le nom de domaine que vous spécifiez dans le champ Nom de l'objet ou le champ Autre nom de l'objet. |
Instance |
Facultatif |
System.Security.Cryptography.X509Certificates.X509Certificate2 |
Ce paramètre permet de transmettre un objet entier à la commande à traiter. Il est principalement utilisé dans les scripts où un objet entier doit être transmis à la commande. |
Thumbprint |
Facultatif |
System.String |
Ce paramètre permet de renvoyer le certificat avec l'empreinte correspondante. Chaque certificat contient une empreinte qui est le condensé de ses données. |
Types d'entrées
Types de retours
Erreurs
| Erreur | Description |
|---|---|
|
Exceptions
| Exceptions | Description |
|---|---|
|
Exemple
Le premier exemple renvoie tous les certificats stockés dans le magasin de certificats de l'ordinateur local.
Le deuxième exemple renvoie, dans une liste mise en forme, des détails sur un certificat spécifique stocké dans le magasin de certificats de l'ordinateur local.
Notes
Le paramètre Thumbprint est un paramètre de type positionnel, de sorte que seule la valeur Thumbprint doit être fournie.
Le troisième exemple indique le certificat qu'Exchange sélectionne pour le nom de domaine mail.contoso.com. Un connecteur d'envoi ou de réception sélectionne le certificat à utiliser sur la base du nom de domaine complet FQDN du connecteur. Si vous avez plusieurs certificats avec le même nom de domaine complet FQDN, vous pouvez voir quel certificat Exchange va sélectionner à l'aide du paramètre DomainName. Le premier certificat renvoyé est celui que Exchange sélectionnera.
Get-ExchangeCertificate
Get-ExchangeCertificate 5113ae0233a72fccb75b1d0198628675333d010e | fl
Get-ExchangeCertificate -DomainName mail1.contoso.com