This topic has not yet been rated - Rate this topic

Set-ASAppServiceCertificate

Sets a certificate to be used by a service if it has secure endpoints that require a certificate. With this cmdlet, there is no validation of whether the service certificate is needed by a service endpoint. There is also no validation of whether the selected certificate exists.

Syntax

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

Parameters

-ApplicationObject<ApplicationInfo>

An object that application configuration cmdlets output. This allows piping IIS configuration scope between commands.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?

-FindType<X509FindType>

Optional. Allowed values include FindByThumbprint, FindBySubjectName, FindBySubjectDistinguishedName, FindByIssuerName, FindByIssuerDistinguishedName, FindBySerialNumber, FindByTimeValid, FindByTimeNotYetValid, FindByTemplateName, FindByApplicationPolicy, FindByCertificatePolicy, FindByExtension, FindByKeyUsage, and FindBySubjectKeyIdentifier.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	true (ByPropertyName)
Accept Wildcard Characters?

-FindValue<String>

Required. The lookup value of the certificate that will be used for service authentication and signing.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	true (ByPropertyName)
Accept Wildcard Characters?

-Root

Indicates that only the root web.config file should be searched.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?

-ServiceObject<ServiceInfo>

An object that service configuration cmdlets output. This allows piping IIS configuration scope between commands.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?

-SiteName<String>

The IIS Web Site Name used to filter the configuration search.

Aliases	none
Required?	true
Position?	1
Default Value	none
Accept Pipeline Input?	true (ByPropertyName)
Accept Wildcard Characters?

-StoreLocation<StoreLocation>

Optional. LocalMachine or CurrentUser.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	true (ByPropertyName)
Accept Wildcard Characters?

-StoreName<StoreName>

Optional. Allowed values include AddressBook, AuthRoot, CertificateAuthority, Disallowed, My, Root, TrustedPeople, and TrustedPublisher.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	true (ByPropertyName)
Accept Wildcard Characters?

-Uri<Uri>

The Uri to an application whose configuration should be searched.

Aliases	none
Required?	true
Position?	1
Default Value	none
Accept Pipeline Input?	true (ByPropertyName)
Accept Wildcard Characters?

-UseInherited

If specified, the certificate in use is not defined locally, but rather inherited from a parent level. For instance, if a certificate is defined at the site scope and another certificate is defined at the application scope. Run Set-ASAppServiceCertificate –UseInherited to ensure that the certificate is no longer defined at the application scope (meaning the certificate defined at the site scope would be inherited).

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?

-VirtualPath<String>

The IIS Virtual Path used to filter the configuration search.

Aliases	none
Required?	false
Position?	2
Default Value	none
Accept Pipeline Input?	true (ByPropertyName)
Accept Wildcard Characters?

-Confirm

Prompts you for confirmation before executing the command.

Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-WhatIf

Describes what would happen if you executed the command without actually executing the command.

Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

ApplicationInfo or ServiceInfo

Outputs

The output type is the type of the objects that the cmdlet emits.

ServiceCertificateInfo

Examples

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)