Partager via


Remove-CsCertificate

 

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

Supprime un certificat marqué précédemment comme disponible pour une utilisation dans Microsoft Lync Server 2010.

Syntaxe

Remove-CsCertificate [-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, vous devez avoir assigné les certificats qui conviennent aux rôles serveur appropriés.

La cmdlet Remove-CsCertificate permet de supprimer les certificats actuellement utilisés dans Lync Server. Remove-CsCertificate ne supprime pas le certificat lui-même. En revanche, le certificat ne peut plus être utilisé par Lync Server, ses liaisons sont supprimées et les autorisations d’accès sont annulées (à condition qu’aucun autre service n’utilise le certificat). Cela signifie notamment que le certificat n’apparaîtra plus lorsque vous exécuterez la cmdlet Get-CsCertificate.

Pour réutiliser le certificat avec Lync Server, vous devrez réattribuer le certificat à Lync Server 2010 à l’aide de la cmdlet Set-CsCertificate.

Si vous essayez de supprimer un certificat en cours d’utilisation, vous serez invité à confirmer sa suppression pour que la cmdlet Remove-CsCertificate puisse être exécutée. Pour ignorer cette invite et supprimer un certificat sans assistance, même s’il est utilisé, ajoutez le paramètre Force à votre commande :

Remove-CsCertificate –Type WebServicesExternal -Force

Personnes autorisées à exécuter cette cmdlet : Vous devez être un administrateur local et un membre du domaine pour pouvoir exécuter localement la cmdlet Remove-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 "Remove-CsCertificate"}

Paramètres

Paramètre Obligatoire Type Description

Type

Facultatif

Chaîne

Type de certificat à supprimer. Les types de certificats incluent notamment :

AccessEdgeExternal

AudioVideoAuthentication

DataEdgeExternal

Default

External

Internal

PICWebService (Microsoft Lync Online 2010 uniquement)

ProvisionService (Microsoft Lync Online 2010 uniquement)

WebServicesExternal

WebServicesInternal

WsFedTokenTransfer

L’exemple suivant supprime le certificat Default : -Type Default.

Vous pouvez supprimer 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.

Force

Facultatif

Paramètre de commutateur

Ignore l’invite de confirmation qui s’affiche généralement lorsque vous essayez de supprimer un certificat en cours d’utilisation.

Report

Facultatif

Chaîne

Permet d’enregistrer des informations détaillées sur les procédures exécutées par la cmdlet Remove-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.

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. Remove-CsCertificate n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

Aucun. Remove-CsCertificate supprime les instances de l’objet Microsoft.Rtc.Management.Deployment.CertificateReference.

Exemple

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

Remove-CsCertificate -Type WebServicesExternal

La commande de l’exemple 1 supprime tous les certificats WebServicesExternal pouvant être utilisés par Lync Server. Si l’un de ces certificats est utilisé, vous serez invité à confirmer sa suppression pour que la cmdlet Remove-CsCertificate puisse être exécutée. Pour ignorer l’invite de confirmation, utilisez le paramètre Force :

Remove-CsCertificate –Type WebServicesExternal -Force