Set-IISCertificateOld

Synopsis

Configure RD Session Host service to use the specified certificate.

Syntax

Set-IISCertificateOld [[-CertThumbprint] <String>] [[-PfxFile] <String>] [[-PfxPass] <SecureString>]
 [-SiteName <String>] [-Port <UInt32>] [-IPAddress <String>] [-HostHeader <String>] [-RequireSNI]
 [-RemoveOldCert] [<CommonParameters>]

Description

Intended to be used with the output from Posh-ACME's New-PACertificate or Submit-Renewal.

Examples

EXAMPLE 1

New-PACertificate site1.example.com | Set-IISCertificate -SiteName "My Website"

Create a new certificate and add it to the specified IIS website on the default port.

EXAMPLE 2

Submit-Renewal site1.example.com | Set-IISCertificate -SiteName "My Website"

Renew a certificate and and add it to the specified IIS website on the default port.

Parameters

-CertThumbprint

Thumbprint/Fingerprint for the certificate to configure.

Type: String
Parameter Sets: (All)
Aliases: Thumbprint

Required: False
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-HostHeader

The "Host name" value for the site binding. If empty, this binding will respond to all names. Supported only on IIS 8.0 or higher.

Type: String
Parameter Sets: (All)
Aliases:

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

-IPAddress

The listening IP Address for the site binding. Defaults to '*' which is "All Unassigned" in the IIS management console.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: *
Accept pipeline input: False
Accept wildcard characters: False

-PfxFile

Path to a PFX containing a certificate and private key. Not required if the certificate is already in the local system's Personal certificate store.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-PfxPass

The export password for the specified PfxFile parameter. Not required if the Pfx does not require an export password.

Type: SecureString
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Port

The listening TCP port for the site binding. Defaults to 443.

Type: UInt32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 443
Accept pipeline input: False
Accept wildcard characters: False

-RemoveOldCert

If specified, the old certificate will be deleted from the local system's Personal certificate store. Ignored if the old certificate has already been removed or otherwise can't be found.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-RequireSNI

If specified, the "Require Server Name Indication" box will be checked for the site binding. Supported only on IIS 8.0 or higher.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-SiteName

The IIS web site name to modify bindings on. Defaults to "Default Web Site".

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: Default Web Site
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

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

Related Links