Configurare i certificati dei servizi tramite il cmdlet di AppFabric

In questo argomento viene descritto come configurare i certificati di protezione per un'applicazione o un servizio mediante i cmdlet di AppFabric.

Per eseguire un cmdlet di AppFabric in modo interattivo, aprire la console Windows PowerShell per AppFabric, immettere il cmdlet appropriato e premere INVIO. Per ulteriori informazioni sull'esecuzione dei cmdlet, vedere Esecuzione dei cmdlet di AppFabric.

Per impostare il certificato di protezione

Nella console Windows PowerShell, eseguire il cmdlet Set-ASAppServiceCertificate per impostare un certificato in modo che venga utilizzato da un servizio se il servizio dispone di endpoint protetti che richiedono un certificato. Se si utilizza questo cmdlet, non esiste una convalida per accertare che il certificato sia necessario per un endpoint di servizio. Inoltre, non esiste una convalida per accertare che il certificato selezionato esista.

Opzioni di sintassi per Set-ASAppServiceCertificate:

Sintassi 1

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

Sintassi 2

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

Sintassi 3

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

Sintassi 4

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

Sintassi 5

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

[-SiteName] <String> [[-VirtualPath] <String>]. [-Uri] <Uri>, -ApplicationObject <ApplicationInfo> oppure -ServiceObject <ServiceInfo>

Ambito operativo del cmdlet che si risolve in un servizio.

-FindValue

Obbligatorio. Valore di ricerca del certificato che verrà utilizzato per l'autenticazione e la firma del servizio.

–StoreLocation

Facoltativo. LocalMachine o CurrentUser

- StoreName

Facoltativo. I valori consentiti includono AddressBook, AuthRoot, CertificateAuthority, Disallowed, My, Root, TrustedPeople e TrustedPublisher.

-X509FindType

Facoltativo. I valori consentiti includono FindByThumbprint, FindBySubjectName, FindBySubjectDistinguishedName, FindByIssuerName, FindByIssuerDistinguishedName, FindBySerialNumber, FindByTimeValid, FindByTimeNotYetValid, FindByTemplateName, FindByApplicationPolicy, FindByCertificatePolicy, FindByExtension, FindByKeyUsage e FindBySubjectKeyIdentifier.

-CertificateNavigationProviderItem

Facoltativo. Se specificato, utilizza il certificato specificato da questo oggetto per il servizio specificato nella riga di comando.

-UseInherited

Se specificato, il certificato in uso non viene definito localmente, ma viene ereditato da un livello padre. Ad esempio, se un certificato viene definito nell'ambito del sito e un altro certificato viene definito nell'ambito dell'applicazione, è possibile eseguire Set-ASAppServiceCertificate –UseInherited nell'ambito dell'applicazione per accertarsi che il certificato non sia più definito nell'ambito dell'applicazione (indicando dunque che deve essere ereditato il certificato nell'ambito del sito).

Per ottenere il certificato di protezione

Nella console Windows PowerShell, eseguire il cmdlet Get-ASAppServiceCertificate per richiamare le informazioni per mezzo delle quali un certificato viene individuato per essere utilizzato dagli endpoint protetti di un servizio. Il cmdlet restituisce Null oppure un oggetto ServiceCertificateInfo che descrive il certificato del servizio.

Opzioni di sintassi per Get-ASAppServiceCertificate:

Sintassi 1

Get-ASAppServiceCertificate [-SiteName] <String> [[-VirtualPath] <String>] [<CommonParameters>]

Sintassi 2

Get-ASAppServiceCertificate [-Uri] <Uri> [<CommonParameters>]

Sintassi 3

Get-ASAppServiceCertificate -ApplicationObject <ApplicationInfo> [<CommonParameters>]

Sintassi 4

Get-ASAppServiceCertificate -ServiceObject <ServiceInfo> [<CommonParameters>]

Sintassi 5

Get-ASAppServiceCertificate [-Root] [<CommonParameters>]
Parametro Descrizione

[-SiteName] <String> [[-VirtualPath] <String>]. [-Uri] <Uri>, -ApplicationObject <ApplicationInfo>, -ServiceObject <ServiceInfo>. oppure -Root

Ambito operativo del cmdlet che si risolve in un servizio.

  2012-03-05