Get-ExchangeCertificate (RTM)
Se aplica a: Exchange Server 2007
Última modificación del tema: 2007-06-11
Use el cmdlet Get-ExchangeCertificate para ver los certificados que se hospedan en el almacén de certificados local.
Sintaxis
Get-ExchangeCertificate [-Thumbprint <String>] [-DomainName <MultiValuedProperty>]
Get-ExchangeCertificate [-DomainName <MultiValuedProperty>] [-Instance <X509Certificate2>]
Descripción detallada
Para ejecutar el cmdlet Get-ExchangeCertificate, la cuenta utilizada debe tener delegado lo siguiente:
- Función Administrador de Exchange con permisos de sólo vista
Para ejecutar el cmdlet Get-ExchangeCertificate en un equipo que tiene instalada la función del servidor Transporte perimetral, debe iniciar sesión con una cuenta que sea miembro del grupo local de administradores en dicho equipo.
Para obtener más información sobre los permisos, la delegación de funciones y los derechos necesarios para administrar Microsoft Exchange Server 2007, consulte Consideraciones sobre permisos.
Parámetros
Parámetro | Necesario | Tipo | Descripción |
---|---|---|---|
DomainName |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Este parámetro se usa para devolver todos los certificados que contienen el nombre de dominio que se especificó en los campos Nombre de asunto o Nombre alternativo de asunto. |
Instance |
Opcional |
System.Security.Cryptography.X509Certificates.X509Certificate2 |
Use este parámetro para pasar un objeto completo al comando para que sea procesado. Este parámetro se usa, principalmente, en scripts en los que el objeto entero debe pasarse al comando. |
Thumbprint |
Opcional |
System.String |
Este parámetro se usa para devolver el certificado que tenga una huella digital coincidente. Cada certificado contiene una huella digital, que es un resumen de los datos del certificado. |
Tipos de entrada
Tipos de valores devueltos
Errores
Error | Descripción |
---|---|
|
Excepciones
Excepciones | Descripción |
---|---|
|
Ejemplo
El primer ejemplo devuelve todos los certificados almacenados en el almacén de certificados del equipo local.
El segundo ejemplo devuelve los detalles, en una lista con formato, de un certificado específico almacenado en el almacén de certificados del equipo local.
Nota
El parámetro Thumbprint es un parámetro posicional, por tanto, sólo se debe suministrar el valor de Thumbprint.
El tercer ejemplo muestra qué certificado tomará Exchange para el nombre de dominio, mail.contoso.com. Un conector de envío o de recepción selecciona el certificado que se va a usar basado en el FQDN (nombre de dominio completo) del conector. Si se dispone de varios certificados con el mismo FQDN, se puede comprobar qué certificado tomará Exchange mediante el parámetro DomainName. El primer certificado devuelto es el certificado que Exchange tomará.
Get-ExchangeCertificate
Get-ExchangeCertificate 5113ae0233a72fccb75b1d0198628675333d010e | fl
Get-ExchangeCertificate -DomainName mail1.contoso.com