Compartir a través de

  • Artículo

Get-CsCertificate

 

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

Devuelve información acerca de los certificados del equipo local que se hayan configurado para su uso con Microsoft Lync Server 2010.

Sintaxis

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

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, necesitará tener los certificados correctos asignados a las funciones de rol correspondientes.

El cmdlet Get-CsCertificate ofrece un modo de recuperar información detallada acerca de los certificados que se han configurado para su uso con Lync Server. Tenga en cuenta que el cmdlet solo devuelve información acerca de los certificados de Lync Server. Si un certificado no fue configurado para su uso con Lync Server (ya sea con el cmdlet Set-CsCertificate) no se devolverá ese certificado al ejecutar Get-CsCertificate.

Quiénes pueden ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados para ejecutar el cmdlet Get-CsCertificate en forma local: RTCUniversalServerAdmins.

Parámetros

Parámetro Requerido Tipo Descripción

Type

Opcional

Cadena de caracteres

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

AccessEdgeExternal

AudioVideoAuthentication

DataEdgeExternal

Default

External

Internal

iPhoneAPNService

iPadAPNService

MPNService

PICWebService (sólo Microsoft Lync Online 2010)

ProvisionService (sólo Microsoft Lync Online 2010)

WebServicesExternal

WebServicesInternal

WsFedTokenTransfer

Por ejemplo, esta sintaxis devuelve información sobre el certificado predeterminado: -Type Default.

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

-Type Internal,External,Default

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.

Report

Opcional

Cadena de caracteres

Le permite registrar información detallada acerca de los procedimientos realizados por Get-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.

Tipos de entrada

Ninguno. Get-CsCertificate no acepta entradas canalizadas.

Tipos de valores devueltos

Get-CsCertificate devuelve instancias del objeto Microsoft.Rtc.Management.Deployment.CertificateReference.

Ejemplo

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

Get-CsCertificate

El comando que se muestra en el Ejemplo 1 devuelve información acerca de los certificados que se encuentran actualmente asignados a componentes de Lync Server. Esto se lleva a cabo llamando a Get-CsCertificate sin ningún parámetro adicional.

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

Get-CsCertificate -Type WebServicesInternal

En el Ejemplo 2 se recuperan todos los certificados de Lync Server usados para servicios web internos. Para ello, se incluye el parámetro Type, junto con el valor de parámetro WebServicesInternal.

-------------------------- Ejemplo 3 --------------------------

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

El comando anterior devuelve todos los certificados de Lync Server que expiran antes del 1 de septiembre de 2011. Para llevar a cabo esta tarea, primero el comando usa Get-CsCertificate para devolver una recopilación de todos los certificados de Lync Server que se encuentran en uso actualmente. A continuación, esta recopilación se canaliza al cmdlet Where-Object, que selecciona sólo los certificados que expiran antes del 1° de septiembre de 2011. En la fecha especificada en este ejemplo, (9/1/2011) se usa el formato de los Estados Unidos para los valores de fecha y hora. Las fechas se deberán especificar con un formato compatible con sus opciones de idioma y regionales.

-------------------------- Ejemplo 4 --------------------------

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

En el Ejemplo 4 se devuelve información acerca de todos los certificados de Lync Server emitidos por la entidad de certificación (CA) MyCa. Para ello, el comando primero llama a Get-CsCertificate sin ningún parámetro, a fin de devolver una recopilación de todos los certificados que se encuentran actualmente en uso. Esta recopilación luego se transfiere a Where-Object, el cual escoge todos los certificados donde la propiedad Issuer es igual a (-eq) "Cn=MyCa".

-------------------------- Ejemplo 5 --------------------------

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

El comando que se muestra en el Ejemplo 5 devuelve todos los certificados de Lync Server donde la propiedad Subject se ha definido en CN=atl-cs-001.litwareinc.com. Esto se lleva a cabo usando Get-CsCertificate para recuperar una recopilación de todos los certificados de Lync Server y luego transfiriendo dicha recopilación al cmdlet Where-Object. A su vez, Where-Object selecciona sólo aquellos certificados cuya propiedad Subject es igual a "CN=atl-cs-001.litwareinc.com".