Compartilhar via

  • Artigo

Remove-CsCertificate

 

Tópico modificado em: 2012-03-26

Remove um certificado previamente marcado como disponível para uso pelo Microsoft Lync Server 2010.

Sintaxe

Remove-CsCertificate [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-NetportId <String>] [-Report <String>] [-Type <CertType[]>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

O Lync Server 2010 usa certificados como uma forma de servidores e funções de servidores verificarem as suas identidades. Por exemplo: um Servidor de Bordautiliza certificados para verificar se o computador com o qual está se comunicando é realmente um Servidor Front-End e vice-versa. Para implementar integralmente o Lync Server, você precisará ter os certificados apropriados atribuídos às funções de servidor apropriadas.

O cmdlet Remove-CsCertificate permite remover certificados que estiverem sendo usados pelo Lync Server. Na realidade, Remove-CsCertificate não exclui o certificado em si. Em vez disso, ele marca o certificado como indisponível para uso pelo Lync Server, remove todas as associações do certificado e revoga as permissões de acesso ao certificado (presumindo-se que nenhum outro serviço esteja usando o certificado). Entre outras coisas, isso significa que o certificado não aparecerá mais ao se executar o cmdlet Get-CsCertificate.

Para usar novamente o certificado com o Lync Server, é necessário atribuir novamente o certificado ao Lync Server 2010 usando o cmdlet Set-CsCertificate.

Se você tentar remover um certificado que estiver em uso, Remove-CsCertificate perguntará se você tem certeza de que deseja remover o certificado. O certificado não poderá ser removido enquanto não se responder a essa solicitação. Para ignorar a solicitação e excluir silenciosamente um certificado, mesmo se ele estiver em uso, adicione o parâmetro Force ao comando:

Remove-CsCertificate –Type WebServicesExternal -Force

Quem pode executar esse cmdlet: É necessário que você seja um administrador local e um membro do domínio para poder executar o cmdlet Remove-CsCertificate localmente. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet foi atribuído (inclusive qualquer função RBAC personalizada que tenha sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsCertificate"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Type

Opcional

Cadeia de caracteres

Tipo de certificado a ser excluído. Os tipos de certificado incluem (mas não se limitam a):

AccessEdgeExternal

AudioVideoAuthentication

DataEdgeExternal

Default

External

Internal

PICWebService (apenas Microsoft Lync Online 2010)

ProvisionService (apenas Microsoft Lync Online 2010)

WebServicesExternal

WebServicesInternal

WsFedTokenTransfer

Por exemplo: essa sintaxe exclui o certificado Default: -Type Default.

É possível excluir diversos tipos em um único comando, separando os tipos de certificado 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, uma situação que ainda não recebe o suporte do Lync Server.

Force

Opcional

Parâmetro de opção

Ignora a solicitação de confirmação que aparece normalmente, caso se tente excluir um certificado que estiver em uso.

Report

Opcional

Cadeia de caracteres

Permite registrar informações detalhadas sobre os procedimentos realizados pelo Remove-CsCertificate. O valor do parâmetro deve ser o caminho completo do arquivo HTML a ser gerado; por exemplo: -Report C:\Logs\Certificates.html. Se o arquivo especificado já existir,as novas informações o substituirão automaticamente.

WhatIf

Opcional

Parâmetro de opção

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

Parâmetro de opção

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Nenhuma. Remove-CsCertificate não aceita a entrada canalizada.

Tipos de Retorno

Nenhuma. Em vez disso, Remove-CsCertificate exclui instâncias do objeto Microsoft.Rtc.Management.Deployment.CertificateReference.

Exemplo

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

Remove-CsCertificate -Type WebServicesExternal

O comando exibido no Exemplo 1 exclui todos os certificados WebServicesExternal disponíveis para Lync Server. Se qualquer um desses certificados estiver sendo usado, Remove-CsCertificate perguntará se você tem certeza de que deseja exclui-lo; é necessário responder a essa solicitação para que o comando prossiga. Para ignorar a solicitação de confirmação, use o parâmetro Force:

Remove-CsCertificate –Type WebServicesExternal -Force