Compartilhar via

  • Artigo

Import-CsCertificate

 

Tópico modificado em: 2012-03-23

Importa um certificado para uso com o Microsoft Lync Server 2010. Se o certificado não for adquirido utilizando-se o cmdlet Request-CsCertificate, o certificado deve ser importado antes de ser atribuído a uma função de servidor do Lync Server 2010.

Sintaxe

Import-CsCertificate -Path <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Password <String>] [-PrivateKeyExportable <$true | $false>] [-Report <String>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

O Lync Server 2010 usa certificados como uma forma de servidores e funções de servidores para verificar 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 plenamente o Lync Server é necessário que os certificados relevantes estejam atribuídos às funções de servidor adequadas.

Para um certificado ser atribuído a uma função Lync Server, é necessário que os certificados sejam conhecidos pelo Lync Server. O cmdlet Request-CsCertificate permite que você faça solicitações online e offline para novos certificados. Se uma solicitação online for feita, o certificado será baixado e salvo automaticamente no repositório de certificados; igualmente importante, ele estará imediatamente disponível para uso pelo Lync Server 2010. Se uma solicitação offline for feita, um arquivo de certificado será enviado para você. Neste momento, é possível utilizar Import-CsCertificate para importar o certificado, um processo que o torna disponível para atribuição a uma função do servidor do Lync Server.

Quem pode executar esse cmdlet: É necessário que você seja um administrador local para executar o cmdlet Import-CsCertificate localmente. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Path

Obrigatório

Cadeia de caracteres

Caminho completo do arquivo de certificado a ser importado. Por exemplo: –Path "C:\Certificates\WebServer.cer".

Password

Opcional

Cadeia de caracteres

Senha associada ao arquivo de certificado.

PrivateKeyExportable

Opcional

Booleano

Quando ele for definido como True, garante que a parte de chave privada do certificado pode ser lida pela conta de serviços de rede.

Force

Opcional

Parâmetro de opção

Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando.

Report

Opcional

Cadeia de caracteres

Permite especificar o caminho do arquivo de log criado ao se executar o cmdlet. Por exemplo: -Report "C:\Logs\Certificates.html"

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. Import-CsCertificate não aceita a entrada em pipeline.

Tipos de Retorno

Nenhuma.

Exemplo

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

Import-CsCertificate -Path "C:\Certificates\WebServer.cer" -PrivateKeyExportable $True

O comando exibido no Exemplo 1 importa o certificado C:\Certificates\WebServer.cer. Depois que o comando tiver sido concluído, o certificado estará disponível para ser atribuído a uma função do servidor.