Compartilhar via

  • Artigo

Get-CsCertificate

 

Tópico modificado em: 2012-03-23

Retorna informações sobre certificados nos computadores locais que tenham sido configurados para uso com o Microsoft Lync Server 2010.

Sintaxe

Get-CsCertificate [-NetportId <String>] [-Report <String>] [-Type <CertType[]>]

Descrição Detalhada

O Lync Server 2010 usa certificados para que servidores e funções de servidores verifiquem suas identidades; por exemplo, um Servidor de Borda usa certificados para verificar se o computador com o qual está se comunicando realmente é um Servidor Front-End e vice-versa. Para implementar completamente o Lync Server, é preciso ter os certificados apropriados atribuídos às funções de servidor apropriadas.

O cmdlet Get-CsCertificate oferece uma forma de se obter informações detalhadas sobre os certificados que foram configurados para uso com o Lync Server. Observe que o cmdlet só retorna informações sobre certificados do Lync Server. Se um certificado não tiver sido configurado para uso com o Lync Server (usando o cmdlet Set-CsCertificate), esse certificado não será retornando quando Get-CsCertificate for executado.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Get-CsCertificate localmente: RTCUniversalServerAdmins.

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Type

Opcional

Cadeia de caracteres

Tipo de certificado que está sendo solicitado. Os tipos de certificado incluem, mas não se limitam a:

AccessEdgeExternal

AudioVideoAuthentication

DataEdgeExternal

Default

External

Internal

iPhoneAPNService

iPadAPNService

MPNService

PICWebService (apenas Microsoft Lync Online 2010)

ProvisionService (apenas Microsoft Lync Online 2010)

WebServicesExternal

WebServicesInternal

WsFedTokenTransfer

Por exemplo, esta sintaxe retorna informações sobre o certificado padrão (Default): -Type Default.

É possível especificar mais de um tipo em um mesmo comando, separando os tipos de certificados por vírgulas:

-Type Internal,External,Default

NetportId

Opcional

Cadeia de caracteres

Reservado para uso futuro. Este parâmetro é para certificados dedicados a uma porta específica, um cenário que ainda não é suportado pelo Lync Server.

Report

Opcional

Cadeia de caracteres

Permite a gravação de informações detalhadas sobre os procedimentos conduzidos por Get-CsCertificate. O valor do parâmetro deve ser o caminho completo para o arquivo HTML que será gerado. Por exemplo: -Report C:\Logs\Certificates.html. Se o arquivo especificado já existir, ele será automaticamente substituído com a nova informação.

Tipos de Entrada

Nenhuma. Get-CsCertificate não aceita entrada em pipeline.

Tipos de Retorno

Get-CsCertificate retorna instâncias do objeto Microsoft.Rtc.Management.Deployment.CertificateReference.

Exemplo

-------------------------- Exemplo 1 ------------------------

Get-CsCertificate

O comando mostrado no Exemplo 1 retorna informações sobre os certificados atribuídos no momento a componentes do Lync Server. Isso é feito chamando-se Get-CsCertificate sem parâmetros adicionais.

-------------------------- Exemplo 2 ------------------------

Get-CsCertificate -Type WebServicesInternal

O Exemplo 2 recupera todos os certificados do Lync Server usados para serviços Web internos. Para fazer isso, o parâmetro Type é incluído, junto com o valor de parâmetro WebServicesInternal.

-------------------------- Exemplo 3 ------------------------

Get-CsCertificate | Where-Object {$_.NotAfter -lt "9/1/2011"}

O comando anterior retorna todos os certificados do Lync Server que expiram antes de 1º de setembro de 2011. Para executar esta tarefa, o comando primeiro usa Get-CsCertificate para retornar uma coleção de todos os certificados do Lync Server em uso atualmente. Em seguida, a coleção é canalizada para o cmdlet Where-Object, que seleciona apenas os certificados que expirem antes de 1º de setembro de 2011. A data especificada neste exemplo (9/1/2011) usa o formato Inglês (Estados Unidos) para valores de data e hora. As datas devem ser especificadas em um formato compatível com suas opções regionais e de idioma.

-------------------------- Exemplo 4 ------------------------

Get-CsCertificate | Where-Object {$_.Issuer -eq "Cn=MyCa"}

O Exemplo 4 retorna informações sobre todos os certificados do Lync Server emitidos pela CA (autoridade de certificação) MyCa. Para fazer isso, o comando primeiro chama Get-CsCertificate sem nenhum parâmetro para retornar uma coleção de todos os certificados em uso no momento. Em seguida, essa coleção é canalizada para o Where-Object, que seleciona todos os certificados que tenham a propriedade Issuer (emissor) igual a (-eq) "Cn=MyCa".

-------------------------- Exemplo 5 ------------------------

Get-CsCertificate | Where-Object {$_.Subject -eq "CN=atl-cs-001.litwareinc.com"}

O comando mostrado no Exemplo 5 retorna todos os certificados do Lync Server nos quais a propriedade Subject tenha sido definida como CN=atl-cs-001.litwareinc.com. Para isso, usa-se Get-CsCertificate, para retornar uma coleção de todos os certificados do Lync Server, e canaliza-se essa coleção para o cmdlet Where-Object. Por sua vez, Where-Object seleciona apenas os certificados com a propriedade Subject igual a "CN=atl-cs-001.litwareinc.com".