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