Comments on this page are supposed to improve article content and no technical support is provided. For technical questions, please visit project home page at: https://pspki.codeplex.com/

Test-WebServerSSL

Test-WebServerSSL

Synopsis

Tests remote web server SSL certificate.

Syntax

Test-WebServerSSL [-URL] <String> [[-Port] <Int32>] [[-Proxy] <WebProxy>] [[-Timeout] <Int32>] [-UseUserContext] [<CommonParameters>]

Description

Tests remote web server SSL certificate. The command connects to the specified web server address, establishes SSL tunnel, retrieves and examines returned certificate.

Parameters

-URL <String>

Specifies a web server address to connect. The address MUST NOT contain a protocol prefix (https://). Only host names are allowed.

Required? True
Position? 0
Default value  
Accept pipeline input? true (ByValue)
Accept wildcard characters? False

-Port <Int32>

Specifies the SSL port to connect. by default, port 443 is used.

Required? False
Position? 1
Default value 443
Accept pipeline input? false
Accept wildcard characters? False

-Proxy <WebProxy>

Specifies a proxy address (including protocol prefix, host name and connection port) if necessary.

Required? False
Position? 2
Default value  
Accept pipeline input? false
Accept wildcard characters? False

-Timeout <Int32>

Specifies the connection timeout in milliseconds. By default 15 seconds (15000 milliseconds) timeout is used.

Required? False
Position? 3
Default value 15000
Accept pipeline input? false
Accept wildcard characters? False

-UseUserContext <SwitchParameter>

Specifies whether to build chain against user store. By default, certificate chain MUST be ended by a Root CA certificate that is stored in the Trusted Root CAs container in Local Machine store.

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, InformationAction, InformationVariable,
WarningAction, WarningVariable, OutBuffer, PipelineVariable and OutVariable.
For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).

Inputs

None.

Outputs

PKI.Web.WebSSL

Notes

Author: Vadims Podans
Blog: https://www.sysadmins.lv

Examples

Example 1

PS C:\> Test-WebServerSSL -URL login.live.com

The command initiates the SSL connection to 'https://login.live.com' on port 443 and examines SSL certificate. Actual SSL certificate is added to the returned object.

Example 2

PS C:\> Test-WebServerSSL -url paypal.com -Proxy "http://proxy.company.com:8080" -Timeout 20000

This command initiates a SSL connection to 'https://paypal.com' on port 443 by using spefied proxy address and examines SSL certificate. The timeout for the connection is 20 seconds (20000 milliseconds). Actual SSL certificate is added to the returned object.

Related links

PowerShell Support

  • PowerShell 3.0

Operating System Support

  • Windows Vista
  • Windows 7
  • Windows 8
  • Windows 8.1
  • Windows Server 2008 all editions
  • Windows Server 2008 R2 all editions
  • Windows Server 2012 all editions
  • Windows Server 2012 R2 all editions

Comments:

Captcha