Compartilhar via

  • Artigo

Set-CsCertificate

 

Tópico modificado em: 2012-03-26

Permite que você atribua um certificado a um servidor ou a uma função de servidor do Microsoft Lync Server 2010.

Sintaxe

Set-CsCertificate -Reference <CertificateReference> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-NetportId <String>] [-Report <String>] [-Type <CertType[]>] [-WhatIf [<SwitchParameter>]]

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

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 integralmente o Lync Server, você precisará ter os certificados apropriados atribuídos às funções de servidor apropriadas.

O cmdlet Set-CsCertificate permite que os administradores atribuam um certificado a um servidor ou a uma função de servidor. Observe que você só pode atribuir certificados que já tenham sido configurados para uso no Lync Server. Para identificar certificados disponíveis para atribuição, use o cmdlet Get-CsCertificate.

Quem pode executar este cmdlet: Você deve ser um administrador local para executar o cmdlet Set-CsCertificate localmente. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

NetportId

Opcional

Cadeia de caracteres

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

Reference

Opcional

Objeto CertificateReference

Referência de objeto para um certificado configurado para uso no Lync Server. O comando a seguir retorna uma referência de objeto (a variável $x) representando um certificado com a impressão digital B142918E463981A76503828BB1278391B716280987B:

$x = Get-CsCertificate | Where-Object {$_.Thumbprint –eq "B142918E463981A76503828BB1278391B716280987B".

Thumbprint

Opcional

Cadeia de caracteres

Identificador exclusivo para o certificado. A impressão digital de um certificado é semelhante ao seguinte: B142918E463981A76503828BB1278391B716280987B.

Type

Opcional

Cadeia de caracteres

Tipo de certificado que está sendo atribuído. 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 atribui 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

Force

Opcional

Parâmetro de opção

Suprime a exibição de qualquer mensagem de erro não fatal que possa surgir ao executar o comando.

Report

Opcional

Cadeia de caracteres

Permite que você registre informações detalhadas sobre os procedimentos realizados pelo Set-CsCertificate. O valor do parâmetro deve ser o caminho completo até o arquivo HTML a 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.

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

Microsoft.Rtc.Management.Deployment.CertificateReference.

Tipos de Retorno

Set-CsCertificate não retorna qualquer valor ou objeto.

Exemplo

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

Set-CsCertificate -Type WebServicesExternal -Thumbprint "B142918E463981A76503828BB1278391B716280987B"

O comando mostrado no Exemplo 1 atribui o certificado com impressão digital igual a B142918E463981A76503828BB1278391B716280987B à função WebServicesExternal no computador local.

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

Set-CsCertificate -Type Default, WebServicesInternal, WebServicesExternal -Thumbprint "B142918E463981A76503828BB1278391B716280987B"

O comando anterior atribui o certificado com impressão digital igual a B142918E463981A76503828BB1278391B716280987B a três funções diferentes no computador local: Default, WebServicesInternal e WebServicesExternal.