Condividi tramite

  • Articolo

Import-CsCertificate

 

Ultima modifica dell'argomento: 2012-03-23

Importa un certificato da utilizzare con Microsoft Lync Server 2010. Se il certificato non viene acquisito mediante il cmdlet Request-CsCertificate, è necessario importarlo prima di poterlo assegnare a un ruolo del server di Lync Server 2010.

Sintassi

Import-CsCertificate -Path <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Password <String>] [-PrivateKeyExportable <$true | $false>] [-Report <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Lync Server 2010 utilizza i certificati come mezzo per verificare le identità di server e ruoli del server; ad esempio, un Edge Server utilizza i certificati per verificare che il computer con cui sta comunicando sia realmente un server Front End (e viceversa). Per implementare completamente Lync Server è necessario assegnare i certificati appropriati ai ruoli del server.

Per assegnare i certificati a un ruolo di Lync Server, è necessario che i certificati siano noti a Lync Server. Il cmdlet Request-CsCertificate consente di effettuare richieste online e offline di nuovi certificati. Se viene effettuata una richiesta online, il certificato viene automaticamente scaricato e salvato nell'archivio certificati locale e diventa immediatamente disponibile per l'uso da parte di Lync Server 2010. Se viene effettuata una richiesta offline, l'utente riceverà un file di certificato. Si potrà quindi utilizzare Import-CsCertificate per importare il certificato, affinché sia disponibile per l'assegnazione a un ruolo del server Lync Server.

Utenti che possono eseguire questo cmdlet: il cmdlet Import-CsCertificate può essere eseguito in locale solo dagli amministratori locali. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Path

Obbligatorio

Stringa

Percorso completo del file di certificato da importare. Ad esempio: -Path "C:\Certificates\WebServer.cer".

Password

Facoltativo

Stringa

Password associata al file di certificato.

PrivateKeyExportable

Facoltativo

Booleano

Se l'impostazione è True, consente di garantire che la parte relativa alla chiave privata del certificato possa essere letta dall'account Servizio di rete.

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 specificare un percorso per il file di registro creato durante l'esecuzione del cmdlet. Ad esempio: -Report "C:\Logs\Certificates.html"

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. Import-CsCertificate non accetta l'input da pipeline.

Tipi restituiti

Nessuno.

Esempio

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

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

Con il comando mostrato nell'esempio 1 viene importato il certificato C:\Certificates\WebServer.cer. Al completamento del comando, il certificato diventa disponibile per l'assegnazione a un ruolo del server.