• Artikel

Set-CsCertificate

 

Letztes Änderungsdatum des Themas: 2012-03-26

Ermöglicht die Zuweisung von Zertifikaten zu Microsoft Lync Server 2010-Servern oder -Serverrollen.

Syntax

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>]]

Detaillierte Beschreibung

Mit Zertifikaten können Server und Serverrollen in Lync Server 2010 ihre Identitätswerte überprüfen. Beispielsweise überprüft ein Edgeserver mithilfe von Zertifikaten, ob der Computer, mit dem er kommuniziert, tatsächlich ein Front-End-Server ist (und umgekehrt). Für eine vollständige Implementierung von Lync Server müssen den Serverrollen die entsprechenden Zertifikate zugewiesen werden.

Mit dem Cmdlet Set-CsCertificate können Administratoren Servern oder Serverrollen Zertifikate zuweisen. Beachten Sie, dass nur Zertifikate zugewiesen werden können, die bereits für die Verwendung mit Lync Server konfiguriert wurden. Zur Ermittlung der für die Zuweisung verfügbaren Zertifikate verwenden Sie das Cmdlet Get-CsCertificate.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Sie müssen ein lokaler Administrator sein, um das Cmdlet Set-CsCertificate lokal ausführen zu können. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):

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

Parameter

Parameter Erforderlich Typ Beschreibung

NetportId

Optional

Zeichenfolge

Für die zukünftige Verwendung reserviert. Dieser Parameter ist für Zertifikate für einen spezifischen Port vorbehalten und wird noch nicht von Lync Server unterstützt.

Reference

Optional

CertificateReference-Objekt

Objektverweis auf ein für die Verwendung mit Lync Server konfiguriertes Zertifikat. Über den folgenden Befehl wird ein Objektverweis (die Variable "$x") zurückgegeben, der ein Zertifikat mit dem Fingerabdruck "B142918E463981A76503828BB1278391B716280987B" darstellt:

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

Thumbprint

Optional

Zeichenfolge

Eindeutige ID für das Zertifikat. Der Fingerabdruck eines Zertifikats kann wie folgt aussehen: B142918E463981A76503828BB1278391B716280987B.

Type

Optional

Zeichenfolge

Zugewiesener Zertifikatstyp. Zu den Zertifikatstypen gehören u. a. die folgenden:

AccessEdgeExternal

AudioVideoAuthentication

DataEdgeExternal

Default

External

Internal

iPhoneAPNService

iPadAPNService

MPNService

PICWebService (nur Microsoft Lync Online 2010)

ProvisionService (nur Microsoft Lync Online 2010)

WebServicesExternal

WebServicesInternal

WsFedTokenTransfer

Mit dieser Syntax wird beispielsweise das Standardzertifikat zugewiesen: -Type Default.

Sie können in einem einzelnen Befehl mehrere Typen angeben, indem Sie die Zertifikatstypen durch Kommata abtrennen:

-Type Internal,External,Default

Force

Optional

Switch-Parameter

Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können.

Report

Optional

Zeichenfolge

Ermöglicht die Aufzeichnung ausführlicher Informationen zu den von Set-CsCertificate ausgeführten Verfahren. Der Parameterwert sollte den vollständigen Pfad zur HTML-Datei enthalten, die generiert werden soll. Beispiel: -Report C:\Logs\Certificates.html. Wenn die angegebene Datei bereits vorhanden ist, wird sie automatisch mit den neuen Informationen überschrieben.

WhatIf

Optional

Switch-Parameter

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Confirm

Optional

Switch-Parameter

Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf.

Eingabetypen

Microsoft.Rtc.Management.Deployment.CertificateReference.

Rückgabetypen

Set-CsCertificate gibt keine Werte oder Objekte zurück.

Beispiel

-------------------------- Beispiel 1 ------------------------

Set-CsCertificate -Type WebServicesExternal -Thumbprint "B142918E463981A76503828BB1278391B716280987B"

Über den Befehl in Beispiel 1 wird das Zertifikat mit dem Fingerabdruck "B142918E463981A76503828BB1278391B716280987B" der Rolle "WebServicesExternal" auf dem lokalen Computer zugewiesen.

-------------------------- Beispiel 2 ------------------------

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

Über den vorstehenden Befehl wird das Zertifikat mit dem Fingerabdruck "B142918E463981A76503828BB1278391B716280987B" drei verschiedenen Rollen auf dem lokalen Computer zugewiesen: "Default", "WebServicesInternal" und "WebServicesExternal".