Condividi tramite

  • Articolo

Set-CsCertificate

 

Ultima modifica dell'argomento: 2012-03-26

Consente di assegnare un certificato ad un server Microsoft Lync Server 2010 o ad un ruolo del server.

Sintassi

Set-CsCertificate -Reference <CertificateReference> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-NetportId <String>] [-Report <String>] [-Type <CertType[]>] [-WhatIf [<SwitchParameter>]]

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

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 stanno 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 Set-CsCertificate consente agli amministratori di assegnare un certificato ad un server o ruolo del server. Si noti che è possibile assegnare solo i certificati già configurati per l'utilizzo con Lync Server. Per identificare i certificati disponibili per l'assegnazione, utilizzare il cmdlet Get-CsCertificate.

Utenti autorizzati a utilizzare questo cmdlet: È necessario essere amministratori locali per poter utilizzare localmente il cmdlet Set-CsCertificate. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

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.

Reference

Facoltativo

Oggetto CertificateReference

Riferimento oggetto ad un certificato configurato per l'utilizzo con Lync Server. Il comando seguente restituisce un riferimento oggetto (la variabile $x) che rappresenta un certificato con l'identificazione personale (Thumbprint) B142918E463981A76503828BB1278391B716280987B:

$x = Get-CsCertificate | Where-Object {$_.Thumbprint –eq "B142918E463981A76503828BB1278391B716280987B".

Thumbprint

Facoltativo

Stringa

Identificatore univoco del certificato. L'identificazione personale (Thumbprint) di un certificato è simile a quella seguente: B142918E463981A76503828BB1278391B716280987B.

Type

Facoltativo

Stringa

Tipo di certificato da assegnare. 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, con questa sintassi si assegna il certificato Default: -Type Default.

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

-Type Internal,External,Default

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando.

Report

Facoltativo

Stringa

Consente di registrare informazioni dettagliate sulle procedure eseguite dal cmdlet Set-CsCertificate. Il valore del parametro deve essere il percorso completo del file HTML da creare, 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

Microsoft.Rtc.Management.Deployment.CertificateReference

Tipi restituiti

Set-CsCertificate non restituisce alcun oggetto o valore.

Esempio

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

Set-CsCertificate -Type WebServicesExternal -Thumbprint "B142918E463981A76503828BB1278391B716280987B"

Il comando riportato nell'Esempio 1 consente di assegnare il certificato con Thumbprint B142918E463981A76503828BB1278391B716280987B al ruolo WebServicesExternal sul computer locale.

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

Set-CsCertificate -Type Default, WebServicesInternal, WebServicesExternal -Thumbprint "B142918E463981A76503828BB1278391B716280987B"

Il comando precedente consente di assegnare il certificato con Thumbprint B142918E463981A76503828BB1278391B716280987B a tre diversi ruoli sul computer locale: Default, WebServicesInternal e WebServicesExternal.