en-US/Qualys.SSLLabs.dll-Help.xml
<?xml version="1.0" encoding="utf-8"?>
<helpItems schema="maml" xmlns="http://msh"> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Get-SSLLabs</command:name> <command:verb>Get</command:verb> <command:noun>SSLLabs</command:noun> <maml:description> <maml:para>Gets the SSL assessment result from Qualys SSL Labs API.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>The `Get-SSLLabs` cmdlet sends HTTP web request to Qualys SSL Labs API with the domain name for SSL analysis assessment. It parses the response and returns the assessment result containing multiple collections with information in JSON into a PSObject.</maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Get-SSLLabs</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="0" aliases="h, host"> <maml:name>Analyze</maml:name> <maml:Description> <maml:para>Specifies the hostname that will send as a request for assessments. By default, this is a mandatory.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="1" aliases="pub"> <maml:name>Publish</maml:name> <maml:Description> <maml:para>Specifies if the assessment results should be published on the public results boards. By default, publish is off.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="11" aliases="p, password"> <maml:name>ProxyPassword</maml:name> <maml:Description> <maml:para>Specifies the password for the username to authenticate with proxy server.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">SecureString</command:parameterValue> <dev:type> <maml:name>SecureString</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="13" aliases="g"> <maml:name>Grade</maml:name> <maml:Description> <maml:para>Specifies to request the assessments to return the assessments results grade only.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="2" aliases="n, new"> <maml:name>StartNew</maml:name> <maml:Description> <maml:para>Specifies to ignore cached assessment results and start a new assessment.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="3" aliases="a, d, detail"> <maml:name>All</maml:name> <maml:Description> <maml:para>Specifies if the assessment results should be return with full information. By default, all is off and will only return summaries of individual endpoints.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="4" aliases="ignore-mismatch"> <maml:name>IgnoreMismatch</maml:name> <maml:Description> <maml:para>Specifies to continue with the assessments even when the server certificate doesn't match the assessment hostname. Please note that this parameter is ignored if a cached report is returned. By default, ignoreMismatch is off.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="5" aliases="dev, ex"> <maml:name>Experiment</maml:name> <maml:Description> <maml:para>Specifies if the request should be send to Qualys SSL Labs API in production or development environment. By default, all request will be send to Qualys SSL Labs API production environment unless this parameter is specified.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="6" aliases="proxy"> <maml:name>ProxyServer</maml:name> <maml:Description> <maml:para>Specifies a proxy server for the request, rather than connecting directly to the Internet resource. Enter the FQDN of the proxy server.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="7" aliases="port"> <maml:name>ProxyPort</maml:name> <maml:Description> <maml:para>Specifies the port number used by the proxy server.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="9" aliases="u, user, username"> <maml:name>ProxyUsername</maml:name> <maml:Description> <maml:para>Specifies the username to authenticate with proxy server.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="cf"> <maml:name>Confirm</maml:name> <maml:Description> <maml:para>Prompts you for confirmation before running the cmdlet.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="wi"> <maml:name>WhatIf</maml:name> <maml:Description> <maml:para>Shows what would happen if the cmdlet runs. The cmdlet is not run.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="named" aliases="none"> <maml:name>ProxyCredential</maml:name> <maml:Description> <maml:para>Specifies a user account that has permission to send the request to the proxy server. The default is the current user.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">ICredentials</command:parameterValue> <dev:type> <maml:name>ICredentials</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="named" aliases="none"> <maml:name>Output</maml:name> <maml:Description> <maml:para>Specifies whether to override default PSObject output. The parameter accepts `Raw` or `Browser` as an option value. Specifying `Raw` as the option value will output raw response in console. Specifying `Browser` as the option value will output to default web browser.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Get-SSLLabs</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="0" aliases="h, host"> <maml:name>Analyze</maml:name> <maml:Description> <maml:para>Specifies the hostname that will send as a request for assessments. By default, this is a mandatory.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="1" aliases="pub"> <maml:name>Publish</maml:name> <maml:Description> <maml:para>Specifies if the assessment results should be published on the public results boards. By default, publish is off.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="11" aliases="p, password"> <maml:name>ProxyPassword</maml:name> <maml:Description> <maml:para>Specifies the password for the username to authenticate with proxy server.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">SecureString</command:parameterValue> <dev:type> <maml:name>SecureString</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="13" aliases="g"> <maml:name>Grade</maml:name> <maml:Description> <maml:para>Specifies to request the assessments to return the assessments results grade only.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="2" aliases="c, cache, usecache"> <maml:name>FromCache</maml:name> <maml:Description> <maml:para>Specifies to request for cache assessment reports if available. Can't be used at the same time as the startNew parameter. By default, fromCache is off.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="3" aliases="a, d, detail"> <maml:name>All</maml:name> <maml:Description> <maml:para>Specifies if the assessment results should be return with full information. By default, all is off and will only return summaries of individual endpoints.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="3" aliases="age, hour"> <maml:name>MaxAge</maml:name> <maml:Description> <maml:para>Specifies maximum report age (in hours), if retrieving from cache. This parameter is mandatory when using -FromCache parameter.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="4" aliases="ignore-mismatch"> <maml:name>IgnoreMismatch</maml:name> <maml:Description> <maml:para>Specifies to continue with the assessments even when the server certificate doesn't match the assessment hostname. Please note that this parameter is ignored if a cached report is returned. By default, ignoreMismatch is off.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="5" aliases="dev, ex"> <maml:name>Experiment</maml:name> <maml:Description> <maml:para>Specifies if the request should be send to Qualys SSL Labs API in production or development environment. By default, all request will be send to Qualys SSL Labs API production environment unless this parameter is specified.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="6" aliases="proxy"> <maml:name>ProxyServer</maml:name> <maml:Description> <maml:para>Specifies a proxy server for the request, rather than connecting directly to the Internet resource. Enter the FQDN of the proxy server.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="7" aliases="port"> <maml:name>ProxyPort</maml:name> <maml:Description> <maml:para>Specifies the port number used by the proxy server.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="9" aliases="u, user, username"> <maml:name>ProxyUsername</maml:name> <maml:Description> <maml:para>Specifies the username to authenticate with proxy server.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="cf"> <maml:name>Confirm</maml:name> <maml:Description> <maml:para>Prompts you for confirmation before running the cmdlet.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="wi"> <maml:name>WhatIf</maml:name> <maml:Description> <maml:para>Shows what would happen if the cmdlet runs. The cmdlet is not run.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="named" aliases="none"> <maml:name>ProxyCredential</maml:name> <maml:Description> <maml:para>Specifies a user account that has permission to send the request to the proxy server. The default is the current user.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">ICredentials</command:parameterValue> <dev:type> <maml:name>ICredentials</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="named" aliases="none"> <maml:name>Output</maml:name> <maml:Description> <maml:para>Specifies whether to override default PSObject output. The parameter accepts `Raw` or `Browser` as an option value. Specifying `Raw` as the option value will output raw response in console. Specifying `Browser` as the option value will output to default web browser.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Get-SSLLabs</maml:name> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="1" aliases="none"> <maml:name>Info</maml:name> <maml:Description> <maml:para>Specifies the request to return the Qualys SSL Labs information. This parameter should be used to check the availability of the SSL Labs servers, retrieve the engine and criteria version, and initialize the maximum number of concurrent assessments.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="11" aliases="p, password"> <maml:name>ProxyPassword</maml:name> <maml:Description> <maml:para>Specifies the password for the username to authenticate with proxy server.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">SecureString</command:parameterValue> <dev:type> <maml:name>SecureString</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="6" aliases="proxy"> <maml:name>ProxyServer</maml:name> <maml:Description> <maml:para>Specifies a proxy server for the request, rather than connecting directly to the Internet resource. Enter the FQDN of the proxy server.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="7" aliases="port"> <maml:name>ProxyPort</maml:name> <maml:Description> <maml:para>Specifies the port number used by the proxy server.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="9" aliases="u, user, username"> <maml:name>ProxyUsername</maml:name> <maml:Description> <maml:para>Specifies the username to authenticate with proxy server.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="cf"> <maml:name>Confirm</maml:name> <maml:Description> <maml:para>Prompts you for confirmation before running the cmdlet.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="wi"> <maml:name>WhatIf</maml:name> <maml:Description> <maml:para>Shows what would happen if the cmdlet runs. The cmdlet is not run.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="named" aliases="none"> <maml:name>ProxyCredential</maml:name> <maml:Description> <maml:para>Specifies a user account that has permission to send the request to the proxy server. The default is the current user.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">ICredentials</command:parameterValue> <dev:type> <maml:name>ICredentials</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="named" aliases="none"> <maml:name>Output</maml:name> <maml:Description> <maml:para>Specifies whether to override default PSObject output. The parameter accepts `Raw` or `Browser` as an option value. Specifying `Raw` as the option value will output raw response in console. Specifying `Browser` as the option value will output to default web browser.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Get-SSLLabs</maml:name> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="1" aliases="none"> <maml:name>RawRootCertificates</maml:name> <maml:Description> <maml:para>Specifies the request to return the root certificates used for trust validation.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="11" aliases="p, password"> <maml:name>ProxyPassword</maml:name> <maml:Description> <maml:para>Specifies the password for the username to authenticate with proxy server.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">SecureString</command:parameterValue> <dev:type> <maml:name>SecureString</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="6" aliases="proxy"> <maml:name>ProxyServer</maml:name> <maml:Description> <maml:para>Specifies a proxy server for the request, rather than connecting directly to the Internet resource. Enter the FQDN of the proxy server.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="7" aliases="port"> <maml:name>ProxyPort</maml:name> <maml:Description> <maml:para>Specifies the port number used by the proxy server.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="9" aliases="u, user, username"> <maml:name>ProxyUsername</maml:name> <maml:Description> <maml:para>Specifies the username to authenticate with proxy server.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="cf"> <maml:name>Confirm</maml:name> <maml:Description> <maml:para>Prompts you for confirmation before running the cmdlet.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="wi"> <maml:name>WhatIf</maml:name> <maml:Description> <maml:para>Shows what would happen if the cmdlet runs. The cmdlet is not run.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="named" aliases="none"> <maml:name>ProxyCredential</maml:name> <maml:Description> <maml:para>Specifies a user account that has permission to send the request to the proxy server. The default is the current user.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">ICredentials</command:parameterValue> <dev:type> <maml:name>ICredentials</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="named" aliases="none"> <maml:name>Output</maml:name> <maml:Description> <maml:para>Specifies whether to override default PSObject output. The parameter accepts `Raw` or `Browser` as an option value. Specifying `Raw` as the option value will output raw response in console. Specifying `Browser` as the option value will output to default web browser.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> <command:syntaxItem> <maml:name>Get-SSLLabs</maml:name> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="1" aliases="none"> <maml:name>StatusCodes</maml:name> <maml:Description> <maml:para>Specifies the request to return the StatusCodes containing a map of all status details codes and the corresponding English translations.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="11" aliases="p, password"> <maml:name>ProxyPassword</maml:name> <maml:Description> <maml:para>Specifies the password for the username to authenticate with proxy server.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">SecureString</command:parameterValue> <dev:type> <maml:name>SecureString</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="6" aliases="proxy"> <maml:name>ProxyServer</maml:name> <maml:Description> <maml:para>Specifies a proxy server for the request, rather than connecting directly to the Internet resource. Enter the FQDN of the proxy server.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="7" aliases="port"> <maml:name>ProxyPort</maml:name> <maml:Description> <maml:para>Specifies the port number used by the proxy server.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="9" aliases="u, user, username"> <maml:name>ProxyUsername</maml:name> <maml:Description> <maml:para>Specifies the username to authenticate with proxy server.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="cf"> <maml:name>Confirm</maml:name> <maml:Description> <maml:para>Prompts you for confirmation before running the cmdlet.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="wi"> <maml:name>WhatIf</maml:name> <maml:Description> <maml:para>Shows what would happen if the cmdlet runs. The cmdlet is not run.</maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="named" aliases="none"> <maml:name>ProxyCredential</maml:name> <maml:Description> <maml:para>Specifies a user account that has permission to send the request to the proxy server. The default is the current user.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">ICredentials</command:parameterValue> <dev:type> <maml:name>ICredentials</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="named" aliases="none"> <maml:name>Output</maml:name> <maml:Description> <maml:para>Specifies whether to override default PSObject output. The parameter accepts `Raw` or `Browser` as an option value. Specifying `Raw` as the option value will output raw response in console. Specifying `Browser` as the option value will output to default web browser.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="3" aliases="a, d, detail"> <maml:name>All</maml:name> <maml:Description> <maml:para>Specifies if the assessment results should be return with full information. By default, all is off and will only return summaries of individual endpoints.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="0" aliases="h, host"> <maml:name>Analyze</maml:name> <maml:Description> <maml:para>Specifies the hostname that will send as a request for assessments. By default, this is a mandatory.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="cf"> <maml:name>Confirm</maml:name> <maml:Description> <maml:para>Prompts you for confirmation before running the cmdlet.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="5" aliases="dev, ex"> <maml:name>Experiment</maml:name> <maml:Description> <maml:para>Specifies if the request should be send to Qualys SSL Labs API in production or development environment. By default, all request will be send to Qualys SSL Labs API production environment unless this parameter is specified.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="2" aliases="c, cache, usecache"> <maml:name>FromCache</maml:name> <maml:Description> <maml:para>Specifies to request for cache assessment reports if available. Can't be used at the same time as the startNew parameter. By default, fromCache is off.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="13" aliases="g"> <maml:name>Grade</maml:name> <maml:Description> <maml:para>Specifies to request the assessments to return the assessments results grade only.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="4" aliases="ignore-mismatch"> <maml:name>IgnoreMismatch</maml:name> <maml:Description> <maml:para>Specifies to continue with the assessments even when the server certificate doesn't match the assessment hostname. Please note that this parameter is ignored if a cached report is returned. By default, ignoreMismatch is off.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="1" aliases="none"> <maml:name>Info</maml:name> <maml:Description> <maml:para>Specifies the request to return the Qualys SSL Labs information. This parameter should be used to check the availability of the SSL Labs servers, retrieve the engine and criteria version, and initialize the maximum number of concurrent assessments.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="3" aliases="age, hour"> <maml:name>MaxAge</maml:name> <maml:Description> <maml:para>Specifies maximum report age (in hours), if retrieving from cache. This parameter is mandatory when using -FromCache parameter.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="11" aliases="p, password"> <maml:name>ProxyPassword</maml:name> <maml:Description> <maml:para>Specifies the password for the username to authenticate with proxy server.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">SecureString</command:parameterValue> <dev:type> <maml:name>SecureString</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="7" aliases="port"> <maml:name>ProxyPort</maml:name> <maml:Description> <maml:para>Specifies the port number used by the proxy server.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue> <dev:type> <maml:name>Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="6" aliases="proxy"> <maml:name>ProxyServer</maml:name> <maml:Description> <maml:para>Specifies a proxy server for the request, rather than connecting directly to the Internet resource. Enter the FQDN of the proxy server.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="9" aliases="u, user, username"> <maml:name>ProxyUsername</maml:name> <maml:Description> <maml:para>Specifies the username to authenticate with proxy server.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="1" aliases="pub"> <maml:name>Publish</maml:name> <maml:Description> <maml:para>Specifies if the assessment results should be published on the public results boards. By default, publish is off.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="1" aliases="none"> <maml:name>RawRootCertificates</maml:name> <maml:Description> <maml:para>Specifies the request to return the root certificates used for trust validation.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="2" aliases="n, new"> <maml:name>StartNew</maml:name> <maml:Description> <maml:para>Specifies to ignore cached assessment results and start a new assessment.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="1" aliases="none"> <maml:name>StatusCodes</maml:name> <maml:Description> <maml:para>Specifies the request to return the StatusCodes containing a map of all status details codes and the corresponding English translations.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="wi"> <maml:name>WhatIf</maml:name> <maml:Description> <maml:para>Shows what would happen if the cmdlet runs. The cmdlet is not run.</maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="named" aliases="none"> <maml:name>ProxyCredential</maml:name> <maml:Description> <maml:para>Specifies a user account that has permission to send the request to the proxy server. The default is the current user.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">ICredentials</command:parameterValue> <dev:type> <maml:name>ICredentials</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByPropertyName, ByValue)" position="named" aliases="none"> <maml:name>Output</maml:name> <maml:Description> <maml:para>Specifies whether to override default PSObject output. The parameter accepts `Raw` or `Browser` as an option value. Specifying `Raw` as the option value will output raw response in console. Specifying `Browser` as the option value will output to default web browser.</maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type> <maml:name>String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>System.String</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:inputType> <command:inputType> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:inputType> <command:inputType> <dev:type> <maml:name>System.Int32</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:inputType> <command:inputType> <dev:type> <maml:name>System.Security.SecureString</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:inputType> <command:inputType> <dev:type> <maml:name>System.Net.ICredentials</maml:name> </dev:type> <maml:description> <maml:para></maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <command:returnValue> <dev:type> <maml:name>System.Management.Automation.PSObject</maml:name> </dev:type> <maml:description> <maml:para>By default, this cmdlet returns a PSObject(Object) object containing the Qualys SSL Labs assessment result.</maml:para> </maml:description> </command:returnValue> </command:returnValues> <maml:alertSet> <maml:alert> <maml:para>Author : Ryen Kia Zhi Tang</maml:para> <maml:para>Blog : ryentang.wordpress.com (http://ryentang.wordpress.com/)</maml:para> </maml:alert> </maml:alertSet> <command:examples> <command:example> <maml:title>-------------------------- Example 1 --------------------------</maml:title> <dev:code>PS C:\> Get-SSLLabs -Analyze www.ssllabs.com host : www.ssllabs.com port : 443 protocol : HTTP isPublic : False status : READY startTime : 1518144021514 testTime : 1518144072574 engineVersion : 1.30.7 criteriaVersion : 2009o endpoints : {www.ssllabs.com}</dev:code> <dev:remarks> <maml:para>This example uses the `-Analyze` parameter to specify the hostname that will be analyzed by Qualys SSL Labs API and determine if the assessment request status is ready.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- Example 2 --------------------------</maml:title> <dev:code>PS C:\> Get-SSLLabs -Analyze www.ssllabs.com | Select-Object -ExpandProperty endpoints ipAddress : 64.41.200.100 serverName : www.ssllabs.com grade : A+ gradeTrustIgnored : A+ statusMessage : Ready statusDetails : statusDetailsMessage : hasWarnings : False isExceptional : True progress : 100 eta : 14 duration : 50988 delegation : 2 details : Qualys.SSLLabs.API.v2.Response.Property.Endpoint.Details</dev:code> <dev:remarks> <maml:para>This example uses the `-Analyze` parameter to specify the hostname that will be analyzed by Qualys SSL Labs API. In order to obtain endpoints detail, the PSObject is being pipelined with the endpoints property expanded to obtain each endpoint grade.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- Example 3 --------------------------</maml:title> <dev:code>PS C:\> Get-SSLLabs -Analyze www.ssllabs.com | Select-Object -ExpandProperty endpoints | Select-Object -ExpandProperty details hostStartTime : 1518144021514 key : Qualys.SSLLabs.API.v2.Response.Property.Endpoint.Key cert : Qualys.SSLLabs.API.v2.Response.Property.Endpoint.Cert chain : Qualys.SSLLabs.API.v2.Response.Property.Endpoint.Chain protocols : {TLS, TLS, TLS} suites : Qualys.SSLLabs.API.v2.Response.Property.Endpoint.Suites serverSignature : Apache prefixDelegation : True nonPrefixDelegation : False vulnBeast : True renegSupport : 2 sessionResumption : 2 compressionMethods : 0 supportsNpn : False npnProtocols : sessionTickets : 0 ocspStapling : False staplingRevocationStatus : 0 staplingRevocationErrorMessage : sniRequired : False httpStatusCode : 200 supportsRc4 : False forwardSecrecy : 4 rc4WithModern : False sims : Qualys.SSLLabs.API.v2.Response.Property.Endpoint.Sims heartbleed : False heartbeat : False openSslCcs : 1 poodle : False poodleTls : 1 fallbackScsv : True freak : False hasSct : 0 httpForwarding :</dev:code> <dev:remarks> <maml:para>This example uses the `-Analyze` parameter to specify the hostname that will be analyzed by Qualys SSL Labs API as example 3. In order to obtain endpoints detail, the PSObject is being pipelined with the endpoints property containing the details property expanded to obtain each endpoint assessment result properties. You can continue to pipeline and select a property to be expanded to drill down the specific result.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- Example 4 --------------------------</maml:title> <dev:code>PS C:\> Get-SSLLabs -Analyze www.powershell.org -Grade host grade details ---- ----- ------- www.powershell.org A {Qualys.SSLLabs.API.v2.Response.Property.Grade.Details, Qualys.SSLLabs.API.v2.Response.Prop...</dev:code> <dev:remarks> <maml:para>This example uses the `-Analyze` parameter to specify the hostname that will be analyzed by Qualys SSL Labs API with the use of `-Grade` parameter to obtain an overall grade of the assessment result.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- Example 5 --------------------------</maml:title> <dev:code>PS C:\> Get-SSLLabs -Analyze www.powershell.org -Grade | Select-Object -ExpandProperty details ipAddress grade gradeTrustIgnored --------- ----- ----------------- 45.79.156.244 A A 45.79.184.180 A A</dev:code> <dev:remarks> <maml:para>This example uses the `-Analyze` parameter to specify the hostname that will be analyzed by Qualys SSL Labs API with the use of `-Grade` parameter as example 5. In order to obtains the grade from all the endpoints, the PSObject is being pipelined with the details property expanded to obtain the assessment result of all the endpoints.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- Example 6 --------------------------</maml:title> <dev:code>PS C:\> Get-SSLLabs -Analyze www.ssllabs.com -ProxyServer MyProxyServerHostname -ProxyPort 3218 -ProxyUsername MyUsername -ProxyPassword (ConvertTo-SecureString -String "MyPassword" -AsPlainText -Force) host : www.ssllabs.com port : 443 protocol : HTTP isPublic : False status : READY startTime : 1518099022899 testTime : 1518099076294 engineVersion : 1.30.7 criteriaVersion : 2009o endpoints : {www.ssllabs.com}</dev:code> <dev:remarks> <maml:para>This exmaple uses the `-ProxyServer` and `-ProxyPort` parameters to specify the proxy server and port. While using `-ProxyUsername` and `-ProxyPassword` parameters to specify the username and password for proxy authentication.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- Example 7 --------------------------</maml:title> <dev:code>PS C:\> Get-SSLLabs -Analyze www.powershell.org -ProxyServer websense -ProxyPort 8080 -Credential (New-Object System.Management.Automation.PSCredential "MyDomain\MyUsername", (ConvertTo-SecureString -String "MyPassword" -AsPlainText -Force)) -Grade host grade details ---- ----- ------- www.powershell.org A {Qualys.SSLLabs.API.v2.Response.Property.Grade.Details, Qualys.SSLLabs.API.v2.Response.Prop...</dev:code> <dev:remarks> <maml:para>This exmaple uses the `-ProxyServer` and `-ProxyPort` parameters to specify the proxy server and port. While using `-Credential` parameter to specify the credential for proxy authentication to obtain the overall grade using proxy.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- Example 8 --------------------------</maml:title> <dev:code>PS C:\> Get-SSLLabs -Info engineVersion : 1.30.7 criteriaVersion : 2009o clientMaxAssessments : 25 maxAssessments : 25 currentAssessments : 0 newAssessmentCoolOff : 1000 messages : {This assessment service is provided free of charge by Qualys SSL Labs, subject to our terms and conditions: https://www.ssllabs.com/about/terms.html}</dev:code> <dev:remarks> <maml:para>This example uses `-Info` parameter to request for Qualys SSL Labs server information.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- Example 9 --------------------------</maml:title> <dev:code>PS C:\> Get-SSLLabs -StatusCodes TESTING_PROTOCOL_INTOLERANCE_399 : Testing Protocol Intolerance (TLS 1.152) PREPARING_REPORT : Preparing the report TESTING_SESSION_RESUMPTION : Testing session resumption RETRIEVING_CERT_V3__NO_SNI : Retrieving certificate TESTING_NPN : Testing NPN RETRIEVING_CERT_V3__SNI_APEX : Retrieving certificate TESTING_CVE_2014_0224 : Testing CVE-2014-0224 TESTING_CAPABILITIES : Determining server capabilities TESTING_CVE_2016_2107 : Testing CVE-2016-2107 TESTING_HEARTBLEED : Testing Heartbleed TESTING_PROTO_3_3_V2H : Testing TLS 1.1 (v2 handshake) TESTING_SESSION_TICKETS : Testing Session Ticket support VALIDATING_TRUST_PATHS : Validating trust paths TESTING_RENEGOTIATION : Testing renegotiation TESTING_HTTPS : Sending one complete HTTPS request TESTING_ALPN : Determining supported ALPN protocols TESTING_V2H_HANDSHAKE : Testing v2 handshake TESTING_STRICT_RI : Testing Strict Renegotiation TESTING_HANDSHAKE_SIMULATION : Simulating handshakes TESTING_SUITES_DEPRECATED : Testing deprecated cipher suites TESTING_STRICT_SNI : Testing Strict SNI TESTING_PROTOCOL_INTOLERANCE_499 : Testing Protocol Intolerance (TLS 2.152) TESTING_PROTO_3_1_V2H : Testing TLS 1.0 (v2 handshake) TESTING_TLS_VERSION_INTOLERANCE : Testing TLS version intolerance TESTING_BLEICHENBACHER : Testing Bleichenbacher TESTING_PROTOCOL_INTOLERANCE_304 : Testing Protocol Intolerance (TLS 1.3) TESTING_SUITES_BULK : Bulk-testing less common cipher suites TESTING_BEAST : Testing for BEAST TESTING_PROTO_2_0 : Testing SSL 2.0 TESTING_TICKETBLEED : Testing Ticketbleed BUILDING_TRUST_PATHS : Building trust paths TESTING_PROTO_3_1 : Testing TLS 1.0 TESTING_PROTO_3_0_V2H : Testing SSL 3.0 (v2 handshake) TESTING_PROTO_3_0 : Testing SSL 3.0 TESTING_PROTOCOL_INTOLERANCE_300 : Testing Protocol Intolerance (SSL 3.0) TESTING_PROTOCOL_INTOLERANCE_301 : Testing Protocol Intolerance (TLS 1.0) TESTING_PROTOCOL_INTOLERANCE_302 : Testing Protocol Intolerance (TLS 1.1) TESTING_SUITES_NO_SNI : Observed extra suites during simulation, Testing cipher suites without SNI support TESTING_EC_NAMED_CURVES : Determining supported named groups TESTING_PROTOCOL_INTOLERANCE_303 : Testing Protocol Intolerance (TLS 1.2) TESTING_OCSP_STAPLING_PRIME : Trying to prime OCSP stapling TESTING_DROWN : Testing for DROWN TESTING_EXTENSION_INTOLERANCE : Testing Extension Intolerance (might take a while) TESTING_OCSP_STAPLING : Testing OCSP stapling TESTING_SSL2_SUITES : Checking if SSL 2.0 has any ciphers enabled TESTING_SUITES : Determining available cipher suites TESTING_ECDHE_PARAMETER_REUSE : Testing ECDHE parameter reuse TESTING_PROTO_3_2_V2H : Testing TLS 1.1 (v2 handshake) TESTING_POODLE_TLS : Testing POODLE against TLS RETRIEVING_CERT_TLS13 : Retrieving certificate RETRIEVING_CERT_V3__SNI_WWW : Retrieving certificate TESTING_PROTO_3_4 : Testing TLS 1.3 TESTING_COMPRESSION : Testing compression CHECKING_REVOCATION : Checking for revoked certificates TESTING_SUITE_PREFERENCE : Determining cipher suite preference TESTING_PROTO_3_2 : Testing TLS 1.1 TESTING_PROTO_3_3 : Testing TLS 1.2 TESTING_LONG_HANDSHAKE : Testing Long Handshake (might take a while)</dev:code> <dev:remarks> <maml:para>This examples uses `-StatusCodes` parameter to request a list of available status codes and their corresponding English translations from the Qualys SSL Labs API.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- Example 10 --------------------------</maml:title> <dev:code>PS C:\> Get-SSLLabs -RawRootCertificates # AAA Certificate Services # Subject: CN=AAA Certificate Services, O=Comodo CA Limited, L=Salford, ST=Greater Manchester, C=GB # Key type: RSA # Key length: 2048 # Not before: Thu Jan 01 00:00:00 UTC 2004 # Not after: Sun Dec 31 23:59:59 UTC 2028 -----BEGIN CERTIFICATE----- MIIEMjCCAxqgAwIBAgIBATANBgkqhkiG9w0BAQUFADB7MQswCQYDVQQGEwJHQjEbMBkGA1UECAwS R3JlYXRlciBNYW5jaGVzdGVyMRAwDgYDVQQHDAdTYWxmb3JkMRowGAYDVQQKDBFDb21vZG8gQ0Eg TGltaXRlZDEhMB8GA1UEAwwYQUFBIENlcnRpZmljYXRlIFNlcnZpY2VzMB4XDTA0MDEwMTAwMDAw MFoXDTI4MTIzMTIzNTk1OVowezELMAkGA1UEBhMCR0IxGzAZBgNVBAgMEkdyZWF0ZXIgTWFuY2hl c3RlcjEQMA4GA1UEBwwHU2FsZm9yZDEaMBgGA1UECgwRQ29tb2RvIENBIExpbWl0ZWQxITAfBgNV BAMMGEFBQSBDZXJ0aWZpY2F0ZSBTZXJ2aWNlczCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoC ggEBAL5AnfRu4ep2hxxNRUSOvkbIgwadwSr+GB+O5AL686tdUIoWMQuaBtDFcCLNSS1UY8y2bmhG C1Pqy0wkwLxyTurxFa70VJoSCsN6sjNg4tqJVfMiWPPe3M/vg4aijJRPn2jymJBGhCfHdr/jzDUs i14HZGWCwEiwqJH5YZ92IFCokcdmtet4YgNW8IoaE+oxox6gmf049vYnMlhvB/VruPsUK6+3qszW Y19zjNoFmag4qMsXeDZRrOme9Hg6jc8P2ULimAyrL58OAd7vn5lJ8S3frHRNG5i1R8XlKdH5kBjH Ypy+g8cmez6KJcfA3Z3mNWgQIJ2P2N7Sw4ScDV7oL8kCAwEAAaOBwDCBvTAdBgNVHQ4EFgQUoBEK Iz6W8Qfs4q8p74Klf9AwpLQwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wewYDVR0f BHQwcjA4oDagNIYyaHR0cDovL2NybC5jb21vZG9jYS5jb20vQUFBQ2VydGlmaWNhdGVTZXJ2aWNl cy5jcmwwNqA0oDKGMGh0dHA6Ly9jcmwuY29tb2RvLm5ldC9BQUFDZXJ0aWZpY2F0ZVNlcnZpY2Vz LmNybDANBgkqhkiG9w0BAQUFAAOCAQEACFb8AvCb6P+k+tZ7xkSAzk/ExfYAWMymtrwUSWgEdujm 7l3sAg9g1o1QGE8mTgHj5rCl7r+8dFRBv/38ErjHT1r0iWAFf2C3BUrz9vHCv8S5dIa2LX1rzNLz Rt0vxuBqw8M0Ayx9lt1awg6nCpnBBYurDC/zXDrPbDdVCYfeU0BsWO/8tqtlbgT2G9w84FoVxp7Z 8VlIMCFlA2zs6SFz7JsDoeA3raAVGI/6ugLOpyypEBMs1OUIJqsil2D4kF501KKaU73yqWjgom7C 12yxow+ev+to51byrvLjKzg6CYG1a4XXvi3tPxq3smPi9WIsgtRqAEFQ8TmDn5XpNpaYbg== -----END CERTIFICATE----- # ACCVRAIZ1 # Subject: C=ES, O=ACCV, OU=PKIACCV, CN=ACCVRAIZ1 # Key type: RSA # Key length: 4096 # Not before: Thu May 05 09:37:37 UTC 2011 # Not after: Tue Dec 31 09:37:37 UTC 2030 -----BEGIN CERTIFICATE----- MIIH0zCCBbugAwIBAgIIXsO3pkN/pOAwDQYJKoZIhvcNAQEFBQAwQjESMBAGA1UEAwwJQUNDVlJB SVoxMRAwDgYDVQQLDAdQS0lBQ0NWMQ0wCwYDVQQKDARBQ0NWMQswCQYDVQQGEwJFUzAeFw0xMTA1 MDUwOTM3MzdaFw0zMDEyMzEwOTM3MzdaMEIxEjAQBgNVBAMMCUFDQ1ZSQUlaMTEQMA4GA1UECwwH UEtJQUNDVjENMAsGA1UECgwEQUNDVjELMAkGA1UEBhMCRVMwggIiMA0GCSqGSIb3DQEBAQUAA4IC DwAwggIKAoICAQCbqau/YUqXry+XZpp0X9DZlv3P4uRm7x8fRzPCRKPfmt4ftVTdFXxpNRFvu8gM jmoYHtiP2Ra8EEg2XPBjs5BaXCQ316PWywlxufEBcoSwfdtNgM3802/J+Nq2DoLSRYWoG2ioPej0 RGy9ocLLA76MPhMAhN9KSMDjIgro6TenGEyxCQ0jVn8ETdkXhBilyNpAlHPrzg5XPAOBOp0KoVdD aaxXbXmQeOW1tDvYvEyNKKGno6e6Ak4l0Squ7a4DIrhrIA8wKFSVf+DuzgpmndFALW4ir50awQUZ 0m/A8p/4e7MCQvtQqR0tkw8jq8bBD5L/0KIV9VMJcRz/RROE5iZe+OCIHAr8Fraocwa48GOEAqDG WuzndN9wrqODJerWx5eHk6fGioozl2A3ED6XPm4pFdahD9GILBKfb6qkxkLrQaLjlUPTAYVtjrs7 8yM2x/474KElB0iryYl0/wiPgL/AlmXz7uxLaL2diMMxs0Dx6M/2OLuc5NF/1OVYm3z61PMOm3WR 5LpSLhl+0fXNWhn8ugb2+1KoS5kE3fj5tItQo05iifCHJPqDQsGH+tUtKSpacXpkatcnYGMN285J 9Y0fkIkyF/hzQ7jSWpOGYdbhdQrqeWZ2iE9x6wQl1gpaepPluUsXQA+xtrn13k/c4LOsOxFwYIRK Q26ZIMApcQrAZQIDAQABo4ICyzCCAscwfQYIKwYBBQUHAQEEcTBvMEwGCCsGAQUFBzAChkBodHRw Oi8vd3d3LmFjY3YuZXMvZmlsZWFkbWluL0FyY2hpdm9zL2NlcnRpZmljYWRvcy9yYWl6YWNjdjEu Y3J0MB8GCCsGAQUFBzABhhNodHRwOi8vb2NzcC5hY2N2LmVzMB0GA1UdDgQWBBTSh7Tj3zcnk1X2 VuqB5TbMjB4/vTAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNKHtOPfNyeTVfZW6oHlNsyM Hj+9MIIBcwYDVR0gBIIBajCCAWYwggFiBgRVHSAAMIIBWDCCASIGCCsGAQUFBwICMIIBFB6CARAA QQB1AHQAbwByAGkAZABhAGQAIABkAGUAIABDAGUAcgB0AGkAZgBpAGMAYQBjAGkA8wBuACAAUgBh AO0AegAgAGQAZQAgAGwAYQAgAEEAQwBDAFYAIAAoAEEAZwBlAG4AYwBpAGEAIABkAGUAIABUAGUA YwBuAG8AbABvAGcA7QBhACAAeQAgAEMAZQByAHQAaQBmAGkAYwBhAGMAaQDzAG4AIABFAGwAZQBj AHQAcgDzAG4AaQBjAGEALAAgAEMASQBGACAAUQA0ADYAMAAxADEANQA2AEUAKQAuACAAQwBQAFMA IABlAG4AIABoAHQAdABwADoALwAvAHcAdwB3AC4AYQBjAGMAdgAuAGUAczAwBggrBgEFBQcCARYk aHR0cDovL3d3dy5hY2N2LmVzL2xlZ2lzbGFjaW9uX2MuaHRtMFUGA1UdHwROMEwwSqBIoEaGRGh0 dHA6Ly93d3cuYWNjdi5lcy9maWxlYWRtaW4vQXJjaGl2b3MvY2VydGlmaWNhZG9zL3JhaXphY2N2 MV9kZXIuY3JsMA4GA1UdDwEB/wQEAwIBBjAXBgNVHREEEDAOgQxhY2N2QGFjY3YuZXMwDQYJKoZI hvcNAQEFBQADggIBAJcxAp/n/UNnSEQU5CmH7UwoZtCPNdpNYbdKl02125DgBS4OxnnQ8pdpD70E R9m+27Up2pvZrqmZ1dM8MJP1jaGo/AaNRPTKFpV8M9xii6g3+CfYCS0b78gUJyCpZET/LtZ1qmxN YEAZSUNUY9rizLpm5U9EelvZaoErQNV/+QEnWCzI7UiRfD+mAM/EKXMRNt6GGT6d7hmKG9Ww7Y49 nCrADdg9ZuM8Db3VlFzi4qc1GwQA9j9ajepDvV+JHanBsMyZ4k0ACtrJJ1vnE5Bc5PUzolVt3OAJ TS+xJlsndQAJxGJ3KQhfnlmstn6tn1QwIgPBHnFk/vk4CpYY3QIUrCPLBhwepH2NDd4nQeit2hW3 sCPdK6jT2iWH7ehVRE2I9DZ+hJp4rPcOVkkO1jMl1oRQQmwgEh0q1b688nCBpHBgvgW1m54ERL5h I6zppSSMEYCUWqKiuUnSwdzRp+0xESyeGabu4VXhwOrPDYTkF7eifKXeVSUG7szAh1xA2syVP1Xg Nce4hL60Xc16gwFy7ofmXx2utYXGJt/mwZrpHgJHnyqobalbz+xFd3+YJ5oyXSrjhO7FmGYvliAd 3djDJ9ew+f7Zfc3Qn48LFFhRny+Lwzgt3uiP1o2HpPVWQxaZLPSkVrQ0uGE3ycJYgBugl6H8WY3p EfbRD0tVNEYqi4Y7 -----END CERTIFICATE----- # ACEDICOM Root # Subject: C=ES, O=EDICOM, OU=PKI, CN=ACEDICOM Root # Key type: RSA # Key length: 4096 # Not before: Fri Apr 18 16:24:22 UTC 2008 # Not after: Thu Apr 13 16:24:22 UTC 2028 -----BEGIN CERTIFICATE----- MIIFtTCCA52gAwIBAgIIYY3HhjsBggUwDQYJKoZIhvcNAQEFBQAwRDEWMBQGA1UEAwwNQUNFRElD T00gUm9vdDEMMAoGA1UECwwDUEtJMQ8wDQYDVQQKDAZFRElDT00xCzAJBgNVBAYTAkVTMB4XDTA4 MDQxODE2MjQyMloXDTI4MDQxMzE2MjQyMlowRDEWMBQGA1UEAwwNQUNFRElDT00gUm9vdDEMMAoG A1UECwwDUEtJMQ8wDQYDVQQKDAZFRElDT00xCzAJBgNVBAYTAkVTMIICIjANBgkqhkiG9w0BAQEF AAOCAg8AMIICCgKCAgEA/5KV4WgGdrQsyFhIyv2AVClVYyT/kGWbEHV7w2rbYgIB8hiGtXxaOLHk WLn709gtn70yN78sFW2+tfQh0hOR2QetAQXW8713zl9CgQr5auODAKgrLlUTY4HKRxx7XBZXehuD YAQ6PmXDzQHe3qTWDLqO3tkE7hdWIpuPY/1NFgu3e3eM+SW10W2ZEi5PGrjm6gSSrj0RuVFCPYew MYWveVqc/udOXpJPQ/yrOq2lEiZmueIM15jO1FillUAKt0SdE3QrwqXrIhWYENiLxQSfHY9g5QYb m8+5eaA9oiM/Qj9r+hwDezCNzmzAv+YbX79nuIQZ1RXve8uQNjFiybwCq0Zfm/4aaJQ0PZCOrfbk HQl/Sog4P75n/TSW9R28MHTLOO7VbKvU/PQAtwBbhTIWdjPp2KOZnQUAqhbm84F9b32qhm2tFXTT xKJxqvQUfecyuB+81fFOvW8XAjnXDpVCOscAPukmYxHqC9FK/xidstd7LzrZlvvoHpKuE1XI2Sf2 3EgbsCTBheN3nZqk8wwRHQ3ItBTutYJXCb8gWH8vIiPYcMt5bMlL8qkqyPyHK9caUPgn6C9D4zq9 2Fdx/c6mUlv53U3t5fZvie27k5x2IXXwkkwp9y+cAS7+UEaeZAwUswdbxcJzbPEHXEUkFDWug/Fq TYl6+rPYLWbwNof1K1MCAwEAAaOBqjCBpzAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFKaz 4SsrSbbXc6GqlPUB53NlTKxQMA4GA1UdDwEB/wQEAwIBhjAdBgNVHQ4EFgQUprPhKytJttdzoaqU 9QHnc2VMrFAwRAYDVR0gBD0wOzA5BgRVHSAAMDEwLwYIKwYBBQUHAgEWI2h0dHA6Ly9hY2VkaWNv bS5lZGljb21ncm91cC5jb20vZG9jMA0GCSqGSIb3DQEBBQUAA4ICAQDOLAtSUWImfQwng4/F9tqg aHtPkl7qpHMyEVNEskTLnewPeUKzEKbHDZ3Ltvo/Onzqv4hTGzz3gvoFNTPhNahXwOf9jU8/kzJP eGYDdwdY6ZXIfj7QeQCM8htRM5u8lOk6e25SLTKeI6RF+7YuE7CLGLHdztUdp0J/Vb77W7tH1Pwk zQSulgUV1qzOMPPKC8W64iLgpq0i5ALudBF/TP94HTXa5gI06xgSYXcGCRZj6hitoocf8seACQl1 ThCojz2GuHURwCRiipZ7SkXp7FnFvmuD5uHorLUwHv4FB4D54SMNUI8FmP8sX+g7tq3PgbUhh8oI KiMnMCArz+2UW6yyetLHKKGKC5tNSixthT8Jcjxn4tncB7rrZXtaAWPWkFtPF2Y9fwsZo5NjEFIq nxQWWOLcpfShFosOkYuByptZ+thrkQdlVV9SH686+5DdaaVbnG0OLLb6zqylfDJKZ0DcMDQj3dcE I2bw/FWAp/tmGYI1Z2JwOV5vx+qQQEQIHriy1tvuWacNGHk0vFQYXlPKNFHtRQrmjseCNj6nOGOp MCwXEGCSn1WHElkQwg9naRHMTh5+Spqtr0CodaxWkHS4oJyleW/c6RrIaQXpuvoDs3zk4E7Czp3o tkYNbn5XOmeUwssfnHdKZ05phkOTOPu220+DkdRgfks+KzgHVZhepA== -----END CERTIFICATE-----</dev:code> <dev:remarks> <maml:para>This example uses the `-RawRootCertificates` parameter to request all the root certificates used for the trust validation from the Qualys SSL Labs server.</maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks> <maml:navigationLink> <maml:linkText>Qualys SSL Labs APIs</maml:linkText> <maml:uri>https://dev.ssllabs.com/projects/ssllabs-apis/index.html</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>SSL Labs API Documentation on GitHub</maml:linkText> <maml:uri>https://github.com/ssllabs/ssllabs-scan/blob/master/ssllabs-api-docs.md</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>SSL Labs API v2 Documentation on GitHub</maml:linkText> <maml:uri>https://github.com/ssllabs/ssllabs-scan/blob/master/ssllabs-api-docs-v2-deprecated.md</maml:uri> </maml:navigationLink> <maml:navigationLink> <maml:linkText>SSL Labs API v3 Documentation on GitHub</maml:linkText> <maml:uri>https://github.com/ssllabs/ssllabs-scan/blob/master/ssllabs-api-docs-v3.md</maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> </helpItems> |