Windows Server AppFabric コマンドレットを使用したサービス証明書の構成

[アーティクル]
12/05/2011

このトピックでは、AppFabric コマンドレットを使用して、アプリケーションまたはサービスのセキュリティ証明書を構成する方法について説明します。

AppFabric コマンドレットを対話的に実行するには、AppFabric 用の Windows PowerShell コンソールを開き、適切なコマンドレットを入力し、Enter キーを押します。コマンドレットの実行の詳細については、「Windows Server AppFabric コマンドレットの実行」を参照してください。

セキュリティ証明書を設定するには

Windows PowerShell コンソールで、Set-ASAppServiceCertificate コマンドレットを実行し、サービスに証明書の必要なセキュリティで保護されたエンドポイントがある場合にサービスが使用する証明書を設定します。このコマンドレットでは、サービスエンドポイントがサービス証明書を必要とするかどうかは検証されません。選択した証明書が存在するかどうかの検証も行われません。

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] <String> [[-VirtualPath] <String>]、[-Uri] <Uri>、-ApplicationObject <ApplicationInfo>、または -ServiceObject <ServiceInfo>	サービスに解決されるコマンドレットの操作スコープ。
-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 コマンドレットを実行し、サービスのセキュリティで保護されたエンドポイントで使用する証明書を特定するための情報を取得します。このコマンドレットは、Null またはサービス証明書が記述されている ServiceCertificateInfo オブジェクトを返します。

Get-ASAppServiceCertificate の構文オプションは次のとおりです。