Microsoft.AzureStack.ReadinessChecker.psm1

#Requires -RunAsAdministrator
#Requires -Version 5.0

<#############################################################
 # #
 # Copyright (C) Microsoft Corporation. All rights reserved. #
 # #
 #############################################################>


<#
 
.SYNOPSIS
This module is intended to be made directly available to customers, that can be run
before Azure Stack deployment and for ongoing use for operational tasks such as Secret Rotation.
 
.DESCRIPTION
Contains the following:
    CertificateValidation
        Read the PFXData, public info is protected by the password and without a profile loaded (such as GMSA account).
        Signature Algorithm is not SHA1.
        Private Key is present and contains local machine key attribute.
        Certification Chain is complete including intermediaries and in a specific order.
        DNS Names match the required names or covered by supporting wildcard.
        Key Usage contains Digital Signature and Key Encipherment.
    AzureValidation
        AADServiceAdministrator is correctly provisioned and matches deploymentdata.json for install
        Registration Account is correct type and owners of the subscriptionID provided.
    Generate Certificate Requests
        Generate Certificate Requests using the documented requerst template for Azure Stack.
 
.EXAMPLE
    PS C:\>$password = Read-Host -Prompt "Enter PFX Password" -AsSecureString
    PS C:\>Start-AzsReadinessChecker -CertificatePath .\Certificates\ -pfxPassword $password -regionname east -fqdn azurestack.contoso.com -identitySystem AAD
 
    Validate Certificates
.EXAMPLE
    PS C:\>$serviceAdminCredential = Get-Credential (serviceadmin@contoso.onmicrosoft.com) -Message "Enter Credentials for Service Administrator of Azure Active Directory Tenant"
    PS C:\>Start-AzsReadinessChecker -AADServiceAdministrator $serviceAdminCredential - AzureEnvironment AzureCloud -AzureDirectoryTenantName azurestack.contoso.com
 
    Validates Azure Assets - Azure Active Directory Validation
.EXAMPLE
    PS C:\>$registrationCredential = Get-Credential (subscriptionowner@contoso.onmicrosoft.com) -Message "Enter Credentials for Subscription Owner"
    PS C:\>$subscriptionID = "f7c26209-cd2d-4625-86ba-724ebeece794"
    PS C:\>Start-AzsReadinessChecker -RegistrationAccount $registrationCredential -RegistrationSubscriptionID $subscriptionID -AzureEnvironment AzureCloud -AzureDirectoryTenantName azurestack.contoso.com
    Validates Azure Assets - Registration Validation
.EXAMPLE
    PS C:\>$regionName = 'east'
    PS C:\>$externalFQDN = 'azurestack.contoso.com'
 
    PS C:\>$subjectHash = [ordered]@{"OU"="AzureStack";"O"="Microsoft";"L"="Redmond";"ST"="Washington";"C"="US"}
 
    PS C:\>Start-AzsReadinessChecker -regionName $regionName -externalFQDN $externalFQDN -subject $subjectHash -requestType MultipleCSR -IdentitySystem AAD
 
    Generates Certificate Requests - Multiple CSR suitable for AAD install
.EXAMPLE
    PS C:\>Start-AzsReadinessChecker ps1 -RegionName $regionName -ExternalFQDN $externalFQDN -subjectName $subjectName -IdentitySystem AAD -RequestType SingleCSR -IncludePaaS
    Generates Certificate Request - Multiple SAN child domain wildcard suitable for AAD install and PaaS (Single CSR is not recommended for production)
.EXAMPLE
    PS C:\>Start-AzsReadinessChecker ps1 -RegionName $regionName -ExternalFQDN $externalFQDN -subjectName -KeyLength 4096 -HashAlgorithm SHA384 $subjectName -IdentitySystem AAD -RequestType MultipleCSR
    Generates Certificate Request - Multiple CSR with key length 4096 and Hash Algorithm SHA384 suitable for AAD install and PaaS.
.EXAMPLE
    PS C:\>Start-AzsReadinessChecker -ReportPath Contoso-AzsReadinessReport.json
    Reads Contoso's Readiness Report, provides details and summary of validation results
.EXAMPLE
    PS C:\>Start-AzsReadinessChecker -ReportPath Contoso-AzsReadinessReport.json -ReportSections Certificate -Summary
    Reads Contoso's Readiness Report, provides summary tailored to certificate validation only.
.EXAMPLE
    PS C:\>Start-AzsReadinessChecker [-pfxPassword <SecureString>] -pfxPath <String> -ExportToPath <String> [<CommonParameters>]
.EXAMPLE
    PS C:\>$PaaSCertificates = @{
        'PaaSDBCert' = @{'pfxPath' = 'c:\certs\DBCert.pfx';'pfxPassword' = (ConvertTo-SecureString -String 'Password' -AsPlainText -Force)}
        'PaaSDefaultCert' = @{'pfxPath' = 'c:\certs\DefaultPaaSCert.pfx';'pfxPassword' = (ConvertTo-SecureString -String 'Password' -AsPlainText -Force)}
        'PaaSAPICert' = @{'pfxPath' = 'c:\certs\PaaSAPICert.pfx';'pfxPassword' = (ConvertTo-SecureString -String 'Password' -AsPlainText -Force)}
        'PaaSFTPCert' = @{'pfxPath' = 'c:\certs\PaaSFTPCert.pfx';'pfxPassword' = (ConvertTo-SecureString -String 'Password' -AsPlainText -Force)}
        'PaaSSSOCert' = @{'pfxPath' = 'c:\certs\PaaSSSOCert.pfx';'pfxPassword' = (ConvertTo-SecureString -String 'Password' -AsPlainText -Force)}
    }
    PS C:\>Start-AzsReadinessChecker -RegionName east -FQDN azurestack.contoso.com -paasCertificates $PaaSCertificates
 
    Validate PaaS Certificates
.PARAMETER CertificatePath
    Specifies the path under which only the certificate required certificate folders are present.
    Required folders for Azure Stack deployment with Azure Active Directory identity system are:
        ACSBlob, ACSQueue, ACSTable, Admin Portal, ARM Admin, ARM Public, KeyVault, KeyVaultInternal, Public Portal
    Required folder for Azure Stack deployment with Active Directory Federation Services identity system are:
        ACSBlob, ACSQueue, ACSTable, ADFS, Admin Portal, ARM Admin, ARM Public, Graph, KeyVault, KeyVaultInternal, Public Portal
    If ExtensionHostFeature is specified, two more folders, Admin Extension Host and Public Extension Host, are required.
.PARAMETER RegionName
    Specifies the Azure Stack deployment's region name when deploymentdata.json is not used, must be alphanumeric.
.PARAMETER FQDN
    Specifies the Azure Stack deployment's External FQDN, also aliased as ExternalFQDN and ExternalDomainName, must be valid DNSHostName
.PARAMETER IdentitySystem
    Specifies the Azure Stack deployment's Identity System valid values, AAD or ADFS, for Azure Active Directory and Active Directory Federated Services respectively
.PARAMETER ExtensionHostFeature
    Indicates whether to verify the certificates for extension host feature. If the boolean is $false, it will skip the verification for extension host feature.
.PARAMETER PfxPassword
    Specifies the password associated with PFX certificate files.
.PARAMETER DeploymentDataJSONPath
    Specifies the Azure Stack deployment deployment data JSON configuration file. Generally only available to the deployment team.
.PARAMETER PfxPath
    Specifies the path to a problematic certificate that requires import/export routine to fix, as indicated by certificate validation in this tool
.PARAMETER ExportPFXPath
    Specifies the destination path for the resultant PFX file from import/export routine.
.PARAMETER Subject
    Specifies an ordered dictionary of the subject for the certificate request generation.
.PARAMETER KeyLength
    Defines the length of the public and private key for the certificate request generation. Default is 2048. Valid values 2048, 4096, 8192
.PARAMETER HashAlgorithm
    Hash Algorithm to be used for the certificate request generation. Default is SHA256. Valid values SHA256, SHA384, SHA512
.PARAMETER RequestType
    Specifies the SAN type of the certificate request. Valid values: MultipleCSR, SingleCSR.
    SingleCSR generates one certificate request for all services (not recommended for production). User will be prompted to confirm use.
    MultipleCSR generates multiple certificate requests, one for each service (strongly recommended in production environments).
.PARAMETER IncludePaaS
    Specifies if PaaS services/hostnames should be added to the certificate request(s)
.PARAMETER OutputRequestPath
    Specifies the destination path for certificate request files, directory must already exist.
.PARAMETER AADServiceAdministrator
    Specifies Azure Active Directory Service Administrator intended to be used for Azure Stack deployment.
.PARAMETER AADDirectoryTenantName
    Specifies the Azure Active Directory name intended to be used for Azure Stack deployment.
.PARAMETER AzureEnvironment
    Specifies the instance of Azure Services containing the accounts, directories and subscriptions intended to be used for Azure Stack deployment and registration.
.PARAMETER RegistrationAccount
    Specifies the Registration Account intended to be used for Azure Stack registration.
.PARAMETER RegistrationSubscriptionID
    Specifies the Registration Subscription ID intended to be used for Azure Stack registration.
.PARAMETER ReportPath
    Specifies path for Readiness Report, defaults to current directory and default report name.
.PARAMETER ReportSections
    Specifies report sections to output, defaults to All.
.PARAMETER Summary
    Specifies whether to only show report summary, omits detail.
.PARAMETER CleanReport
    Specifies whether to purge the existing report and start again with a clean report. Execution history and validation data is lost for all Readiness Checker validations.
.PARAMETER OutputPath
    Specifies custom path to save Readiness JSON report and Verbose log file.
.PARAMETER PaaSCertificates
    Specifies a hashtable containing path and password to DB, Default, API, FTP & SSO Paas Certificates. Each individual certificate is optional.
.NOTES
    Verbose Logging is written to the script root
.LINK
    https://aka.ms/AzsReadinessChecker
#>



function Start-AzsReadinessChecker
{

    [CmdletBinding(SupportsShouldProcess, ConfirmImpact='Medium')]
    Param(
        [Parameter(Mandatory=$false,ParameterSetName='ValidateCertificates',HelpMessage="Enter Path to Certificates Directory")]
        [Parameter(Mandatory=$false,ParameterSetName='ValidateCertificatesJSON',HelpMessage="Enter Path to Certificates Directory")]
        [ValidateScript({Test-Path $_ -PathType Container})]
        [string] $CertificatePath = ".\Certificates",

        [Parameter(Mandatory=$true,ParameterSetName='ValidateCertificates',HelpMessage="Enter Azure Stack Region Name")]
        [Parameter(Mandatory=$true,ParameterSetName="CertificateRequest",HelpMessage="Enter Azure Stack Region Name")]
        [Parameter(Mandatory=$true,ParameterSetName='ValidatePaaSCertificates',HelpMessage="Enter Azure Stack Region Name")]
        [ValidatePattern('(?# Region must be alphanumeric)^[a-zA-Z0-9]+$')]
        [string]$RegionName,

        [Parameter(Mandatory=$true,ParameterSetName='ValidateCertificates',HelpMessage="Enter Azure Stack External FQDN (without region name)")]
        [Parameter(Mandatory=$true,ParameterSetName="CertificateRequest",HelpMessage="Enter Azure Stack External FQDN (without region name)")]
        [Parameter(Mandatory=$true,ParameterSetName='ValidatePaaSCertificates',HelpMessage="Enter Azure Stack External FQDN (without region name)")]
        [Alias("ExternalFQDN","ExternalDomainName")]
        [ValidateScript({[System.Uri]::CheckHostName($_) -eq 'dns' <#FQDN must be valid DNSHostName#>})]
        [string]$FQDN,

        [Parameter(Mandatory=$true,ParameterSetName='ValidateCertificates',HelpMessage="Enter Azure Stack Identity System (AAD or ADFS)")]
        [Parameter(Mandatory=$true,ParameterSetName="CertificateRequest",HelpMessage="Enter Azure Stack Identity System (AAD or ADFS)")]
        [ValidateSet('AAD','ADFS')]
        [string]$IdentitySystem,

        [Parameter(Mandatory=$false,ParameterSetName='ValidateCertificates',HelpMessage="Indicate whether verify certificates for extension host feature.")]
        [Parameter(Mandatory=$false,ParameterSetName="ValidateCertificatesJSON",HelpMessage="Indicate whether verify certificates for extension host feature.")]
        [bool]$ExtensionHostFeature=$true,

        [Parameter(Mandatory=$true,ParameterSetName='ValidateCertificates',HelpMessage="Enter the PFX password as a securestring")]
        [Parameter(Mandatory=$true,ParameterSetName='CertificateImportExport',HelpMessage="Enter the PFX password as a securestring")]
        [Parameter(Mandatory=$true,ParameterSetName='ValidateCertificatesJSON',HelpMessage="Enter the PFX password as a securestring")]
        [securestring]$PfxPassword,

        [Parameter(Mandatory=$true, ParameterSetName='ValidateCertificatesJSON',HelpMessage="Enter Path to DeploymentData.json")]
        [Parameter(Mandatory=$true, ParameterSetName='ValidateAzureInstallJSON',HelpMessage="Enter Path to DeploymentData.json")]
        [Parameter(Mandatory=$true, ParameterSetName='ValidateAzureRegistrationJSON',HelpMessage="Enter Path to DeploymentData.json")]
        [Parameter(Mandatory=$true,ParameterSetName='ValidatePaaSCertificatesJSON',HelpMessage="Provide Hashtable with PFX path and password details for each PaaS Certificate. See Get-Help Start-AzsReadinessChecker -Examples")]
        [ValidateScript({Test-Path $_ -Include *.json})]
        [string]$DeploymentDataJSONPath,

        [Parameter(Mandatory=$true,ParameterSetName='CertificateImportExport',HelpMessage="Path to PFX on disk")]
        [ValidateScript({Test-Path $_ -Include *.pfx -PathType Leaf})]
        [string]$PfxPath,

        [Parameter(Mandatory=$true,ParameterSetName="CertificateImportExport",HelpMessage="Destination Path for PFX export e.g. C:\ExistingFolder\NewSSL.pfx")]
        [ValidateScript({((Test-Path -Path (Split-Path -Path $_ -Parent)) -AND ([IO.Path]::GetExtension($_) -eq '.pfx'))})]
        [string]$ExportPFXPath,

        [Parameter(Mandatory=$true,ParameterSetName="CertificateRequest",HelpMessage='Provide subject name as an ordered hashtable e.g. $subject = [ordered]@{"OU"="AzureStack";"O"="Microsoft";"L"="Redmond";"ST"="Washington";"C"="US"}')]
        [System.Collections.Specialized.OrderedDictionary]$Subject,

        [Parameter(Mandatory=$false,ParameterSetName="CertificateRequest",HelpMessage='Provide Key Length: 2048, 4096 or 8192')]
        [ValidateSet(2048,4096,8192)]
        [int]$KeyLength = 2048,

        [Parameter(Mandatory=$false,ParameterSetName="CertificateRequest",HelpMessage='Provide Hash Algorithm: SHA256, SHA384 or SHA512')]
        [ValidateSet('SHA256','SHA384','SHA512')]
        [string]$HashAlgorithm = 'SHA256',

        [Parameter(Mandatory=$false,ParameterSetName="CertificateRequest",HelpMessage="Enter Certificate Request generation type ('Single' = Request individual wildcard certificates, 'Multiple' = Request single multi domain wildcard certificates")]
        [ValidateSet('MultipleCSR','SingleCSR')]
        [string]$RequestType = 'MultipleCSR',

        [Parameter(Mandatory=$false,ParameterSetName='CertificateRequest',HelpMessage="Use if you want to add PaaS domain names to the certificate request")]
        [switch]$IncludePaaS = $false,

        [Parameter(Mandatory=$true,ParameterSetName="CertificateRequest",HelpMessage="Destination Path for Certificate Request(s)")]
        [ValidateScript({Test-Path -Path $_ -PathType Container})]
        [string]$OutputRequestPath,

        [Parameter(Mandatory=$true,ParameterSetName='ValidateAzureInstall',HelpMessage="Enter Service Administrator Azure Credential as PSCredential")]
        [Parameter(Mandatory=$true,ParameterSetName='ValidateAzureInstallJSON',HelpMessage="Enter Service Administrator Azure Credential as PSCredential")]
        [pscredential]$AADServiceAdministrator,

        [Parameter(Mandatory=$true,ParameterSetName='ValidateAzureInstall',HelpMessage="Enter primary domain name of Azure Tenant Directory")]
        [string]$AADDirectoryTenantName,

        [Parameter(Mandatory=$true,ParameterSetName='ValidateAzureInstall',HelpMessage="Enter Azure Service Endpoint 'AzureCloud', 'AzureChinaCloud', or 'AzureGermanCloud'")]
        [Parameter(Mandatory=$true,ParameterSetName='ValidateAzureRegistration',HelpMessage="Enter Azure Service Endpoint 'AzureCloud', 'AzureChinaCloud', or 'AzureGermanCloud'")]
        [ValidateSet('AzureCloud','AzureChinaCloud','AzureGermanCloud','AzureUSGovernment')]
        [string]$AzureEnvironment,

        [Parameter(Mandatory=$true,ParameterSetName='ValidateAzureRegistration',HelpMessage="Enter Azure Registration Azure Credential as PSCredential")]
        [Parameter(Mandatory=$true,ParameterSetName='ValidateAzureRegistrationJSON',HelpMessage="Enter Azure Registration Azure Credential as PSCredential")]
        [pscredential]$RegistrationAccount,

        [Parameter(Mandatory=$true,ParameterSetName='ValidateAzureRegistration',HelpMessage="Enter Azure Registration Subscription ID")]
        [Parameter(Mandatory=$true,ParameterSetName='ValidateAzureRegistrationJSON')]
        [System.Guid]$RegistrationSubscriptionID,

        [Parameter(Mandatory=$true,ParameterSetName="ReadReport",HelpMessage="Path for Readiness Report")]
        [ValidateScript({Test-Path $_ -Include *.json})]
        [string]$ReportPath,

        [Parameter(Mandatory=$false,ParameterSetName="ReadReport",HelpMessage="Specify Report Path as 'Certificate', 'AzureRegistration', 'AzureIdentity', 'Jobs', or 'All'")]
        [ValidateSet('Certificate','AzureRegistration','AzureIdentity','Jobs','All')]
        [string[]]$ReportSections = 'All',

        [Parameter(Mandatory=$false,ParameterSetName="ReadReport",HelpMessage="Summarize report for issues only")]
        [switch]$Summary = $false,

        [Parameter(Mandatory=$false,ParameterSetName='ValidateCertificates',HelpMessage="Remove all previous progress and create a clean report")]
        [Parameter(Mandatory=$false,ParameterSetName='ValidateCertificatesJSON',HelpMessage="Remove all previous progress and create a clean report")]
        [Parameter(Mandatory=$false,ParameterSetName='ValidateAzureRegistration',HelpMessage="Remove all previous progress and create a clean report")]
        [Parameter(Mandatory=$false,ParameterSetName='ValidateAzureRegistrationJSON',HelpMessage="Remove all previous progress and create a clean report")]
        [Parameter(Mandatory=$false,ParameterSetName='ValidateAzureInstall',HelpMessage="Remove all previous progress and create a clean report")]
        [Parameter(Mandatory=$false,ParameterSetName='ValidateAzureInstallJSON',HelpMessage="Remove all previous progress and create a clean report")]
        [Parameter(Mandatory=$false,ParameterSetName='ValidatePaaSCertificates',HelpMessage="Remove all previous progress and create a clean report")]
        [Parameter(Mandatory=$false,ParameterSetName='ValidatePaaSCertificatesJSON',HelpMessage="Remove all previous progress and create a clean report")]
        [switch]$CleanReport = $false,

        [Parameter(HelpMessage="Directory path for log and report output")]
        [string]$OutputPath = "$ENV:TEMP\AzsReadinessChecker",

        [Parameter(Mandatory=$true,ParameterSetName='ValidatePaaSCertificates',HelpMessage="Provide Hashtable with PFX path and password details for each PaaS Certificate. See Get-Help Start-AzsReadinessChecker -Examples")]
        [Parameter(Mandatory=$true,ParameterSetName='ValidatePaaSCertificatesJSON',HelpMessage="Provide Hashtable with PFX path and password details for each PaaS Certificate. See Get-Help Start-AzsReadinessChecker -Examples")]
        [hashtable]$PaaSCertificates,

        [Parameter(Mandatory=$false,HelpMessage="Force the use of TLS 1.2, true by default")]
        [bool]$ForceTLS12 = $true
    )

    $ErrorActionPreference = 'Stop'
    $thisFunction = $MyInvocation.MyCommand.Name
    $GLOBAL:OutputPath = $OutputPath

    Import-Module $PSScriptRoot\Microsoft.AzureStack.ReadinessChecker.Utilities.psm1 -Force
    Import-Module $PSScriptRoot\Microsoft.AzureStack.ReadinessChecker.Reporting.psm1 -Force

    $deprecationWarning = "Start-AzsReadinessChecker is deprecated. In future, please use '{0}' instead."
    try
    {
        # Force Security Profile to TLS1.2
        if ($ForceTLS12)
        {
            # Change Security Protocol to TLS1.2 for the session and track for clean up later.
            $restoreSecurityProtocol = [Net.ServicePointManager]::SecurityProtocol
            $tempSecurityProtocol = [Net.SecurityProtocolType]::Tls12
            Set-SecurityProtocol -securityProtocol $tempSecurityProtocol
        }

        # Proxy function name change to smooth transistion
        if ($PSCmdlet.ParameterSetName -contains 'ValidateCertificates')
        {
            $certificateValidationParams = @{
                'CertificatePath' = $CertificatePath
                'RegionName' = $RegionName
                'Externalfqdn' = $FQDN
                'pfxPassword' = $pfxPassword
                'IdentitySystem' = $IdentitySystem
                'ExtensionHostFeature' = $ExtensionHostFeature
                'OutputPath' = $OutputPath
                'CleanReport' = $CleanReport
            }
            Write-Warning ($deprecationWarning -f 'Invoke-AzsCertificateValidation')
            Invoke-AzsCertificateValidation @certificateValidationParams
        }

        if ($PSCmdlet.ParameterSetName -contains 'ValidateCertificatesJSON')
        {
            $ValidateCertificatesJSONParams = @{
                'CertificatePath' = $CertificatePath
                'pfxPassword' = $pfxPassword
                'deploymentDataJSONPath' = $deploymentDataJSONPath
                'ExtensionHostFeature' = $ExtensionHostFeature
                'OutputPath' = $OutputPath
                'CleanReport' = $CleanReport
            }
            Write-Warning ($deprecationWarning -f 'Invoke-AzsCertificateValidation')
            Invoke-AzsCertificateValidation @ValidateCertificatesJSONParams
        }

        if ($PSCmdlet.ParameterSetName -contains 'ValidatePaaSCertificates')
        {
            $ValidatePaaSCertificateValidationParams = @{
                'PaaSCertificates' = $PaaSCertificates
                'RegionName' = $RegionName
                'Externalfqdn' = $FQDN
                'OutputPath' = $OutputPath
                'CleanReport' = $CleanReport
            }
            Write-Warning ($deprecationWarning -f 'Invoke-AzsCertificateValidation')
            Invoke-AzsCertificateValidation @ValidatePaaSCertificateValidationParams
        }

        if ($PSCmdlet.ParameterSetName -contains 'ValidatePaaSCertificatesJSON')
        {
            $ValidatePaaSCertificatesJSONParams = @{
                'PaaSCertificates' = $PaaSCertificates
                'deploymentDataJSONPath' = $deploymentDataJSONPath
                'OutputPath' = $OutputPath
                'CleanReport' = $CleanReport
            }
            Write-Warning ($deprecationWarning -f 'Invoke-AzsCertificateValidation')
            Invoke-AzsCertificateValidation @ValidatePaaSCertificatesJSONParams
        }

        if ($PSCmdlet.ParameterSetName -contains 'ValidateAzureInstall')
        {
            $ValidateAzureInstallParams = @{
                'AADServiceAdministrator' = $AADServiceAdministrator
                'AzureEnvironment' = $AzureEnvironment
                'AADDirectoryTenantName' = $AADDirectoryTenantName
                'OutputPath' = $OutputPath
                'CleanReport' = $CleanReport
            }
            Write-Warning ($deprecationWarning -f 'Invoke-AzsAzureIdentityValidation')
            Invoke-AzsAzureIdentityValidation @ValidateAzureInstallParams
        }

        if ($PSCmdlet.ParameterSetName -contains 'ValidateAzureInstallJSON')
        {
            $ValidateAzureInstallJSONParams = @{
                'AADServiceAdministrator' = $AADServiceAdministrator
                'deploymentDataJSONPath' = $deploymentDataJSONPath
                'OutputPath' = $OutputPath
                'CleanReport' = $CleanReport
            }
            Write-Warning ($deprecationWarning -f 'Invoke-AzsAzureIdentityValidation')
            Invoke-AzsAzureIdentityValidation @ValidateAzureInstallJSONParams
        }

        if ($PSCmdlet.ParameterSetName -contains 'ValidateAzureRegistration')
        {
            $ValidateAzureRegistrationParams = @{
                'RegistrationAccount' = $RegistrationAccount
                'AzureEnvironment' = $AzureEnvironment
                'RegistrationSubscriptionID' = $RegistrationSubscriptionID
                'OutputPath' = $OutputPath
                'CleanReport' = $CleanReport
            }
            Write-Warning ($deprecationWarning -f 'Invoke-AzsRegistrationValidation')
            Invoke-AzsRegistrationValidation @ValidateAzureRegistrationParams
        }

        if ($PSCmdlet.ParameterSetName -contains 'ValidateAzureRegistrationJSON')
        {
            $ValidateAzureRegistrationJSONParams = @{
                'RegistrationAccount' = $RegistrationAccount
                'deploymentDataJSONPath' = $deploymentDataJSONPath
                'RegistrationSubscriptionID' = $RegistrationSubscriptionID
                'OutputPath' = $OutputPath
                'CleanReport' = $CleanReport
            }
            Write-Warning ($deprecationWarning -f 'Invoke-AzsRegistrationValidation')
            Invoke-AzsRegistrationValidation @ValidateAzureRegistrationJSONParams
        }

        if ($PSCmdlet.ParameterSetName -contains 'CertificateImportExport')
        {
            $CertificateImportExportParams = @{
                'pfxPath' = $pfxPath
                'ExportPFXPath' = $ExportPFXPath
                'pfxPassword' = $pfxPassword
                'OutputPath' = $OutputPath
            }
            Write-Warning ($deprecationWarning -f 'Repair-AzsPfxCertificate')
            Repair-AzsPfxCertificate @CertificateImportExportParams
        }

        if ($PSCmdlet.ParameterSetName -contains 'CertificateRequest')
        {
            $certificateRequestParams = @{
                'regionName' = $regionName
                'externalFQDN' = $fqdn
                'subject' = $subject
                'KeyLength' = $KeyLength
                'HashAlgorithm' = $HashAlgorithm
                'requestType' = $RequestType
                'includePaaS' = $IncludePaaS
                'OutputRequestPath' = $OutputRequestPath
                'IdentitySystem' = $IdentitySystem
                'OutputPath' = $OutputPath
            }
            Write-Warning ($deprecationWarning -f 'New-AzsCertificateSigningRequest')
            New-AzsCertificateSigningRequest @certificateRequestParams
        }

        if ($PSCmdlet.ParameterSetName -contains 'ReadReport')
        {
            $readReportParams = @{
                'ReportPath' = $ReportPath
                'ReportSections' = $ReportSections
                'Summary' = $summary
            }
            Write-Warning ($deprecationWarning -f 'Read-AzsReadinessReport')
            Read-AzsReadinessReport @readReportParams
        }
    }
    catch
    {
        Write-AzsReadinessLog -Message ("AzsReadinessChecker failed with error: {0}" -f $_.exception) -Type Error -Function $thisFunction -toScreen
    }
    finally
    {
        if ($ForceTLS12)
        {
            Write-AzsReadinessLog -Message ("Attempting to remove Security Protocol {0} for session" -f $tempSecurityProtocol) -Type Info -Function $thisFunction
            try
            {
                Set-SecurityProtocol -securityProtocol $restoreSecurityProtocol
                Write-AzsReadinessLog -Message ("Successfully restored Security Protocol {0} for session" -f $restoreSecurityProtocol) -Type Info -Function $thisFunction
            }
            catch
            {
                Write-AzsReadinessLog -Message ("Failed to restore Security Protocol to {0}. The security protocol is still set to {1}, restart powershell to restore to default state. Error encountered {2}." -f 
                                                $restoreSecurityProtocol,[Net.ServicePointManager]::SecurityProtocol,$_.exception) -Type Warning -Function $thisFunction -toScreen
            }
        }
    }
}
# SIG # Begin signature block
# MIIkhwYJKoZIhvcNAQcCoIIkeDCCJHQCAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDFQWBfa3R8ryKc
# uUbnK0J0aYyJJxanEuzir3c2kZ+p9aCCDYEwggX/MIID56ADAgECAhMzAAABA14l
# HJkfox64AAAAAAEDMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD
# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy
# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p
# bmcgUENBIDIwMTEwHhcNMTgwNzEyMjAwODQ4WhcNMTkwNzI2MjAwODQ4WjB0MQsw
# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u
# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy
# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB
# AQDRlHY25oarNv5p+UZ8i4hQy5Bwf7BVqSQdfjnnBZ8PrHuXss5zCvvUmyRcFrU5
# 3Rt+M2wR/Dsm85iqXVNrqsPsE7jS789Xf8xly69NLjKxVitONAeJ/mkhvT5E+94S
# nYW/fHaGfXKxdpth5opkTEbOttU6jHeTd2chnLZaBl5HhvU80QnKDT3NsumhUHjR
# hIjiATwi/K+WCMxdmcDt66VamJL1yEBOanOv3uN0etNfRpe84mcod5mswQ4xFo8A
# DwH+S15UD8rEZT8K46NG2/YsAzoZvmgFFpzmfzS/p4eNZTkmyWPU78XdvSX+/Sj0
# NIZ5rCrVXzCRO+QUauuxygQjAgMBAAGjggF+MIIBejAfBgNVHSUEGDAWBgorBgEE
# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUR77Ay+GmP/1l1jjyA123r3f3QP8w
# UAYDVR0RBEkwR6RFMEMxKTAnBgNVBAsTIE1pY3Jvc29mdCBPcGVyYXRpb25zIFB1
# ZXJ0byBSaWNvMRYwFAYDVQQFEw0yMzAwMTIrNDM3OTY1MB8GA1UdIwQYMBaAFEhu
# ZOVQBdOCqhc3NyK1bajKdQKVMFQGA1UdHwRNMEswSaBHoEWGQ2h0dHA6Ly93d3cu
# bWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY0NvZFNpZ1BDQTIwMTFfMjAxMS0w
# Ny0wOC5jcmwwYQYIKwYBBQUHAQEEVTBTMFEGCCsGAQUFBzAChkVodHRwOi8vd3d3
# Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01pY0NvZFNpZ1BDQTIwMTFfMjAx
# MS0wNy0wOC5jcnQwDAYDVR0TAQH/BAIwADANBgkqhkiG9w0BAQsFAAOCAgEAn/XJ
# Uw0/DSbsokTYDdGfY5YGSz8eXMUzo6TDbK8fwAG662XsnjMQD6esW9S9kGEX5zHn
# wya0rPUn00iThoj+EjWRZCLRay07qCwVlCnSN5bmNf8MzsgGFhaeJLHiOfluDnjY
# DBu2KWAndjQkm925l3XLATutghIWIoCJFYS7mFAgsBcmhkmvzn1FFUM0ls+BXBgs
# 1JPyZ6vic8g9o838Mh5gHOmwGzD7LLsHLpaEk0UoVFzNlv2g24HYtjDKQ7HzSMCy
# RhxdXnYqWJ/U7vL0+khMtWGLsIxB6aq4nZD0/2pCD7k+6Q7slPyNgLt44yOneFuy
# bR/5WcF9ttE5yXnggxxgCto9sNHtNr9FB+kbNm7lPTsFA6fUpyUSj+Z2oxOzRVpD
# MYLa2ISuubAfdfX2HX1RETcn6LU1hHH3V6qu+olxyZjSnlpkdr6Mw30VapHxFPTy
# 2TUxuNty+rR1yIibar+YRcdmstf/zpKQdeTr5obSyBvbJ8BblW9Jb1hdaSreU0v4
# 6Mp79mwV+QMZDxGFqk+av6pX3WDG9XEg9FGomsrp0es0Rz11+iLsVT9qGTlrEOla
# P470I3gwsvKmOMs1jaqYWSRAuDpnpAdfoP7YO0kT+wzh7Qttg1DO8H8+4NkI6Iwh
# SkHC3uuOW+4Dwx1ubuZUNWZncnwa6lL2IsRyP64wggd6MIIFYqADAgECAgphDpDS
# AAAAAAADMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMK
# V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0
# IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZpY2F0
# ZSBBdXRob3JpdHkgMjAxMTAeFw0xMTA3MDgyMDU5MDlaFw0yNjA3MDgyMTA5MDla
# MH4xCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS
# ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMT
# H01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTEwggIiMA0GCSqGSIb3DQEB
# AQUAA4ICDwAwggIKAoICAQCr8PpyEBwurdhuqoIQTTS68rZYIZ9CGypr6VpQqrgG
# OBoESbp/wwwe3TdrxhLYC/A4wpkGsMg51QEUMULTiQ15ZId+lGAkbK+eSZzpaF7S
# 35tTsgosw6/ZqSuuegmv15ZZymAaBelmdugyUiYSL+erCFDPs0S3XdjELgN1q2jz
# y23zOlyhFvRGuuA4ZKxuZDV4pqBjDy3TQJP4494HDdVceaVJKecNvqATd76UPe/7
# 4ytaEB9NViiienLgEjq3SV7Y7e1DkYPZe7J7hhvZPrGMXeiJT4Qa8qEvWeSQOy2u
# M1jFtz7+MtOzAz2xsq+SOH7SnYAs9U5WkSE1JcM5bmR/U7qcD60ZI4TL9LoDho33
# X/DQUr+MlIe8wCF0JV8YKLbMJyg4JZg5SjbPfLGSrhwjp6lm7GEfauEoSZ1fiOIl
# XdMhSz5SxLVXPyQD8NF6Wy/VI+NwXQ9RRnez+ADhvKwCgl/bwBWzvRvUVUvnOaEP
# 6SNJvBi4RHxF5MHDcnrgcuck379GmcXvwhxX24ON7E1JMKerjt/sW5+v/N2wZuLB
# l4F77dbtS+dJKacTKKanfWeA5opieF+yL4TXV5xcv3coKPHtbcMojyyPQDdPweGF
# RInECUzF1KVDL3SV9274eCBYLBNdYJWaPk8zhNqwiBfenk70lrC8RqBsmNLg1oiM
# CwIDAQABo4IB7TCCAekwEAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFEhuZOVQ
# BdOCqhc3NyK1bajKdQKVMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMAsGA1Ud
# DwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFHItOgIxkEO5FAVO
# 4eqnxzHRI4k0MFoGA1UdHwRTMFEwT6BNoEuGSWh0dHA6Ly9jcmwubWljcm9zb2Z0
# LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dDIwMTFfMjAxMV8wM18y
# Mi5jcmwwXgYIKwYBBQUHAQEEUjBQME4GCCsGAQUFBzAChkJodHRwOi8vd3d3Lm1p
# Y3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dDIwMTFfMjAxMV8wM18y
# Mi5jcnQwgZ8GA1UdIASBlzCBlDCBkQYJKwYBBAGCNy4DMIGDMD8GCCsGAQUFBwIB
# FjNodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2RvY3MvcHJpbWFyeWNw
# cy5odG0wQAYIKwYBBQUHAgIwNB4yIB0ATABlAGcAYQBsAF8AcABvAGwAaQBjAHkA
# XwBzAHQAYQB0AGUAbQBlAG4AdAAuIB0wDQYJKoZIhvcNAQELBQADggIBAGfyhqWY
# 4FR5Gi7T2HRnIpsLlhHhY5KZQpZ90nkMkMFlXy4sPvjDctFtg/6+P+gKyju/R6mj
# 82nbY78iNaWXXWWEkH2LRlBV2AySfNIaSxzzPEKLUtCw/WvjPgcuKZvmPRul1LUd
# d5Q54ulkyUQ9eHoj8xN9ppB0g430yyYCRirCihC7pKkFDJvtaPpoLpWgKj8qa1hJ
# Yx8JaW5amJbkg/TAj/NGK978O9C9Ne9uJa7lryft0N3zDq+ZKJeYTQ49C/IIidYf
# wzIY4vDFLc5bnrRJOQrGCsLGra7lstnbFYhRRVg4MnEnGn+x9Cf43iw6IGmYslmJ
# aG5vp7d0w0AFBqYBKig+gj8TTWYLwLNN9eGPfxxvFX1Fp3blQCplo8NdUmKGwx1j
# NpeG39rz+PIWoZon4c2ll9DuXWNB41sHnIc+BncG0QaxdR8UvmFhtfDcxhsEvt9B
# xw4o7t5lL+yX9qFcltgA1qFGvVnzl6UJS0gQmYAf0AApxbGbpT9Fdx41xtKiop96
# eiL6SJUfq/tHI4D1nvi/a7dLl+LrdXga7Oo3mXkYS//WsyNodeav+vyL6wuA6mk7
# r/ww7QRMjt/fdW1jkT3RnVZOT7+AVyKheBEyIXrvQQqxP/uozKRdwaGIm1dxVk5I
# RcBCyZt2WwqASGv9eZ/BvW1taslScxMNelDNMYIWXDCCFlgCAQEwgZUwfjELMAkG
# A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx
# HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9z
# b2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAxMQITMwAAAQNeJRyZH6MeuAAAAAABAzAN
# BglghkgBZQMEAgEFAKCB3jAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgor
# BgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQgzqp902bh
# 8GuRc+DUx14Yn5S5/5fdJCCUe7xGgVSQGZMwcgYKKwYBBAGCNwIBDDFkMGKgSIBG
# AE0AaQBjAHIAbwBzAG8AZgB0ACAAQQB6AHUAcgBlAFMAdABhAGMAawAgAFAAYQBy
# AHQAbgBlAHIAVABvAG8AbABrAGkAdKEWgBRodHRwOi8vQ29kZVNpZ25JbmZvIDAN
# BgkqhkiG9w0BAQEFAASCAQBYW6N91bdSuN+KVGGLfAqWcLfJ2nLa+H2V8P2dnOiJ
# LbvtBNGNc+YEg5/7XUdrEFMwxbWR+5Ph+5RPZLrtDXXzlHn5nL2R6qSblTxHxpWz
# vCj05VU67oIkoOLLYdleorUYFdEM29JhCm8Z/Msxom5Js4xTheexwRveEcI/zLVh
# qwI86X+uwLhmYrHmAnvUeHQ9M6W6gv3v9+WXEuCebHCkR01xHuADdDiZ1dlWXPdd
# WNAelOMkVi3MXY8hKYpItxyRJ5DWyFgieQhh+/o3HGDzFyIXxRQKzVaJne3syWeI
# l20tKalc2P97mKcsV/VVvxaxxd2X96HS2Nf0VaQNJSbeoYITtjCCE7IGCisGAQQB
# gjcDAwExghOiMIITngYJKoZIhvcNAQcCoIITjzCCE4sCAQMxDzANBglghkgBZQME
# AgEFADCCAVcGCyqGSIb3DQEJEAEEoIIBRgSCAUIwggE+AgEBBgorBgEEAYRZCgMB
# MDEwDQYJYIZIAWUDBAIBBQAEIK6u6yLx6P/FbsjqcAx9prDUdFrCHRrbbithj9O4
# Iv/rAgZb2ciEIoAYEjIwMTgxMTAxMjE1MzUzLjMzWjAHAgEBgAIB9KCB1KSB0TCB
# zjELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl
# ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEpMCcGA1UECxMg
# TWljcm9zb2Z0IE9wZXJhdGlvbnMgUHVlcnRvIFJpY28xJjAkBgNVBAsTHVRoYWxl
# cyBUU1MgRVNOOjU4NDctRjc2MS00RjcwMSUwIwYDVQQDExxNaWNyb3NvZnQgVGlt
# ZS1TdGFtcCBTZXJ2aWNloIIPHzCCBPUwggPdoAMCAQICEzMAAADUTxnD2ITLRWMA
# AAAAANQwDQYJKoZIhvcNAQELBQAwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldh
# c2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBD
# b3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIw
# MTAwHhcNMTgwODIzMjAyNjQwWhcNMTkxMTIzMjAyNjQwWjCBzjELMAkGA1UEBhMC
# VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV
# BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEpMCcGA1UECxMgTWljcm9zb2Z0IE9w
# ZXJhdGlvbnMgUHVlcnRvIFJpY28xJjAkBgNVBAsTHVRoYWxlcyBUU1MgRVNOOjU4
# NDctRjc2MS00RjcwMSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2
# aWNlMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAv0i7sMQTtT74OGpo
# uWATfTY+WnmWenhQyL9pJAFK/a7LZOF32Fmgf00gimwjJckiYY72FBQx0UqDb3aT
# susoplv47VDf27/0klDF49EJ8gBIwhEWLYTHtFNRg98M5wOTzVKfuhjWXK1nzPsW
# 5/Qx6NGoQjfKDhPjMEsRpEzYPH8v0ef742MSvrRI4ydNswRZRX0mcdrx2hRFmIRo
# Ku4m4jadyHxkwdYBWE4mA4V1vZfS0MxFHcjbCPaW1UfuHw4NnbHsDwRv8L0QOESu
# pwbQA7wledA0Xj+fQchPb69P0lk17eyRGKneUgB+fHAL0JNbY+qqMuwGh1R0Uda3
# yQEbJQIDAQABo4IBGzCCARcwHQYDVR0OBBYEFP5k/7/EzmU2uNamuNJbShVglJcH
# MB8GA1UdIwQYMBaAFNVjOlyKMZDzQ3t8RhvFM2hahW1VMFYGA1UdHwRPME0wS6BJ
# oEeGRWh0dHA6Ly9jcmwubWljcm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01p
# Y1RpbVN0YVBDQV8yMDEwLTA3LTAxLmNybDBaBggrBgEFBQcBAQROMEwwSgYIKwYB
# BQUHMAKGPmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljVGlt
# U3RhUENBXzIwMTAtMDctMDEuY3J0MAwGA1UdEwEB/wQCMAAwEwYDVR0lBAwwCgYI
# KwYBBQUHAwgwDQYJKoZIhvcNAQELBQADggEBAEnI5BKJf8YlLqfOo0xeUA8dkzKY
# WUUpF1roTtBH5fmvsXLsVQx84IT8WKvAcqU2/2dnrMP/YFtz3qSrucNPZXIdjhEO
# WME9ELHrBKEWzHRmfm/DZuqorEPnQfaNboPXbJuyfxWc6tJn3h18adwiTJW7AIde
# Gf2e+D1v2qehOcrAtOC2l+rNRzCULRvKRgTS6o77geVG4V97yLKxLMF5ZdI89jN+
# q+8EHIsIB+ggteUYAGOX+WXZxR4/Ib/odk3ze9AD2FR+X1WlF1EzMrg9QUm4Aszm
# kld5wiR9HCbn7ji5EsAA8H6Irp8csHrRmXUl2WeVvysXxNjakP23cgQvEn8wggZx
# MIIEWaADAgECAgphCYEqAAAAAAACMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYDVQQG
# EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG
# A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3NvZnQg
# Um9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgMjAxMDAeFw0xMDA3MDEyMTM2NTVa
# Fw0yNTA3MDEyMTQ2NTVaMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5n
# dG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9y
# YXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMIIB
# IjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAqR0NvHcRijog7PwTl/X6f2mU
# a3RUENWlCgCChfvtfGhLLF/Fw+Vhwna3PmYrW/AVUycEMR9BGxqVHc4JE458YTBZ
# sTBED/FgiIRUQwzXTbg4CLNC3ZOs1nMwVyaCo0UN0Or1R4HNvyRgMlhgRvJYR4Yy
# hB50YWeRX4FUsc+TTJLBxKZd0WETbijGGvmGgLvfYfxGwScdJGcSchohiq9LZIlQ
# YrFd/XcfPfBXday9ikJNQFHRD5wGPmd/9WbAA5ZEfu/QS/1u5ZrKsajyeioKMfDa
# TgaRtogINeh4HLDpmc085y9Euqf03GS9pAHBIAmTeM38vMDJRF1eFpwBBU8iTQID
# AQABo4IB5jCCAeIwEAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFNVjOlyKMZDz
# Q3t8RhvFM2hahW1VMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMAsGA1UdDwQE
# AwIBhjAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNX2VsuP6KJcYmjRPZSQ
# W9fOmhjEMFYGA1UdHwRPME0wS6BJoEeGRWh0dHA6Ly9jcmwubWljcm9zb2Z0LmNv
# bS9wa2kvY3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNybDBa
# BggrBgEFBQcBAQROMEwwSgYIKwYBBQUHMAKGPmh0dHA6Ly93d3cubWljcm9zb2Z0
# LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3J0MIGgBgNV
# HSABAf8EgZUwgZIwgY8GCSsGAQQBgjcuAzCBgTA9BggrBgEFBQcCARYxaHR0cDov
# L3d3dy5taWNyb3NvZnQuY29tL1BLSS9kb2NzL0NQUy9kZWZhdWx0Lmh0bTBABggr
# BgEFBQcCAjA0HjIgHQBMAGUAZwBhAGwAXwBQAG8AbABpAGMAeQBfAFMAdABhAHQA
# ZQBtAGUAbgB0AC4gHTANBgkqhkiG9w0BAQsFAAOCAgEAB+aIUQ3ixuCYP4FxAz2d
# o6Ehb7Prpsz1Mb7PBeKp/vpXbRkws8LFZslq3/Xn8Hi9x6ieJeP5vO1rVFcIK1GC
# RBL7uVOMzPRgEop2zEBAQZvcXBf/XPleFzWYJFZLdO9CEMivv3/Gf/I3fVo/HPKZ
# eUqRUgCvOA8X9S95gWXZqbVr5MfO9sp6AG9LMEQkIjzP7QOllo9ZKby2/QThcJ8y
# Sif9Va8v/rbljjO7Yl+a21dA6fHOmWaQjP9qYn/dxUoLkSbiOewZSnFjnXshbcOc
# o6I8+n99lmqQeKZt0uGc+R38ONiU9MalCpaGpL2eGq4EQoO4tYCbIjggtSXlZOz3
# 9L9+Y1klD3ouOVd2onGqBooPiRa6YacRy5rYDkeagMXQzafQ732D8OE7cQnfXXSY
# Ighh2rBQHm+98eEA3+cxB6STOvdlR3jo+KhIq/fecn5ha293qYHLpwmsObvsxsvY
# grRyzR30uIUBHoD7G4kqVDmyW9rIDVWZeodzOwjmmC3qjeAzLhIp9cAvVCch98is
# TtoouLGp25ayp0Kiyc8ZQU3ghvkqmqMRZjDTu3QyS99je/WZii8bxyGvWbWu3EQ8
# l1Bx16HSxVXjad5XwdHeMMD9zOZN+w2/XU/pnR4ZOC+8z1gFLu8NoFA12u8JJxzV
# s341Hgi62jbb01+P3nSISRKhggOtMIIClQIBATCB/qGB1KSB0TCBzjELMAkGA1UE
# BhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAc
# BgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEpMCcGA1UECxMgTWljcm9zb2Z0
# IE9wZXJhdGlvbnMgUHVlcnRvIFJpY28xJjAkBgNVBAsTHVRoYWxlcyBUU1MgRVNO
# OjU4NDctRjc2MS00RjcwMSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBT
# ZXJ2aWNloiUKAQEwCQYFKw4DAhoFAAMVAO0ICv9f7xxmgMPCjIj5XADfKo9DoIHe
# MIHbpIHYMIHVMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4G
# A1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSkw
# JwYDVQQLEyBNaWNyb3NvZnQgT3BlcmF0aW9ucyBQdWVydG8gUmljbzEnMCUGA1UE
# CxMebkNpcGhlciBOVFMgRVNOOjU3RjYtQzFFMC01NTRDMSswKQYDVQQDEyJNaWNy
# b3NvZnQgVGltZSBTb3VyY2UgTWFzdGVyIENsb2NrMA0GCSqGSIb3DQEBBQUAAgUA
# 34Wu8zAiGA8yMDE4MTEwMjAwNTcyM1oYDzIwMTgxMTAzMDA1NzIzWjB0MDoGCisG
# AQQBhFkKBAExLDAqMAoCBQDfha7zAgEAMAcCAQACAgoSMAcCAQACAhkwMAoCBQDf
# hwBzAgEAMDYGCisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkKAwGgCjAIAgEAAgMW
# 42ChCjAIAgEAAgMHoSAwDQYJKoZIhvcNAQEFBQADggEBAB+PEnO7+Z6AlcaQuAT4
# 0sk422EoZUu4Gd4J9SWzPWP4B6Ia5KnABeVVVGeFFJpa7c7jKMgCvZUbtiGj7d0i
# 5V08rV36ld6ARfSm0lFMLPwL5Y/df0kDT3UHtJeWR1VOUmaHpqOPhAoOAQrlKAj5
# w+20CdOn5bTrFpVgf9Xze8AhnAO1V2F5GJEkzHYEo1xf/SGOBCseK+KJsMEXgXQU
# RkbxliEUkN4VnuLxg3aGU72tYwXCNtl2zuEaesVHtnNEunZpDsOLONTSUhcDju5i
# uea8Qdb2RR+zw9OAMUGfG62NvH89xT7I4WISKzo/MjghXZ1oGqs/GU+/Zg+Dml/a
# ovgxggL1MIIC8QIBATCBkzB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu
# Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv
# cmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAIT
# MwAAANRPGcPYhMtFYwAAAAAA1DANBglghkgBZQMEAgEFAKCCATIwGgYJKoZIhvcN
# AQkDMQ0GCyqGSIb3DQEJEAEEMC8GCSqGSIb3DQEJBDEiBCBLOdoeHDqmrszmKXfY
# l8KDQn1b/0w4ew23K8nvbmqQKjCB4gYLKoZIhvcNAQkQAgwxgdIwgc8wgcwwgbEE
# FO0ICv9f7xxmgMPCjIj5XADfKo9DMIGYMIGApH4wfDELMAkGA1UEBhMCVVMxEzAR
# BgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1p
# Y3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3Rh
# bXAgUENBIDIwMTACEzMAAADUTxnD2ITLRWMAAAAAANQwFgQUC/oMSdchUvb7k2Lg
# ElMXjmH6+uwwDQYJKoZIhvcNAQELBQAEggEABToJdwhKnKPwPwi2sdnanu6bHyk4
# 1eVFii0iufg0vjIriNE55/wISoD/CILxL9N4I2qSPAfirVikAzxjiKQCBhsJymfo
# HqXW9vhLMy0CrDTW9nmsOHHHtzV/xa/la4y6purKD5gymJDo10nRhmxJ0pgWj9e1
# foyJdYqqaFASuPbxMxjtgK4VANRHO1M9dtmI+r4aDgrKlcLdV5c7uackJT2IC3DD
# N+P4+J6BzYxF7hKrlc4afH3Npj7Z5keo2p5kgkBGJ8kROfg3MDUGa6fgiGcbI4By
# qAkI6Y0MBnNMRek3ou2DDoAA91R5ZXthWGSi4TNNPHf6LjvFAqyP3sLGxQ==
# SIG # End signature block