Microsoft.AzureStack.ReadinessChecker.psm1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
#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