< Back

Set-CSslCertificateBinding

Sun Jan 12, 2020 11:15 pm

NAME Set-CSslCertificateBinding



SYNOPSIS

Sets an SSL certificate binding for a given IP/port.





SYNTAX

Set-CSslCertificateBinding [[-IPAddress] <IPAddress>] [[-Port] <UInt16>] [-ApplicationID] <Guid> [-Thumbprint]

<String> [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]





DESCRIPTION

Uses the netsh command line application to set the certificate for an IP address and port. If a binding already

exists for the IP/port, it is removed, and the new binding is created.



Beginning with Carbon 2.0, returns a `Carbon.Certificates.SslCertificateBinding` object for the binding that was

set.





PARAMETERS

-IPAddress <IPAddress>

The IP address for the binding. Defaults to all IP addresses.



Required? false

Position? 1

Default value 0.0.0.0

Accept pipeline input? false

Accept wildcard characters? false



-Port <UInt16>

The port for the binding. Defaults to 443.



Required? false

Position? 2

Default value 443

Accept pipeline input? false

Accept wildcard characters? false



-ApplicationID <Guid>

A unique ID representing the application using the binding. Create your own.



Required? true

Position? 3

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Thumbprint <String>

The thumbprint of the certificate to use. The certificate must be installed.



Required? true

Position? 4

Default value

Accept pipeline input? false

Accept wildcard characters? false



-PassThru [<SwitchParameter>]

Return a `Carbon.Certificates.SslCertificateBinding` for the configured binding.



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Confirm [<SwitchParameter>]



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS

Carbon.Certificates.SslCertificateBinding.





-------------------------- EXAMPLE 1 --------------------------



PS C:\\>Set-CSslCertificateBinding -IPAddress 43.27.89.54 -Port 443 -ApplicationID

88d1f8da-aeb5-40a2-a5e5-0e6107825df7 -Thumbprint 4789073458907345907434789073458907345907



Configures the computer to use the 478907345890734590743 certificate on IP 43.27.89.54, port 443.









-------------------------- EXAMPLE 2 --------------------------



PS C:\\>Set-CSslCertificateBinding -ApplicationID 88d1f8da-aeb5-40a2-a5e5-0e6107825df7 -Thumbprint

4789073458907345907434789073458907345907



Configures the compute to use the 478907345890734590743 certificate as the default certificate on all IP

addresses, port 443.











RELATED LINKS