Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

Set-ASAppServiceCertificate

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?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.