Compartilhar via


Get-ExchangeCertificate

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2007-06-28

Use o cmdlet Get-ExchangeCertificate para exibir os certificados que estão no armazenamento de certificados local.

Sintaxe

Get-ExchangeCertificate [-Thumbprint <String>] [-DomainName <MultiValuedProperty>]

Get-ExchangeCertificate [-DomainName <MultiValuedProperty>] [-Instance <X509Certificate2>]

Descrição detalhada

Para executar o cmdlet Get-ExchangeCertificate, você deve usar uma conta à qual esteja delegado o seguinte:

  • Função Administrador Somente para Exibição do Exchange

Para executar o cmdlet Get-ExchangeCertificate em um computador em que a função de servidor Transporte de Borda esteja instalada, você deve fazer logon usando uma conta que seja membro do grupo Administradores local no mesmo computador.

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Microsoft Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Obrigatório Tipo Descrição

DomainName

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Use esse parâmetro para retornar todos os certificados que contêm o nome de domínio especificado no campo Nome do Assunto ou no campo Nome de Assunto Alternativo.

Instance

Opcional

System.Security.Cryptography.X509Certificates.X509Certificate2

Use esse parâmetro para passar um objeto inteiro para o comando para ser processado. Esse parâmetro é usado principalmente em scripts em que um objeto inteiro deve ser passado para o comando.

Thumbprint

Opcional

System.String

Use esse parâmetro para retornar o certificado com uma impressão digital correspondente. Cada certificado contém uma impressão digital, que é o resumo dos dados do certificado.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

Exceções

Exceções Descrição

 

Exemplo

O primeiro exemplo retorna todos os certificados no armazenamento de certificados do computador local.

O segundo exemplo retorna os detalhes, em uma lista formatada, sobre um certificado específico no armazenamento de certificados do computador local.

Dica

O parâmetro Thumbprint é posicional, de modo que apenas o valor Thumbprint deve ser fornecido.

O terceiro exemplo mostra o certificado que o Exchange escolherá para o Nome de domínio, mail.contoso.com. Um conector de envio ou recebimento seleciona os certificados que serão usados, com base no FQDN do conector. Se tiver vários certificados com o mesmo FQDN, você poderá ver o certificado que será escolhido pelo Exchange, usando o parâmetro DomainName. O primeiro certificado retornado será aquele que o Exchange escolherá.

Get-ExchangeCertificate
Get-ExchangeCertificate 5113ae0233a72fccb75b1d0198628675333d010e | fl
Get-ExchangeCertificate -DomainName mail1.contoso.com