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