Partager via

  • Article

Import-CsCertificate

 

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

Importe un certificat à utiliser avec Microsoft Lync Server 2010. Si un certificat n’est pas acquis par l’utilisation de la cmdlet Request-CsCertificate, il doit être importé pour pouvoir être affecté à un rôle serveur Lync Server 2010.

Syntaxe

Import-CsCertificate -Path <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Password <String>] [-PrivateKeyExportable <$true | $false>] [-Report <String>] [-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. Pour pouvoir implémenter complètement Lync Server, vous devez affecter les certificats appropriés aux rôles de serveur appropriés.

Pour pouvoir affecter des certificats à un rôle Lync Server, Lync Server doit avoir connaissance de ces certificats. La cmdlet Request-CsCertificate vous permet d’effectuer des demandes en ligne et hors connexion de nouveaux certificats. Dans le cas d’une demande en ligne, le certificat est automatiquement téléchargé et enregistré dans le magasin de certificats local. Tout aussi important, il sera immédiatement mis à la disposition de Lync Server 2010. S’il s’agit d’une demande hors connexion, un fichier de certificat vous sera envoyé. À ce stade, vous pouvez utiliser Import-CsCertificate pour importer le certificat, un processus qui rend le certificat disponible pour l’affectation à un rôle serveur Lync Server.

Personnes autorisées à exécuter cette cmdlet : Seul un administrateur local peut exécuter localement la cmdlet Import-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 "Import-CsCertificate"}

Paramètres

Paramètre Obligatoire Type Description

Path

Obligatoire

Chaîne

Chemin complet d’accès au fichier de certificat à importer. Par exemple : –Path "C:\Certificates\WebServer.cer".

Password

Facultatif

Chaîne

Mot de passe associé au fichier de certificat.

PrivateKeyExportable

Facultatif

Booléen

Si vous définissez la valeur True, vérifiez que la partie de la clé privée du certificat peut être lue par le compte Service réseau.

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

Permet de spécifier un chemin d’accès au fichier journal créé lors de l’exécution de la cmdlet. Par exemple : -Report "C:\Logs\Certificates.html"

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

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

Types de retours

Aucun.

Exemple

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

Import-CsCertificate -Path "C:\Certificates\WebServer.cer" -PrivateKeyExportable $True

La commande de l’exemple 1 importe le certificat C:\Certificates\WebServer.cer. Après l’exécution de la commande, le certificat est disponible pour être affecté à un rôle serveur.