Compartir a través de

  • Artículo

Set-CsCertificate

 

Última modificación del tema: 2012-03-26

Le permite asignar un certificado a un servidor o un rol de servidor de Microsoft Lync Server 2010.

Sintaxis

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>]]

Descripción detallada

Lync Server 2010 usa certificados para hacer que los servidores y los roles de servidor puedan comprobar sus identidades; por ejemplo, el Servidor perimetral usa certificados para comprobar que el equipo con el que se está comunicando realmente sea un Servidor front-end y viceversa. Para implementar Lync Server completamente, deberá tener los certificados correctos asignados a los roles de servidor correspondientes.

El cmdlet Set-CsCertificate permite que los administradores asignen un certificado a un servidor o a un rol de servidor. Observe que solo puede asignar certificados que ya se han configurado para ser usados con Lync Server. Para identificar certificados disponibles para asignación, use el cmdlet Get-CsCertificate.

Quiénes pueden ejecutar este cmdlet: Debe ser administrador local para ejecutar el cmdlet Set-CsCertificate localmente. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

NetportId

Opcional

Cadena de caracteres

Reservada para uso futuro. Este parámetro es para certificados dedicados a un puerto específico, escenario que Lync Server aún no admite.

Reference

Opcional

Objeto CertificateReference

Objeto que hace referencia a un certificado configurado para ser usado con Lync Server. El comando siguiente devuelve una referencia a objeto (la variable $x) que representa un certificado con la huella digital B142918E463981A76503828BB1278391B716280987B:

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

Thumbprint

Opcional

Cadena de caracteres

Identificador único para el certificado. La huella digital de un certificado se parece a esto: B142918E463981A76503828BB1278391B716280987B.

Type

Opcional

Cadena de caracteres

Tipo de certificado asignado. Entre los tipos de certificados se incluyen, sin limitaciones, los siguientes:

AccessEdgeExternal

AudioVideoAuthentication

DataEdgeExternal

Default

External

Internal

iPhoneAPNService

iPadAPNService

MPNService

PICWebService (solo Microsoft Lync Online 2010)

ProvisionService (solo Microsoft Lync Online 2010)

WebServicesExternal

WebServicesInternal

WsFedTokenTransfer

Por ejemplo, esta sintaxis asigna el certificado Default: -Type Default.

Puede especificar varios tipos en un único comando al separar los tipos de certificados con comas:

-Type Internal,External,Default

Force

Opcional

Parámetro modificador

Evita que se muestre cualquier mensaje de error no grave que pueda surgir cuando se ejecuta el comando.

Report

Opcional

Cadena de caracteres

Le permite registrar información detallada acerca de los procedimientos realizados por Set-CsCertificate. El valor del parámetro debe ser la ruta de acceso completa al archivo HTML que se generará; por ejemplo: -Report C:\Logs\Certificates.html. Si el archivo especificado ya existe, se sobrescribirá automáticamente con la nueva información.

WhatIf

Opcional

Parámetro modificador

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

Confirm

Opcional

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Microsoft.Rtc.Management.Deployment.CertificateReference.

Tipos de valores devueltos

Set-CsCertificate no devuelve ningún valor ni objeto.

Ejemplo

-------------------------- Ejemplo 1 --------------------------

Set-CsCertificate -Type WebServicesExternal -Thumbprint "B142918E463981A76503828BB1278391B716280987B"

El comando que se muestra en el Ejemplo 1, asigna el certificado con la huella digital Thumbprint B142918E463981A76503828BB1278391B716280987B al rol de WebServicesExternal en el equipo local.

-------------------------- Ejemplo 2 --------------------------

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

El comando anterior asigna el certificado con la huella digital B142918E463981A76503828BB1278391B716280987B a tres roles diferentes en el equipo local: Predeterminado, WebServicesInternal y WebServicesExternal.