Konfigurieren von Dienstzertifikaten mithilfe von Windows Server AppFabric-Cmdlets

Artikel
12/05/2011

In diesem Thema wird beschrieben, wie Sicherheitszertifikate für eine Webanwendung oder einen Dienst mithilfe von AppFabric-Cmdlets konfiguriert werden.

Wenn Sie ein AppFabric-Cmdlet interaktiv ausführen möchten, öffnen Sie die Windows PowerShell-Konsole für AppFabric, geben das entsprechende Cmdlet ein und drücken dann die EINGABETASTE. Weitere Informationen zum Ausführen von Cmdlets finden Sie unter Ausführen von Windows Server AppFabric-Cmdlets.

So legen Sie das Sicherheitszertifikat fest

Führen Sie in der Windows PowerShell-Konsole das Cmdlet Set-ASAppServiceCertificate aus, um ein vom Dienst zu verwendendes Zertifikat festzulegen, wenn der Dienst sichere Endpunkte aufweist, die ein Zertifikat erfordern. Bei diesem Cmdlet findet keine Überprüfung statt, ob das Dienstzertifikat von einem Dienstendpunkt benötigt wird. Es findet auch keine Überprüfung statt, ob das ausgewählte Zertifikat vorhanden ist.

Syntaxoptionen für Set-ASAppServiceCertificate:

Syntax 1

Set-ASAppServiceCertificate [-SiteName] <String> [[-VirtualPath] <String>] [-FindType <X509FindType>] [-FindValue <String>] [-StoreLocation <StoreLocation>] [-StoreName <StoreName>] [-UseInherited] [<CommonParameters>]

Syntax 2

Set-ASAppServiceCertificate [-Uri] <Uri> [-FindType <X509FindType>] [-FindValue <String>] [-StoreLocation <StoreLocation>] [-StoreName <StoreName>] [-UseInherited] [<CommonParameters>]

Syntax 3

Set-ASAppServiceCertificate -ApplicationObject <ApplicationInfo> [-FindType <X509FindType>] [-FindValue <String>] [-StoreLocation <StoreLocation>] [-StoreName <StoreName>] [-UseInherited] [<CommonParameters>]

Syntax 4

Set-ASAppServiceCertificate -ServiceObject <ServiceInfo> [-FindType <X509FindType>] [-FindValue <String>] [-StoreLocation <StoreLocation>] [-StoreName <StoreName>] [-UseInherited] [<CommonParameters>]

Syntax 5

Set-ASAppServiceCertificate [-FindType <X509FindType>] [-FindValue <String>] [-Root] [-StoreLocation <StoreLocation>] [-StoreName <StoreName>] [-UseInherited] [<CommonParameters>]

Parameter	Beschreibung
[-SiteName] <Zeichenfolge> [[-VirtualPath] <Zeichenfolge>]. [-Uri] <Uri>, -ApplicationObject <AnwendungsInfo> oder -ServiceObject <DienstInfo>	Betriebsbereich des Cmdlets, der in einen Dienst aufgelöst wird.
-FindValue	Erforderlich. Der Nachschlagewert des Zertifikats, das für die Dienstauthentifizierung und -signierung verwendet wird.
-StoreLocation	Optional. LocalMachine oder CurrentUser.
-StoreName	Optional. Zulässige Werte sind AddressBook, AuthRoot, CertificateAuthority, Disallowed, My, Root, TrustedPeople und TrustedPublisher.
-X509FindType	Optional. Zulässige Werte sind FindByThumbprint, FindBySubjectName, FindBySubjectDistinguishedName, FindByIssuerName, FindByIssuerDistinguishedName, FindBySerialNumber, FindByTimeValid, FindByTimeNotYetValid, FindByTemplateName, FindByApplicationPolicy, FindByCertificatePolicy, FindByExtension, FindByKeyUsage und FindBySubjectKeyIdentifier.
-CertificateNavigationProviderItem	Optional. Wenn dieser Parameter angegeben wird, wird das durch dieses Objekt angegebene Zertifikat für den in der Befehlszeile angegebenen Dienst verwendet.
-UseInherited	Wenn dieser Parameter angegeben wird, ist das in Gebrauch befindliche Zertifikat nicht lokal definiert, sondern wird von einer übergeordneten Ebene geerbt. Wenn ein Zertifikat z. B. im Sitebereich definiert ist, und ein anderes Zertifikat im Anwendungsbereich definiert ist, können Sie in den Anwendungsbereich navigieren und Set-ASAppServiceCertificate -UseInherited ausführen, damit sichergestellt ist, dass das Zertifikat nicht mehr im Anwendungsbereich definiert ist (dies bedeutet, dass das im Sitebereich definierte Zertifikat geerbt wird).

So rufen Sie das Sicherheitszertifikat ab

Führen Sie in der Windows PowerShell-Konsole das Cmdlet Get-ASAppServiceCertificate aus, um die Informationen abzurufen, durch die ein Zertifikat für den Gebrauch durch die sicheren Endpunkte eines Diensts ermittelt wird. Dieses Cmdlet gibt Null oder ein ServiceCertificateInfo-Objekt zurück, das das Dienstzertifikat beschreibt.

Syntaxoptionen für Get-ASAppServiceCertificate: