Configurar Certificados de Serviço usando cmdlets do Windows Server AppFabric

Artigo
12/05/2011

Este tópico descreve como configurar certificados de segurança para um aplicativo ou um serviço usando os cmdlets AppFabric.

Para executar interativamente um cmdlet de AppFabric, abra o console do Windows PowerShell para AppFabric, insira o cmdlet adequado e pressione ENTER. Para obter mais informações sobre a execução de cmdlets, consulte Executando cmdlets do Windows Server AppFabric.

Para definir o certificado de segurança

No console do Windows PowerShell, execute o cmdlet Set-ASAppServiceCertificate para definir um certificado para ser usado por um serviço se o serviço tiver algum ponto de extremidade seguro que exija um certificado. Com esse cmdlet, não há validação de que o certificado de serviço seja necessário para um ponto de extremidade de serviço. Não há validação também de que o certificado selecionado existe.

Opções de sintaxe para Set-ASAppServiceCertificate:

Sintaxe 1

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

Sintaxe 2

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

Sintaxe 3

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

Sintaxe 4

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

Sintaxe 5

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

Parâmetro	Descrição
[-SiteName] <String> [[-VirtualPath] <String>]. [-Uri] <Uri>, -ApplicationObject <ApplicationInfo> ou -ServiceObject <ServiceInfo>	Escopo operacional do cmdlet que resolve a um serviço.
-FindValue	Obrigatório. O valor de pesquisa de um certificado que será usado para autenticação de serviço e assinatura.
–StoreLocation	Opcional. LocalMachine ou CurrentUser
- StoreName	Opcional. Os valores permitidos incluem AddressBook, AuthRoot, CertificateAuthority, Disallowed, My, Root, TrustedPeople e TrustedPublisher.
-X509FindType	Opcional. Os valores permitidos incluem FindByThumbprint, FindBySubjectName, FindBySubjectDistinguishedName, FindByIssuerName, FindByIssuerDistinguishedName, FindBySerialNumber, FindByTimeValid, FindByTimeNotYetValid, FindByTemplateName, FindByApplicationPolicy, FindByCertificatePolicy, FindByExtension, FindByKeyUsage, e FindBySubjectKeyIdentifier.
-CertificateNavigationProviderItem	Opcional. Se estiver especificado, usa o certificado especificado por esse objeto para o serviço especificado na linha de comando.
-UseInherited	Se estiver especificado, o certificado em uso não é definido localmente, mas preferencialmente herdado de um nível pai. Por exemplo, se um certificado for definido no escopo do site e um outro certificado for definido no escopo do aplicativo, você poderá ir até o escopo do aplicativo e executar o Set-ASAppServiceCertificate –UseInherited para garantir que esse certificado não seja mais definido no escopo do aplicativo (significando que o certificado definido no escopo do site seria herdado).

Para obter o certificado de segurança

No console do Windows PowerShell, execute o cmdlet Get-ASAppServiceCertificate para recuperar as informações pelas quais um certificado está alocado para o uso com pontos de extremidade seguros do serviço. Esse cmdlet retorna Null ou um objeto ServiceCertificateInfo descrevendo o certificado de serviço.

Opções de sintaxe de Get-ASAppServiceCertificate: