Partager via

  • Article

Set-CsCertificate

 

Dernière rubrique modifiée : 2012-03-26

Vous permet d’assigner un certificat à un serveur ou un rôle serveur Microsoft Lync Server 2010.

Syntaxe

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

Description détaillée

Lync Server 2010 utilise des certificats pour vérifier l’identité des serveurs et des rôles serveur ; par exemple, un serveur Edge utilise des certificats pour vérifier que l’ordinateur avec lequel il communique est réellement un serveur frontal et inversement. Afin de mettre en œuvre Lync Server à part entière, vous devez avoir assigné les certificats qui conviennent aux rôles serveur appropriés.

La cmdlet Set-CsCertificate permet aux administrateurs d’assigner un certificat à un serveur ou un rôle serveur. Notez que vous ne pouvez assigner que des certificats qui ont déjà été configurés pour être utilisés avec Lync Server. Pour identifier les certificats disponibles qui doivent être assignés, utilisez la cmdlet Get-CsCertificate.

Personnes autorisées à exécuter cette cmdlet : Vous devez être administrateur local pour pouvoir exécuter localement la cmdlet Set-CsCertificate. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :

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

Paramètres

Paramètre Obligatoire Type Description

NetportId

Facultatif

Chaîne

Réservé à un usage ultérieur. Ce paramètre sert aux certificats dédiés à un port spécifique, un scénario qui n’est pas encore pris en charge par Lync Server.

Reference

Facultatif

Objet CertificateReference

Référence d’objet à un certificat configuré pour être utilisé avec Lync Server. La commande suivante retourne une référence d’objet (la variable $x) qui représente un certificat avec l’empreinte numérique B142918E463981A76503828BB1278391B716280987B:

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

Thumbprint

Facultatif

Chaîne

Identificateur unique du certificat. Une empreinte numérique de certificat ressemble à ceci : B142918E463981A76503828BB1278391B716280987B.

Type

Facultatif

Chaîne

Type du certificat affecté. Les types de certificats incluent notamment :

AccessEdgeExternal

AudioVideoAuthentication

DataEdgeExternal

Default

Externe

Internal

iPhoneAPNService

iPadAPNService

MPNService

PICWebService (Microsoft Lync Online 2010 uniquement)

ProvisionService (Microsoft Lync Online 2010 uniquement)

WebServicesExternal

WebServicesInternal

WsFedTokenTransfer

Par exemple, cette syntaxe affecte le certificat Default : -Type Default.

Vous pouvez spécifier plusieurs types dans une seule et même commande en séparant les types de certificat par des virgules :

-Type Internal,External,Default

Force

Facultatif

Paramètre de commutateur

Supprime l’affichage de tous les messages d’erreur récupérable susceptibles d’apparaître lors de l’exécution de la commande.

Report

Facultatif

Chaîne

Vous permet d’enregistrer des informations détaillées concernant les procédures mises en œuvre par Set-CsCertificate. La valeur de paramètre doit être le chemin complet au fichier HTML à générer, par exemple : -Report C:\Logs\Certificates.html. Si le fichier spécifique existe déjà, il sera automatiquement supprimé et remplacé par les nouvelles informations.

WhatIf

Facultatif

Paramètre de commutateur

Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement.

Confirm

Facultatif

Paramètre de commutateur

Vous demande confirmation avant d’exécuter la commande.

Types d’entrées

Microsoft.Rtc.Management.Deployment.CertificateReference.

Types de retours

Set-CsCertificate ne retourne ni valeur ni objet.

Exemple

-------------------------- Exemple 1 --------------------------

Set-CsCertificate -Type WebServicesExternal -Thumbprint "B142918E463981A76503828BB1278391B716280987B"

La commande illustrée à l’exemple 1 affecte le certificat à l’empreinte numérique B142918E463981A76503828BB1278391B716280987B au rôle WebServicesExternal sur l’ordinateur local.

-------------------------- Exemple 2 --------------------------

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

La commande précédente assigne le certificat avec l’empreinte numérique B142918E463981A76503828BB1278391B716280987B à trois rôles différents sur l’ordinateur local : Default, WebServicesInternal, et WebServicesExternal.