Partager via

  • Article

Get-CsCertificate

 

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

Renvoie des informations sur les certificats des ordinateurs locaux qui ont été configurés pour être utilisés avec Microsoft Lync Server 2010.

Syntaxe

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

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. Pour que vous puissiez implémenter intégralement Lync Server, les certificats appropriés doivent être attribués aux rôles serveur adéquats.

La cmdlet Get-CsCertificate vous permet d’extraire des informations détaillées sur les certificats qui ont été configurés pour être utilisés avec Lync Server. Notez que la cmdlet renvoie uniquement des informations sur les certificats Lync Server. Si un certificat n’a pas été configuré pour être utilisé avec Lync Server (via la cmdlet Set-CsCertificate), il ne sera pas renvoyé lors de l’exécution de Get-CsCertificate.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Get-CsCertificate : RTCUniversalServerAdmins.

Paramètres

Paramètre Obligatoire Type Description

Type

Facultatif

Chaîne

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

AccessEdgeExternal

AudioVideoAuthentication

DataEdgeExternal

Default

External

Internal

iPhoneAPNService

iPadAPNService

MPNService

PICWebService (Microsoft Lync Online 2010 uniquement)

ProvisionService (Microsoft Lync Online 2010 uniquement)

WebServicesExternal

WebServicesInternal

WsFedTokenTransfer

Par exemple, cette syntaxe retourne des informations sur 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

NetportId

Facultatif

Chaîne

Réservé à un usage ultérieur. Ce paramètre concerne les certificats dédiés à un port en particulier. Ce scénario n’est pas encore pris en charge dans Lync Server.

Report

Facultatif

Chaîne

Vous permet d’enregistrer des informations détaillées sur les procédures exécutées par Get-CsCertificate. La valeur de ce paramètre doit indiquer le chemin d’accès complet au fichier HTML à générer (par exemple : -Report C:\Logs\Certificates.html). Si le fichier spécifié existe déjà, il sera automatiquement remplacé par les nouvelles informations.

Types d’entrées

Aucun. Get-CsCertificate n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

Get-CsCertificate renvoie des instances de l’objet Microsoft.Rtc.Management.Deployment.CertificateReference.

Exemple

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

Get-CsCertificate

La commande illustrée dans l’exemple 1 renvoie des informations sur tous les certificats actuellement affectés aux composants de Lync Server. Cette opération est effectuée en appelant la cmdlet Get-CsCertificate sans aucun paramètre supplémentaire.

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

Get-CsCertificate -Type WebServicesInternal

L’exemple 2 illustre l’extraction de tous les certificats Lync Server utilisés pour les services Web internes. Pour ce faire, on inclut le paramètre Type, conjointement avec la valeur de paramètre WebServicesInternal.

-------------------------- Exemple 3 ------------------------

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

La commande précédente renvoie tous les certificats Lync Server qui expirent avant le 1er septembre 2011. Pour exécuter cette tâche, la commande utilise d’abord Get-CsCertificate pour renvoyer un ensemble de tous les certificats Lync Server actuellement utilisés. Cet ensemble est ensuite redirigé vers la cmdlet Where-Object, qui sélectionne uniquement les certificats qui expirent avant le 1 er septembre 2011. La date spécifiée dans cet exemple (9/1/2011) utilise le format de date anglais américain. Le format des dates doit être compatible avec votre langue et vos paramètres régionaux.

-------------------------- Exemple 4 ------------------------

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

L’exemple 4 renvoie des informations sur tous les certificats Lync Server émis par l’autorité de certification (CA) MyCa. Pour cela, la commande appelle d’abord la cmdlet Get-CsCertificate sans aucun paramètre afin de renvoyer un ensemble de tous les certificats actuellement utilisés. Cet ensemble est ensuite redirigé vers la cmdlet Where-Object, qui sélectionne tous les certificats dont la propriété Issuer est égale à (-eq) « Cn=MyCa ».

-------------------------- Exemple 5 ------------------------

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

La commande illustrée dans l’exemple 5 renvoie tous les certificats Lync Server dont la propriété Subject a été définie sur CN=atl-cs-001.litwareinc.com. Cette opération est effectuée en utilisant Get-CsCertificate pour renvoyer un ensemble de tous les certificats Lync Server, puis en redirigeant ce dernier vers la cmdlet Where-Object. La cmdlet Where-Object sélectionne ensuite uniquement les certificats dont la propriété Subject est égale à CN=atl-cs-001.litwareinc.com.