Condividi tramite

  • Articolo

Remove-CsCertificate

 

Ultima modifica dell'argomento: 2012-03-26

Rimuove un certificato precedentemente contrassegnato come disponibile per l'uso da Microsoft Lync Server 2010.

Sintassi

Remove-CsCertificate [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-NetportId <String>] [-Report <String>] [-Type <CertType[]>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

In Lync Server 2010 vengono utilizzati i certificati come mezzo per verificare le identità di server e ruoli del server. Un server Edge Server ad esempio si basa sui certificati per verificare che il computer con cui sta comunicando sia realmente un server Front End e viceversa. Per implementare completamente Lync Server, è necessario che ai ruoli del server siano stati assegnati i certificati appropriati.

Il cmdlet Remove-CsCertificate consente di rimuovere i certificati attualmente in uso da parte di Lync Server. Remove-CsCertificate non elimina effettivamente il certificato stesso, ma lo contrassegna come non più disponibile per l'utilizzo da parte di Lync Server. Rimuove inoltre gli eventuali binding del certificato e revoca le autorizzazioni di accesso al certificato (presupponendo che il certificato non sia utilizzato da altri servizi). Il certificato tra l'altro non verrà più visualizzato quando si esegue il cmdlet Get-CsCertificate.

Per utilizzare nuovamente il certificato con Lync Server, sarà necessario riassegnarlo a Lync Server 2010 utilizzando il cmdlet Set-CsCertificate.

Se si tenta di rimuovere un certificato attualmente in uso, Remove-CsCertificate visualizzerà un messaggio in cui viene chiesto di confermare la rimozione. Il certificato non verrà rimosso se non si fornirà una risposta al messaggio visualizzato. Per disabilitare la visualizzazione del messaggio di conferma ed eliminare un certificato automaticamente, anche se in uso, aggiungere il parametro Force al comando:

Remove-CsCertificate –Type WebServicesExternal -Force

Utenti autorizzati a eseguire il cmdlet: possono eseguire localmente il cmdlet Remove-CsCertificate solo gli amministratori locali e i membri del dominio. Per restituire un elenco di tutti i ruoli RBAC a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Type

Facoltativo

Stringa

Tipo di certificato da eliminare. I tipi di certificato includono (in via esemplificativa):

AccessEdgeExternal

AudioVideoAuthentication

DataEdgeExternal

Default

External

Internal

PICWebService (solo Microsoft Lync Online 2010)

ProvisionService (solo Microsoft Lync Online 2010)

WebServicesExternal

WebServicesInternal

WsFedTokenTransfer

La seguenti sintassi ad esempio elimina il certificato Default: -Type Default.

È possibile eliminare più tipi di certificati con un unico comando separandoli con le virgole:

-Type Internal,External,Default

NetportId

Facoltativo

Stringa

Riservato per utilizzi futuri. Questo parametro è destinato a certificati dedicati a una porta specifica, scenario non supportato da Lync Server.

Force

Facoltativo

Parametro opzionale

Disabilita la visualizzazione della richiesta di conferma che viene generalmente visualizzata quando si tenta di eliminare un certificato attualmente in uso.

Report

Facoltativo

Stringa

Consente di registrare informazioni dettagliate sulle procedure effettuate da Remove-CsCertificate. Il valore del parametro deve essere il percorso completo al file HTML da generare, ad esempio: -Report C:\Logs\Certificates.html. Se il file specificato esiste già, verrà automaticamente sovrascritto con le nuove informazioni.

WhatIf

Facoltativo

Parametro opzionale

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Confirm

Facoltativo

Parametro opzionale

Viene visualizzata una richiesta di conferma prima di eseguire il comando.

Tipi di input

Nessuno. Remove-CsCertificate does not accept pipelined input.

Tipi restituiti

Nessuno. Remove-CsCertificate piuttosto elimina le istanze dell'oggetto Microsoft.Rtc.Management.Deployment.CertificateReference.

Esempio

-------------------------- Esempio 1 ------------------------

Remove-CsCertificate -Type WebServicesExternal

Il comando riportato nell'esempio 1 elimina tutti i certificati WebServicesExternal disponibili per Lync Server. Se uno di questi certificati è attualmente in uso, Remove-CsCertificate visualizzerà un messaggio di conferma di rimozione del certificato. Il comando verrà eseguito solo dopo che l'utente avrà risposto al messaggio di richiesta. Per disabilitare la visualizzazione della richiesta di conferma, utilizzare il parametro Force:

Remove-CsCertificate –Type WebServicesExternal -Force