Condividi tramite

  • Articolo

Get-CsCertificate

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce informazioni sui certificati presenti sui computer locali e configurati per l'utilizzo con Microsoft Lync Server 2010.

Sintassi

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

Descrizione dettagliata

Lync Server 2010 utilizza i certificati come strumento per consentire ai server e ai ruoli del server di verificare la propria identità; ad esempio Edge Server utilizza i certificati per verificare che il computer con cui sta comunicando sia effettivamente un server Front End e viceversa. Per implementare Lync Server, è necessario che ai ruoli del server siano stati assegnati i certificati appropriati.

Il cmdlet Get-CsCertificate consente di recuperare informazioni dettagliate sui certificati configurati per essere utilizzati con Lync Server. Si noti che questo cmdlet restituisce informazioni solo sui certificati di Lync Server. Se un certificato non è stato configurato per essere utilizzato con Lync Server (tramite il cmdletSet-CsCertificate) non verrà restituito quando si esegue il cmdlet Get-CsCertificate.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsCertificate può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins.

Parametri

Parametro Obbligatorio Tipo Descrizione

Type

Facoltativo

Stringa

Tipo di certificato richiesto. Di seguito sono elencati alcuni, non tutti i tipi di certificati:

AccessEdgeExternal

AudioVideoAuthentication

DataEdgeExternal

Default

External

Internal

iPhoneAPNService

iPadAPNService

MPNService

PICWebService (solo Microsoft Lync Online 2010)

ProvisionService (solo Microsoft Lync Online 2010)

WebServicesExternal

WebServicesInternal

WsFedTokenTransfer

Ad esempio, questa sintassi restituisce informazioni relative al certificato Default: -Type Default.

È possibile specificare più tipi in un singolo comando separando i tipi di certificato con virgole:

-Type Internal,External,Default

NetportId

Facoltativo

Stringa

Riservato per utilizzi futuri. Questo parametro si applica ai certificati dedicati a una porta specifica, ma questo scenario non è ancora supportato da Lync Server.

Report

Facoltativo

Stringa

Consente di registrare informazioni dettagliate sulle procedure eseguite dal cmdlet Get-CsCertificate. Il valore del parametro deve essere il percorso completo del file HTML che verrà creato, ad esempio: -Report C:\Logs\Certificates.html. Se il file specificato esiste già, verrà automaticamente sovrascritto con le nuove informazioni.

Tipi di input

Nessuno. Get-CsCertificate non accetta input tramite pipeline.

Tipi restituiti

Get-CsCertificate restituisce le istanze dell'oggetto Microsoft.Rtc.Management.Deployment.CertificateReference.

Esempio

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

Get-CsCertificate

Il comando riportato nell'Esempio 1 restituisce le informazioni sui certificati correntemente assegnati ai componenti di Lync Server. Per ottenere questo risultato, viene utilizzato il cmdlet Get-CsCertificate senza alcun parametro aggiuntivo.

-------------------------- Esempio 2 ------------------------

Get-CsCertificate -Type WebServicesInternal

L'Esempio 2 consente di recuperare tutti i certificati di Lync Server utilizzati per i servizi Web interni. Per ottenere questo risultato, viene incluso il parametro Type insieme al valore WebServicesInternal.

-------------------------- Esempio 3 ------------------------

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

Il comando precedente restituisce tutti i certificati di Lync Server che scadono prima del 1 settembre 2011. Per eseguire questa operazione, il comando utilizza prima il cmdlet Get-CsCertificate per ottenere una raccolta di tutti i certificati di Lync Server attualmente utilizzati. Questa raccolta viene inviata tramite pipe al cmdlet Where-Object che seleziona solo quei certificati che scadono prima del 1 settembre 2011. La data specificata in questo esempio (9/1/2011) utilizza il formato inglese U.S. per i valori di data e ora. La data deve essere specificata utilizzando il formato compatibile con le proprie opzioni di lingua e impostazioni internazionali.

-------------------------- Esempio 4 ------------------------

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

Nell'Esempio 4 vengono restituite tutte le informazioni sui certificati di Lync Server emessi dall'autorità di certificazione MyCa. Per ottenere questo risultato, il comando utilizza prima il cmdlet Get-CsCertificate senza alcun parametro aggiuntivo in modo da ottenere una raccolta di tutti i certificati attualmente in uso. La raccolta così ottenuta viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona solo quei certificati in cui la proprietà Issuer è uguale a (-eq) "Cn=MyCa".

-------------------------- Esempio 5 ------------------------

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

Il comando riportato nell'Esempio 5 restituisce tutti i certificati di Lync Server in cui la proprietà Subject è stata impostata su atl-cs-001.litwareinc.com. Per ottenere questo risultato, viene utilizzato il cmdlet Get-CsCertificate per ottenere una raccolta di tutti i certificati di Lync Server che viene quindi inviata tramite pipe al cmdlet Where-Object. A sua volta, il cmdlet Where-Object seleziona solo quei certificati in cui la proprietà Subject è uguale ad "CN=atl-cs-001.litwareinc.com".