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.


Alias

nessuno

Necessario?

true

Posizione?

named

Valore predefinito

nessuno

Accettare input pipeline?

true (ByValue)

Accettare caratteri jolly?

-FindType<X509FindType>

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


Alias

nessuno

Necessario?

false

Posizione?

named

Valore predefinito

nessuno

Accettare input pipeline?

true (ByPropertyName)

Accettare caratteri jolly?

-FindValue<String>

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


Alias

nessuno

Necessario?

false

Posizione?

named

Valore predefinito

nessuno

Accettare input pipeline?

true (ByPropertyName)

Accettare caratteri jolly?

-Root

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


Alias

nessuno

Necessario?

false

Posizione?

named

Valore predefinito

nessuno

Accettare input pipeline?

false

Accettare caratteri jolly?

-ServiceObject<ServiceInfo>

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


Alias

nessuno

Necessario?

true

Posizione?

named

Valore predefinito

nessuno

Accettare input pipeline?

true (ByValue)

Accettare caratteri jolly?

-SiteName<String>

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


Alias

nessuno

Necessario?

true

Posizione?

1

Valore predefinito

nessuno

Accettare input pipeline?

true (ByPropertyName)

Accettare caratteri jolly?

-StoreLocation<StoreLocation>

Facoltativo. LocalMachine o CurrentUser.


Alias

nessuno

Necessario?

false

Posizione?

named

Valore predefinito

nessuno

Accettare input pipeline?

true (ByPropertyName)

Accettare caratteri jolly?

-StoreName<StoreName>

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


Alias

nessuno

Necessario?

false

Posizione?

named

Valore predefinito

nessuno

Accettare input pipeline?

true (ByPropertyName)

Accettare caratteri jolly?

-Uri<Uri>

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


Alias

nessuno

Necessario?

true

Posizione?

1

Valore predefinito

nessuno

Accettare input pipeline?

true (ByPropertyName)

Accettare caratteri jolly?

-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).


Alias

nessuno

Necessario?

false

Posizione?

named

Valore predefinito

nessuno

Accettare input pipeline?

false

Accettare caratteri jolly?

-VirtualPath<String>

Percorso virtuale IIS utilizzato per filtrare la ricerca della configurazione.


Alias

nessuno

Necessario?

false

Posizione?

2

Valore predefinito

nessuno

Accettare input pipeline?

true (ByPropertyName)

Accettare caratteri jolly?

-Confirm

Richiede la conferma prima dell'esecuzione del comando.


Necessario?

false

Posizione?

named

Valore predefinito

nessuno

Accettare input pipeline?

false

Accettare caratteri jolly?

false

-WhatIf

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


Necessario?

false

Posizione?

named

Valore predefinito

nessuno

Accettare input pipeline?

false

Accettare caratteri jolly?

false

<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

Mostra: