Edit

Share via

Get-IISCentralCertProvider

  • Reference
Module:
IISAdministration

Gets information about the IIS central certificate store.

Syntax

Get-IISCentralCertProvider
   [-CertStoreLocation]
   [-UserName]
   [-PrivateKeyPassword]
   [-Enabled]
   [<CommonParameters>]

Description

The Get-IISCentralCertProvider cmdlet returns information about the IIS central certificate store. The central certificate store allows you to store all your IIS certificates in a centralized location (such as a file share); IIS servers then retrieve certificate from this centralized location. That means that you only have to install certificates in one location; there is no need to install the same certificate on each and every IIS server.

Called without any parameters, Get-IISCentralCertProvider returns information for all the certificate store property values. Alternatively, you can include one or more optional parameters in order to limit the returned data only to the specified properties. For example, this command limits the returned data to the Enabled property:

Get-IISCentralCertProvider -Enabled

Examples

Example 1

PS C:\> Get-IISCentralCertProvider

This command returns information about the IIS central certificate store. Because no parameters are used when running this command Get-IISCentralCertProvider returns information for all the certificate store properties.

Example 2

PS C:\> Get-IISCentralCertProvider -CertStoreLocation -UserName

This command returns information for two properties of the IIS central certificate store: the store location (CertStoreLocation) and the name of the user account used for accessing the store (UserName). Values for other properties (such as the private key password) are not returned. To return all the property values leave off all parameter when calling Get-IISCentralCertProvider.

Parameters

-CertStoreLocation

Indicates that the certificate store location will be returned when running the command. If no parameters are specified when calling Get-IISCentralCertProvider then information will be returned for all the property values.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Enabled

Indicates that the current state of the central store (enabled or disabled) will be returned when running the command. If no parameters are specified when calling Get-IISCentralCertProvider then information will be returned for all the property values.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrivateKeyPassword

Indicates that the private key password will be returned when running the command. If no parameters are specified when calling Get-IISCentralCertProvider then information will be returned for all the property values.

Note that the password itself will not be displayed on screen; instead, you will only see a series of asterisks (*******). While this does not tell you what the private key password is, it does let you know that a private key password has been configured for the certificate store. If no value is returned for the PrivateKeyPassword property that means that no private key password has been assigned to the certificate store.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserName

Indicates that the central store user account name will be returned when running the command. If no parameters are specified when calling Get-IISCentralCertProvider then information will be returned for all the property values.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

Outputs

Object