使用 Windows Server AppFabric Cmdlet 來設定服務憑證
此主題說明如何使用 AppFabric Cmdlet 為應用程式或服務設定安全性憑證。
若要以互動方式執行 AppFabric Cmdlet,請開啟 AppFabric 的 Windows PowerShell 主控台,輸入適當的 Cmdlet,然後按下 ENTER。如需有關執行 Cmdlet 的詳細資訊,請參閱執行 Windows Server AppFabric Cmdlet。
設定安全性憑證
在 Windows PowerShell 主控台中,執行 Set-ASAppServiceCertificate Cmdlet,以設定將由服務使用的憑證 (若服務有任何需要憑證的安全端點)。使用此 Cmdlet 時,系統不會驗證服務端點是否需要服務憑證,也不會驗證選取的憑證是否存在。
Set-ASAppServiceCertificate 的語法選項:
語法 1
Set-ASAppServiceCertificate [-SiteName] <String> [[-VirtualPath] <String>] [-FindType <X509FindType>] [-FindValue <String>] [-StoreLocation <StoreLocation>] [-StoreName <StoreName>] [-UseInherited] [<CommonParameters>]
語法 2
Set-ASAppServiceCertificate [-Uri] <Uri> [-FindType <X509FindType>] [-FindValue <String>] [-StoreLocation <StoreLocation>] [-StoreName <StoreName>] [-UseInherited] [<CommonParameters>]
語法 3
Set-ASAppServiceCertificate -ApplicationObject <ApplicationInfo> [-FindType <X509FindType>] [-FindValue <String>] [-StoreLocation <StoreLocation>] [-StoreName <StoreName>] [-UseInherited] [<CommonParameters>]
語法 4
Set-ASAppServiceCertificate -ServiceObject <ServiceInfo> [-FindType <X509FindType>] [-FindValue <String>] [-StoreLocation <StoreLocation>] [-StoreName <StoreName>] [-UseInherited] [<CommonParameters>]
語法 5
Set-ASAppServiceCertificate [-FindType <X509FindType>] [-FindValue <String>] [-Root] [-StoreLocation <StoreLocation>] [-StoreName <StoreName>] [-UseInherited] [<CommonParameters>]
參數 | 描述 |
---|---|
[-SiteName] <字串> [[-VirtualPath] <字串>].[-Uri] <Uri>, -ApplicationObject <應用程式資訊> 或 -ServiceObject <服務資訊> |
解析為服務之 Cmdlet 的操作範圍。 |
-FindValue |
必要。將用於服務驗證與簽署之憑證的查閱值。 |
–StoreLocation |
可省略。LocalMachine 或 CurrentUser |
- StoreName |
可省略。允許的值包括 AddressBook、AuthRoot、CertificateAuthority、Disallowed、My、Root、TrustedPeople 與 TrustedPublisher。 |
-X509FindType |
可省略。允許的值包括 FindByThumbprint、FindBySubjectName、FindBySubjectDistinguishedName、FindByIssuerName、FindByIssuerDistinguishedName、FindBySerialNumber、FindByTimeValid、FindByTimeNotYetValid、FindByTemplateName、FindByApplicationPolicy、FindByCertificatePolicy、FindByExtension、FindByKeyUsage 與 FindBySubjectKeyIdentifier。 |
-CertificateNavigationProviderItem |
可省略。若指定此參數,會為在命令列指定的服務使用此物件所指定的憑證。 |
-UseInherited |
若指定此參數,不會在本機定義使用的憑證,而是會從父等級繼承。例如,若某個憑證在網站範圍定義,而另一個憑證是在應用程式範圍定義,則您可以移至應用程式等級並執行 Set-ASAppServiceCertificate –UseInherited,以確保憑證不再於應用程式範圍定義 (表示將繼承在網站範圍定義的憑證)。 |
取得安全性憑證
在 Windows PowerShell 主控台中,執行 Get-ASAppServiceCertificate Cmdlet,以擷取將由服務的安全端點使用之憑證的詳細資訊。此 Cmdlet 會傳回 Null 或說明服務憑證的 ServiceCertificateInfo 物件。
Get-ASAppServiceCertificate 的語法選項:
語法 1
Get-ASAppServiceCertificate [-SiteName] <String> [[-VirtualPath] <String>] [<CommonParameters>]
語法 2
Get-ASAppServiceCertificate [-Uri] <Uri> [<CommonParameters>]
語法 3
Get-ASAppServiceCertificate -ApplicationObject <ApplicationInfo> [<CommonParameters>]
語法 4
Get-ASAppServiceCertificate -ServiceObject <ServiceInfo> [<CommonParameters>]
語法 5
Get-ASAppServiceCertificate [-Root] [<CommonParameters>]
參數 | 描述 |
---|---|
[-SiteName] <字串> [[-VirtualPath] <字串>].[-Uri] <Uri>, -ApplicationObject <應用程式資訊>, -ServiceObject <服務資訊>. 或 -Root |
解析為服務之 Cmdlet 的操作範圍。 |
2011-12-05