Set-ASAppServiceCertificate

Set-ASAppServiceCertificate

Imposta un certificato che un servizio deve utilizzare se 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.

Sintassi

Parameter Set: SiteNameAndVirtualPath
Set-ASAppServiceCertificate [-SiteName] <String> [[-VirtualPath] <String> ] [-FindType <X509FindType> ] [-FindValue <String> ] [-StoreLocation <StoreLocation> ] [-StoreName <StoreName> ] [-UseInherited] [-Confirm] [-WhatIf] [ <CommonParameters>]

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

Parameter Set: RootConfig
Set-ASAppServiceCertificate [-FindType <X509FindType> ] [-FindValue <String> ] [-Root] [-StoreLocation <StoreLocation> ] [-StoreName <StoreName> ] [-UseInherited] [-Confirm] [-WhatIf] [ <CommonParameters>]

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

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

Parametri

-ApplicationObject<ApplicationInfo>

Oggetto output dei cmdlet di configurazione dell'applicazione, Consente l'ambito del piping della configurazione IIS tra comandi.

-FindType<X509FindType>

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

-FindValue<String>

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

-Root

Indica che la ricerca deve essere eseguita solo nel file web.config radice.

-ServiceObject<ServiceInfo>

Oggetto output dei cmdlet di configurazione del servizio. Consente l'ambito del piping della configurazione ISS tra comandi.

-SiteName<String>

Nome del sito Web IIS utilizzato per filtrare la ricerca della configurazione.

-StoreLocation<StoreLocation>

Facoltativo. LocalMachine o CurrentUser.

-StoreName<StoreName>

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

-Uri<Uri>

Uri di un'applicazione di cui è necessario ricercare la configurazione.

-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. Eseguire Set-ASAppServiceCertificate –UseInherited 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).

-VirtualPath<String>

Percorso virtuale IIS utilizzato per filtrare la ricerca della configurazione.

-Confirm

Richiede la conferma prima dell'esecuzione del comando.

-WhatIf

Descrive cosa accadrebbe se venisse eseguito il comando senza eseguirlo effettivamente.

<CommonParameters>

Questo cmdlet supporta i parametri comuni: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_CommonParameters

Input

Il tipo di input corrisponde al tipo di oggetti che è possibile inviare al cmdlet.

• ApplicationInfo o ServiceInfo

Output

Il tipo di output corrisponde al tipo di oggetti emesso dal cmdlet.

• ServiceCertificateInfo

Esempi