Functions/Public/New-AzUpgradeModulePlan.ps1
function New-AzUpgradeModulePlan { <# .SYNOPSIS Generates a new upgrade plan for migrating to the Az PowerShell module. .DESCRIPTION Generates a new upgrade plan for migrating to the Az PowerShell module. The upgrade plan details the specific file/offset points that require changes when moving from AzureRM commands to Az commands. .PARAMETER FromAzureRmVersion Specifies the AzureRM module version used in your existing PowerShell scripts(s) or modules. .PARAMETER ToAzVersion Specifies the Az module version to upgrade to. Currently, only Az version 9.3.0 is supported. .PARAMETER FilePath Specifies the path to a single PowerShell file. .PARAMETER DirectoryPath Specifies the path to a folder where PowerShell scripts or modules reside. .PARAMETER AzureRmCmdReference Specifies the AzureRM command references output from the Find-AzUpgradeCommandReference cmdlet. .PARAMETER AzureRmModuleSpec Specifies an optional parameter to provide a pre-loaded AzureRM module spec, returned from Get-AzUpgradeCmdletSpec. .PARAMETER AzModuleSpec Specifies an optional parameter to provide a pre-loaded Az module spec, returned from Get-AzUpgradeCmdletSpec. .PARAMETER AzAliasMappingSpec Specifies an optional parameter to provide a pre-loaded Az cmdlet alias mapping table, returned from Get-AzUpgradeAliasSpec. .EXAMPLE The following example generates a new Az module upgrade plan for the script file 'C:\Scripts\my-azure-script.ps1'. New-AzUpgradeModulePlan -FromAzureRmVersion 6.13.1 -ToAzVersion 9.3.0 -FilePath 'C:\Scripts\my-azure-script.ps1' .EXAMPLE The following example generates a new Az module upgrade plan for the script and module files located under C:\Scripts. New-AzUpgradeModulePlan -FromAzureRmVersion 6.13.1 -ToAzVersion 9.3.0 -DirectoryPath 'C:\Scripts' .EXAMPLE The following example generates a new Az module upgrade plan for the script and module files under C:\Scripts. $references = Find-AzUpgradeCommandReference -DirectoryPath 'C:\Scripts' -AzureRmVersion '6.13.1' New-AzUpgradeModulePlan -ToAzVersion 9.3.0 -AzureRmCmdReference $references .EXAMPLE The following example generates a new Az module upgrade plan for the script and module files under several directories. Module specs are pre-loaded here to avoid re-loading the spec each time a plan is generated. # pre-load specifications $armSpec = Get-AzUpgradeCmdletSpec -ModuleName "AzureRM" -ModuleVersion "6.13.1" $azSpec = Get-AzUpgradeCmdletSpec -ModuleName "Az" -ModuleVersion "9.3.0" $azAliases = Get-AzUpgradeAliasSpec -ModuleVersion "9.3.0" # execute a batch of module upgrades $plan1 = New-AzUpgradeModulePlan -DirectoryPath 'C:\Scripts1' -FromAzureRmVersion '6.13.1' -ToAzVersion '9.3.0' -AzureRmModuleSpec $armSpec -AzModuleSpec $azSpec -AzAliasMappingSpec $azAliases $plan2 = New-AzUpgradeModulePlan -DirectoryPath 'C:\Scripts2' -FromAzureRmVersion '6.13.1' -ToAzVersion '9.3.0' -AzureRmModuleSpec $armSpec -AzModuleSpec $azSpec -AzAliasMappingSpec $azAliases $plan3 = New-AzUpgradeModulePlan -DirectoryPath 'C:\Scripts3' -FromAzureRmVersion '6.13.1' -ToAzVersion '9.3.0' -AzureRmModuleSpec $armSpec -AzModuleSpec $azSpec -AzAliasMappingSpec $azAliases #> [CmdletBinding()] Param ( [Parameter( Mandatory=$true, ParameterSetName="FromReferences", HelpMessage='Specify the AzureRM command references collection output from the Find-AzUpgradeCommandReference cmdlet.')] [CommandReference[]] $AzureRmCmdReference, [Parameter( Mandatory=$true, ParameterSetName="FromNewSearchByFile", HelpMessage='Specify the Az module version to upgrade to.')] [Parameter( Mandatory=$true, ParameterSetName="FromNewSearchByDirectory", HelpMessage='Specify the Az module version to upgrade to.')] [System.String] [ValidateSet('6.13.1')] $FromAzureRmVersion, [Parameter( Mandatory=$true, ParameterSetName="FromNewSearchByFile", HelpMessage="Specify the path to a single PowerShell file.")] [System.String] [ValidateNotNullOrEmpty()] $FilePath, [Parameter( Mandatory=$true, ParameterSetName="FromNewSearchByDirectory", HelpMessage="Specify the path to the folder where PowerShell scripts or modules reside.")] [System.String] [ValidateNotNullOrEmpty()] $DirectoryPath, [Parameter( Mandatory=$true, HelpMessage='Specify the Az module version to upgrade to.')] [System.String] [ValidateSet('9.3.0')] $ToAzVersion, [Parameter(Mandatory=$false)] [System.Collections.Generic.Dictionary[System.String, CommandDefinition]] $AzureRmModuleSpec, [Parameter(Mandatory=$false)] [System.Collections.Generic.Dictionary[System.String, CommandDefinition]] $AzModuleSpec, [Parameter(Mandatory=$false)] [System.Collections.Generic.Dictionary[System.String, System.String]] $AzAliasMappingSpec ) Process { $cmdStarted = Get-Date # if an existing set of command references was not provided # then call the Find cmdlet to search for those references. if ($PSCmdlet.ParameterSetName -eq 'FromNewSearchByFile') { if ($PSBoundParameters.ContainsKey('AzureRmModuleSpec')) { Write-Verbose -Message "Searching for commands to upgrade, by file, with pre-loaded module spec." $AzureRmCmdReference = Find-AzUpgradeCommandReference -FilePath $FilePath -AzureRmModuleSpec $AzureRmModuleSpec } else { Write-Verbose -Message "Searching for commands to upgrade, by file." $AzureRmCmdReference = Find-AzUpgradeCommandReference -FilePath $FilePath -AzureRmVersion $FromAzureRmVersion } } elseif ($PSCmdlet.ParameterSetName -eq 'FromNewSearchByDirectory') { if ($PSBoundParameters.ContainsKey('AzureRmModuleSpec')) { Write-Verbose -Message "Searching for commands to upgrade, by directory, with pre-loaded module spec." $AzureRmCmdReference = Find-AzUpgradeCommandReference -DirectoryPath $DirectoryPath -AzureRmModuleSpec $AzureRmModuleSpec } else { Write-Verbose -Message "Searching for commands to upgrade, by directory." $AzureRmCmdReference = Find-AzUpgradeCommandReference -DirectoryPath $DirectoryPath -AzureRmVersion $FromAzureRmVersion } } # we can't generate an upgrade plan without some cmdlet references, so quit early here if required. if ($AzureRmCmdReference -eq $null -or $AzureRmCmdReference.Count -eq 0) { Write-Verbose -Message "No AzureRm command references were found. No upgrade plan will be generated." return } else { Write-Verbose -Message "$($AzureRmCmdReference.Count) AzureRm command reference(s) were found. Upgrade plan will be generated." } if ($PSBoundParameters.ContainsKey('AzModuleSpec') -eq $false) { Write-Verbose -Message "Importing cmdlet spec for Az $ToAzVersion" $AzModuleSpec = Get-AzUpgradeCmdletSpec -ModuleName "Az" -ModuleVersion $ToAzVersion } else { Write-Verbose -Message "Az module spec was provided at runtime, skipping module spec import." } if ($PSBoundParameters.ContainsKey('AzAliasMappingSpec') -eq $false) { Write-Verbose -Message "Importing alias mapping spec for Az $ToAzVersion" $AzAliasMappingSpec = Get-AzUpgradeAliasSpec -ModuleVersion $ToAzVersion } else { Write-Verbose -Message "Az alias mapping spec was provided at runtime, skipping alias spec import." } $defaultParamNames = @("Debug", "ErrorAction", "ErrorVariable", "InformationAction", "InformationVariable", "OutVariable", "OutBuffer", "PipelineVariable", "Verbose", "WarningAction", "WarningVariable", "WhatIf", "Confirm") # synchronous results output instead of async. the reason for this is that # we need to sort the object results before returning them to the caller. $planSteps = New-Object -TypeName 'System.Collections.Generic.List[UpgradePlan]' $planWarningSteps = New-Object -TypeName 'System.Collections.Generic.List[UpgradePlan]' $planErrorSteps = New-Object -TypeName 'System.Collections.Generic.List[UpgradePlan]' foreach ($rmCmdlet in $AzureRmCmdReference) { Write-Verbose -Message "Checking upgrade potential for instance of $($rmCmdlet.CommandName)" if ($AzAliasMappingSpec.ContainsKey($rmCmdlet.CommandName) -eq $false) { $errorResult = New-Object -TypeName UpgradePlan $errorResult.UpgradeType = [UpgradeStepType]::Cmdlet $errorResult.SourceCommand = $rmCmdlet $errorResult.FullPath = $rmCmdlet.FullPath $errorResult.StartOffset = $rmCmdlet.StartOffset $errorResult.Location = $rmCmdlet.Location $errorResult.Original = $rmCmdlet.CommandName $errorResult.PlanResultReason = "No matching upgrade alias found. Command cannot be automatically upgraded." $errorResult.PlanResult = [PlanResultReasonCode]::ErrorNoUpgradeAlias $errorResult.PlanSeverity = [DiagnosticSeverity]::Error $planErrorSteps.Add($errorResult) continue } $resolvedCommandName = $AzAliasMappingSpec[$rmCmdlet.CommandName] if ($AzModuleSpec.ContainsKey($resolvedCommandName) -eq $false) { $errorResult = New-Object -TypeName UpgradePlan $errorResult.UpgradeType = [UpgradeStepType]::Cmdlet $errorResult.SourceCommand = $rmCmdlet $errorResult.FullPath = $rmCmdlet.FullPath $errorResult.StartOffset = $rmCmdlet.StartOffset $errorResult.Location = $rmCmdlet.Location $errorResult.Original = $rmCmdlet.CommandName $errorResult.PlanResultReason = "No Az cmdlet spec found for $resolvedCommandName. Command cannot be automatically upgraded." $errorResult.PlanResult = [PlanResultReasonCode]::ErrorNoModuleSpecMatch $errorResult.PlanSeverity = [DiagnosticSeverity]::Error $planErrorSteps.Add($errorResult) continue } $cmdletUpgrade = New-Object -TypeName UpgradePlan $cmdletUpgrade.Original = $rmCmdlet.CommandName $cmdletUpgrade.Replacement = $resolvedCommandName $cmdletUpgrade.UpgradeType = [UpgradeStepType]::Cmdlet $cmdletUpgrade.SourceCommand = $rmCmdlet $cmdletUpgrade.FullPath = $rmCmdlet.FullPath $cmdletUpgrade.StartOffset = $rmCmdlet.StartOffset $cmdletUpgrade.Location = $rmCmdlet.Location $cmdletUpgrade.PlanResultReason = "Command can be automatically upgraded." $cmdletUpgrade.PlanResult = [PlanResultReasonCode]::ReadyToUpgrade $cmdletUpgrade.PlanSeverity = [DiagnosticSeverity]::Information $planSteps.Add($cmdletUpgrade) # check if parameters need to be updated if ($rmCmdlet.Parameters.Count -gt 0) { $resolvedAzCommand = $AzModuleSpec[$resolvedCommandName] foreach ($rmParam in $rmCmdlet.Parameters) { if ($defaultParamNames -contains $rmParam.Name) { # direct match to a built-in default parameter # no changes required. continue } $matchedDirectName = $resolvedAzCommand.Parameters | Where-Object -FilterScript { $_.Name -eq $rmParam.Name } if ($matchedDirectName -ne $null) { # direct match to the upgraded cmdlet's parameter name. # no changes required. continue } $matchedAliasName = $resolvedAzCommand.Parameters | Where-Object -FilterScript { $_.Aliases -contains $rmParam.Name } if ($matchedAliasName -ne $null) { # alias match to the upgraded cmdlet's parameter name. # we should add an upgrade step to swap to use the non-aliased name. $paramUpgrade = New-Object -TypeName UpgradePlan $paramUpgrade.Original = $rmParam.Name $paramUpgrade.Replacement = $matchedAliasName.Name $paramUpgrade.UpgradeType = [UpgradeStepType]::CmdletParameter $paramUpgrade.SourceCommand = $rmCmdlet $paramUpgrade.FullPath = $rmCmdlet.FullPath $paramUpgrade.StartOffset = $rmParam.StartOffset $paramUpgrade.SourceCommandParameter = $rmParam $paramUpgrade.Location = $rmParam.Location $paramUpgrade.PlanResultReason = "Command parameter can be automatically upgraded." $paramUpgrade.PlanResult = [PlanResultReasonCode]::ReadyToUpgrade $paramUpgrade.PlanSeverity = [DiagnosticSeverity]::Information $planSteps.Add($paramUpgrade) continue } # no direct match and no alias match? # this could mean a breaking change that requires manual adjustments, or it could be a dynamic parameter. if ($resolvedAzCommand.SupportsDynamicParameters) { $paramWarning = New-Object -TypeName UpgradePlan $paramWarning.Original = $rmParam.Name $paramWarning.UpgradeType = [UpgradeStepType]::CmdletParameter $paramWarning.SourceCommand = $rmCmdlet $paramWarning.FullPath = $rmCmdlet.FullPath $paramWarning.StartOffset = $rmParam.StartOffset $paramWarning.SourceCommandParameter = $rmParam $paramWarning.Location = $rmParam.Location $paramWarning.PlanResultReason = "Parameter was not found in $resolvedCommandName or its aliases, but this may not be a problem because this cmdlet also supports dynamic parameters." $paramWarning.PlanResult = [PlanResultReasonCode]::WarningDynamicParameter $paramWarning.PlanSeverity = [DiagnosticSeverity]::Warning $planErrorSteps.Add($paramWarning) } else { $paramError = New-Object -TypeName UpgradePlan $paramError.Original = $rmParam.Name $paramError.UpgradeType = [UpgradeStepType]::CmdletParameter $paramError.SourceCommand = $rmCmdlet $paramError.FullPath = $rmCmdlet.FullPath $paramError.StartOffset = $rmParam.StartOffset $paramError.SourceCommandParameter = $rmParam $paramError.Location = $rmParam.Location $paramError.PlanResultReason = "Parameter was not found in $resolvedCommandName or its aliases. This may indicate a breaking change that requires attention." $paramError.PlanResult = [PlanResultReasonCode]::ErrorParameterNotFound $paramError.PlanSeverity = [DiagnosticSeverity]::Error $planErrorSteps.Add($paramError) } } } } # send metrics, if enabled (and while the collections are still seperated) Send-MetricsIfDataCollectionEnabled -Operation Plan ` -ParameterSetName $PSCmdlet.ParameterSetName ` -Duration ((Get-Date) - $cmdStarted) ` -Properties ([PSCustomObject]@{ ToAzureModuleName = "Az" ToAzureModuleVersion = $ToAzVersion UpgradeStepsCount = $planSteps.Count PlanWarnings = $planWarningSteps PlanErrors = $planErrorSteps }) # join the collections into one output result. $planSteps.AddRange($planWarningSteps) $planSteps.AddRange($planErrorSteps) # sort the upgrade steps to by file, then offset descending. # the reason for this is updates must be made in descending offset order # otherwise file positions will change for subsequent swaps. $filter1 = @{ Expression = 'FullPath'; Ascending = $true } $filter2 = @{ Expression = 'StartOffset'; Descending = $true } $planSteps = $planSteps | Sort-Object -Property $filter1, $filter2 # now that we have a sorted collection, add in the step order number # for extra clarity in the upgrade plan. for ([int]$i = 0; $i -lt $planSteps.Count; $i++) { $planSteps[$i].Order = ($i + 1) } Write-Output -InputObject $planSteps } } # SIG # Begin signature block # MIInrQYJKoZIhvcNAQcCoIInnjCCJ5oCAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCD7ClDJKq+pL57n # 8nX+tLPxlK/qP76J8LKqaCQYKm6JyaCCDYEwggX/MIID56ADAgECAhMzAAACzI61 # lqa90clOAAAAAALMMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p # bmcgUENBIDIwMTEwHhcNMjIwNTEyMjA0NjAxWhcNMjMwNTExMjA0NjAxWjB0MQsw # CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u # ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB # AQCiTbHs68bADvNud97NzcdP0zh0mRr4VpDv68KobjQFybVAuVgiINf9aG2zQtWK # No6+2X2Ix65KGcBXuZyEi0oBUAAGnIe5O5q/Y0Ij0WwDyMWaVad2Te4r1Eic3HWH # UfiiNjF0ETHKg3qa7DCyUqwsR9q5SaXuHlYCwM+m59Nl3jKnYnKLLfzhl13wImV9 # DF8N76ANkRyK6BYoc9I6hHF2MCTQYWbQ4fXgzKhgzj4zeabWgfu+ZJCiFLkogvc0 # RVb0x3DtyxMbl/3e45Eu+sn/x6EVwbJZVvtQYcmdGF1yAYht+JnNmWwAxL8MgHMz # xEcoY1Q1JtstiY3+u3ulGMvhAgMBAAGjggF+MIIBejAfBgNVHSUEGDAWBgorBgEE # AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUiLhHjTKWzIqVIp+sM2rOHH11rfQw # UAYDVR0RBEkwR6RFMEMxKTAnBgNVBAsTIE1pY3Jvc29mdCBPcGVyYXRpb25zIFB1 # ZXJ0byBSaWNvMRYwFAYDVQQFEw0yMzAwMTIrNDcwNTI5MB8GA1UdIwQYMBaAFEhu # ZOVQBdOCqhc3NyK1bajKdQKVMFQGA1UdHwRNMEswSaBHoEWGQ2h0dHA6Ly93d3cu # bWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY0NvZFNpZ1BDQTIwMTFfMjAxMS0w # Ny0wOC5jcmwwYQYIKwYBBQUHAQEEVTBTMFEGCCsGAQUFBzAChkVodHRwOi8vd3d3 # Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01pY0NvZFNpZ1BDQTIwMTFfMjAx # MS0wNy0wOC5jcnQwDAYDVR0TAQH/BAIwADANBgkqhkiG9w0BAQsFAAOCAgEAeA8D # sOAHS53MTIHYu8bbXrO6yQtRD6JfyMWeXaLu3Nc8PDnFc1efYq/F3MGx/aiwNbcs # J2MU7BKNWTP5JQVBA2GNIeR3mScXqnOsv1XqXPvZeISDVWLaBQzceItdIwgo6B13 # vxlkkSYMvB0Dr3Yw7/W9U4Wk5K/RDOnIGvmKqKi3AwyxlV1mpefy729FKaWT7edB # d3I4+hldMY8sdfDPjWRtJzjMjXZs41OUOwtHccPazjjC7KndzvZHx/0VWL8n0NT/ # 404vftnXKifMZkS4p2sB3oK+6kCcsyWsgS/3eYGw1Fe4MOnin1RhgrW1rHPODJTG # AUOmW4wc3Q6KKr2zve7sMDZe9tfylonPwhk971rX8qGw6LkrGFv31IJeJSe/aUbG # dUDPkbrABbVvPElgoj5eP3REqx5jdfkQw7tOdWkhn0jDUh2uQen9Atj3RkJyHuR0 # GUsJVMWFJdkIO/gFwzoOGlHNsmxvpANV86/1qgb1oZXdrURpzJp53MsDaBY/pxOc # J0Cvg6uWs3kQWgKk5aBzvsX95BzdItHTpVMtVPW4q41XEvbFmUP1n6oL5rdNdrTM # j/HXMRk1KCksax1Vxo3qv+13cCsZAaQNaIAvt5LvkshZkDZIP//0Hnq7NnWeYR3z # 4oFiw9N2n3bb9baQWuWPswG0Dq9YT9kb+Cs4qIIwggd6MIIFYqADAgECAgphDpDS # 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/BvW1taslScxMNelDNMYIZgjCCGX4CAQEwgZUwfjELMAkG # A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx # HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9z # b2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAxMQITMwAAAsyOtZamvdHJTgAAAAACzDAN # BglghkgBZQMEAgEFAKCBrjAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgor # BgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQg/r8F2rgg # aLNI84yq/8QMd96PLHaN92HpXVIFdeNR+7wwQgYKKwYBBAGCNwIBDDE0MDKgFIAS # AE0AaQBjAHIAbwBzAG8AZgB0oRqAGGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbTAN # BgkqhkiG9w0BAQEFAASCAQBd9vWRymVCYF7J8Z/zuFAZkoDnepXXu5az5/qDXt5b # d4WPV0DOBSL+8uCen/dD9wYsobFjTBEJYt/G50jX7U9Igq9fKYvWqzEk+yDMIuho # AcUGxNy6q+oMmerlbwfFagY5Y8DM3tvAPgBSIXy5BEaq/pJzzVidYSlheSuvphUg # 9+zJ4o9G/4oU1JrwaaymL7HX1l5FWw9zjViwxigL7BaN+xENokU/EMR94C4Hca/R # Ik7U/AxIyR1ImvzvORmLGupoWPZrs6OLEZNYbNMHRErsEcEMoKV3cnaCByeMgWIp # ThrDmXGNcCfo9GxDEPBCbmOL6TXOcUppB4N4T0/IrXWuoYIXDDCCFwgGCisGAQQB # gjcDAwExghb4MIIW9AYJKoZIhvcNAQcCoIIW5TCCFuECAQMxDzANBglghkgBZQME # AgEFADCCAVUGCyqGSIb3DQEJEAEEoIIBRASCAUAwggE8AgEBBgorBgEEAYRZCgMB # MDEwDQYJYIZIAWUDBAIBBQAEIAB53WgKFQrVzGHX8uBsG3cg7X49q5seBEoNOeqY # tZOmAgZjoaHS5YAYEzIwMjMwMTE1MTM0MjEwLjUzNlowBIACAfSggdSkgdEwgc4x # CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt # b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKTAnBgNVBAsTIE1p # Y3Jvc29mdCBPcGVyYXRpb25zIFB1ZXJ0byBSaWNvMSYwJAYDVQQLEx1UaGFsZXMg # VFNTIEVTTjowQTU2LUUzMjktNEQ0RDElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUt # U3RhbXAgU2VydmljZaCCEV8wggcQMIIE+KADAgECAhMzAAABpzW7LsJkhVApAAEA # AAGnMA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo # aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y # cG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEw # MB4XDTIyMDMwMjE4NTEyMloXDTIzMDUxMTE4NTEyMlowgc4xCzAJBgNVBAYTAlVT # MRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQK # ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKTAnBgNVBAsTIE1pY3Jvc29mdCBPcGVy # YXRpb25zIFB1ZXJ0byBSaWNvMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjowQTU2 # LUUzMjktNEQ0RDElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2Vydmlj # ZTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAO0jOMYdUAXecCWm5V6T # RoQZ4hsPLe0Vp6CwxFiTA5l867fAbDyxnKzdfBsf/0XJVXzIkcvzCESXoklvMDBD # a97SEv+CuLEIooMbFBH1WeYgmLVO9TbbLStJilNITmQQQ4FB5qzMEsDfpmaZZMWW # gdOjoSQed9UrjjmcuWsSskntiaUD/VQdQcLMnpeUGc7CQsAYo9HcIMb1H8DTcZ7y # Ae3aOYf766P2OT553/4hdnJ9Kbp/FfDeUAVYuEc1wZlmbPdRa/uCx4iKXpt80/5w # oAGSDl8vSNFxi4umXKCkwWHm8GeDZ3tOKzMIcIY/64FtpdqpNwbqGa3GkJToEFPR # 6D6XJ0WyqebZvOZjMQEeLCJIrSnF4LbkkfkX4D4scjKz92lI9LRurhMPTBEQ6pw3 # iGsEPY+Jrcx/DJmyQWqbpN3FskWu9xhgzYoYsRuisCb5FIMShiallzEzum5xLE4U # 5fuxEbwk0uY9ZVDNVfEhgiQedcSAd3GWvVM36gtYy6QJfixD7ltwjSm5sVa1voBf # 2WZgCC3r4RE7VnovlqbCd3nHyXv5+8UGTLq7qRdRQQaBQXekT9UjUubcNS8ZYeZw # K8d2etD98mSI4MqXcMySRKUJ9OZVQNWzI3LyS5+CjIssBHdv19aM6CjXQuZkkmlZ # OtMqkLRg1tmhgI61yFC+jxB3AgMBAAGjggE2MIIBMjAdBgNVHQ4EFgQUH2y4fwWY # LjCFb+EOQgPz9PpaRYMwHwYDVR0jBBgwFoAUn6cVXQBeYl2D9OXSZacbUzUZ6XIw # XwYDVR0fBFgwVjBUoFKgUIZOaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9w # cy9jcmwvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3Js # MGwGCCsGAQUFBwEBBGAwXjBcBggrBgEFBQcwAoZQaHR0cDovL3d3dy5taWNyb3Nv # ZnQuY29tL3BraW9wcy9jZXJ0cy9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENB # JTIwMjAxMCgxKS5jcnQwDAYDVR0TAQH/BAIwADATBgNVHSUEDDAKBggrBgEFBQcD # CDANBgkqhkiG9w0BAQsFAAOCAgEATxL6MfPZOhR91DHShlzal7B8vOCUvzlvbVha # 0UzhZfvIcZA/bT3XTXbQPLnIDWlRdjQX7PGkORhX/mpjZCC5J7fD3TJMn9ZQQ8MX # nJ0sx3/QJIlNgPVaOpk9Yk1YEqyItOyPHr3Om3v/q9h5f5qDk0IMV2taosze0JGl # M3M5z7bGkDly+TfhH9lI03D/FzLjjzW8EtvcqmmH68QHdTsl84NWGkd2dUlVF2aB # WMUprb8H9EhPUQcBcpf11IAj+f04yB3ncQLh+P+PSS2kxNLLeRg9CWbmsugplYP1 # D5wW+aH2mdyBlPXZMIaERJFvZUZyD8RfJ8AsE3uU3JSd408QBDaXDUf94Ki3wEXT # tl8JQItGc3ixRYWNIghraI4h3d/+266OB6d0UM2iBXSqwz8tdj+xSST6G7ZYqxat # Ezt806T1BBHe9tZ/mr2S52UjJgAVQBgCQiiiixNO27g5Qy4CDS94vT4nfC2lXwLl # hrAcNqnAJKmRqK8ehI50TTIZGONhdhGcM5xUVeHmeRy9G6ufU6B6Ob0rW6LXY2qT # LXvgt9/x/XEh1CrnuWeBWa9E307AbePaBopu8+WnXjXy6N01j/AVBq1TyKnQX1nS # MjU9gZ3EaG8oS/zNM59HK/IhnAzWeVcdBYrq/hsu9JMvBpF+ZEQY2ZWpbEJm7ELl # /CuRIPAwggdxMIIFWaADAgECAhMzAAAAFcXna54Cm0mZAAAAAAAVMA0GCSqGSIb3 # DQEBCwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4G # A1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTIw # MAYDVQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgMjAx # MDAeFw0yMTA5MzAxODIyMjVaFw0zMDA5MzAxODMyMjVaMHwxCzAJBgNVBAYTAlVT # MRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQK # ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1l # LVN0YW1wIFBDQSAyMDEwMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA # 5OGmTOe0ciELeaLL1yR5vQ7VgtP97pwHB9KpbE51yMo1V/YBf2xK4OK9uT4XYDP/ # XE/HZveVU3Fa4n5KWv64NmeFRiMMtY0Tz3cywBAY6GB9alKDRLemjkZrBxTzxXb1 # hlDcwUTIcVxRMTegCjhuje3XD9gmU3w5YQJ6xKr9cmmvHaus9ja+NSZk2pg7uhp7 # M62AW36MEBydUv626GIl3GoPz130/o5Tz9bshVZN7928jaTjkY+yOSxRnOlwaQ3K # Ni1wjjHINSi947SHJMPgyY9+tVSP3PoFVZhtaDuaRr3tpK56KTesy+uDRedGbsoy # 1cCGMFxPLOJiss254o2I5JasAUq7vnGpF1tnYN74kpEeHT39IM9zfUGaRnXNxF80 # 3RKJ1v2lIH1+/NmeRd+2ci/bfV+AutuqfjbsNkz2K26oElHovwUDo9Fzpk03dJQc # NIIP8BDyt0cY7afomXw/TNuvXsLz1dhzPUNOwTM5TI4CvEJoLhDqhFFG4tG9ahha # YQFzymeiXtcodgLiMxhy16cg8ML6EgrXY28MyTZki1ugpoMhXV8wdJGUlNi5UPkL # iWHzNgY1GIRH29wb0f2y1BzFa/ZcUlFdEtsluq9QBXpsxREdcu+N+VLEhReTwDwV # 2xo3xwgVGD94q0W29R6HXtqPnhZyacaue7e3PmriLq0CAwEAAaOCAd0wggHZMBIG # CSsGAQQBgjcVAQQFAgMBAAEwIwYJKwYBBAGCNxUCBBYEFCqnUv5kxJq+gpE8RjUp # zxD/LwTuMB0GA1UdDgQWBBSfpxVdAF5iXYP05dJlpxtTNRnpcjBcBgNVHSAEVTBT # MFEGDCsGAQQBgjdMg30BATBBMD8GCCsGAQUFBwIBFjNodHRwOi8vd3d3Lm1pY3Jv # c29mdC5jb20vcGtpb3BzL0RvY3MvUmVwb3NpdG9yeS5odG0wEwYDVR0lBAwwCgYI # KwYBBQUHAwgwGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBDAEEwCwYDVR0PBAQDAgGG # MA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU1fZWy4/oolxiaNE9lJBb186a # GMQwVgYDVR0fBE8wTTBLoEmgR4ZFaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3Br # aS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3JsMFoGCCsG # AQUFBwEBBE4wTDBKBggrBgEFBQcwAoY+aHR0cDovL3d3dy5taWNyb3NvZnQuY29t # L3BraS9jZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcnQwDQYJKoZIhvcN # AQELBQADggIBAJ1VffwqreEsH2cBMSRb4Z5yS/ypb+pcFLY+TkdkeLEGk5c9MTO1 # OdfCcTY/2mRsfNB1OW27DzHkwo/7bNGhlBgi7ulmZzpTTd2YurYeeNg2LpypglYA # A7AFvonoaeC6Ce5732pvvinLbtg/SHUB2RjebYIM9W0jVOR4U3UkV7ndn/OOPcbz # aN9l9qRWqveVtihVJ9AkvUCgvxm2EhIRXT0n4ECWOKz3+SmJw7wXsFSFQrP8DJ6L # GYnn8AtqgcKBGUIZUnWKNsIdw2FzLixre24/LAl4FOmRsqlb30mjdAy87JGA0j3m # Sj5mO0+7hvoyGtmW9I/2kQH2zsZ0/fZMcm8Qq3UwxTSwethQ/gpY3UA8x1RtnWN0 # SCyxTkctwRQEcb9k+SS+c23Kjgm9swFXSVRk2XPXfx5bRAGOWhmRaw2fpCjcZxko # JLo4S5pu+yFUa2pFEUep8beuyOiJXk+d0tBMdrVXVAmxaQFEfnyhYWxz/gq77EFm # PWn9y8FBSX5+k77L+DvktxW/tM4+pTFRhLy/AsGConsXHRWJjXD+57XQKBqJC482 # 2rpM+Zv/Cuk0+CQ1ZyvgDbjmjJnW4SLq8CdCPSWU5nR0W2rRnj7tfqAxM328y+l7 # vzhwRNGQ8cirOoo6CGJ/2XBjU02N7oJtpQUQwXEGahC0HVUzWLOhcGbyoYIC0jCC # AjsCAQEwgfyhgdSkgdEwgc4xCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5n # dG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9y # YXRpb24xKTAnBgNVBAsTIE1pY3Jvc29mdCBPcGVyYXRpb25zIFB1ZXJ0byBSaWNv # MSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjowQTU2LUUzMjktNEQ0RDElMCMGA1UE # AxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaIjCgEBMAcGBSsOAwIaAxUA # wH7vHimSAzeDLN0qzWNb2p2vRH+ggYMwgYCkfjB8MQswCQYDVQQGEwJVUzETMBEG # A1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWlj # cm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFt # cCBQQ0EgMjAxMDANBgkqhkiG9w0BAQUFAAIFAOduZsgwIhgPMjAyMzAxMTUxNTQ5 # MjhaGA8yMDIzMDExNjE1NDkyOFowdzA9BgorBgEEAYRZCgQBMS8wLTAKAgUA525m # yAIBADAKAgEAAgIQpgIB/zAHAgEAAgIRfTAKAgUA52+4SAIBADA2BgorBgEEAYRZ # CgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIBAAIDB6EgoQowCAIBAAIDAYagMA0G # CSqGSIb3DQEBBQUAA4GBAJskYriF7ggXUpTcZXCwks/oq1lsBkUtwYxJF1DOvApl # zXqCx5mu55mBWjckJGMQ6IZ4XAFaomno8FZySC3vINSEz9hYY8YA+Vv3jHUGKuqF # EmQzF+yxJ3Zv2Z3Uo0oQj3xlVr2ZkV/Y3v2LXX7xrngTURfoG+N6QoznaAkTjP7z # MYIEDTCCBAkCAQEwgZMwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0 # b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3Jh # dGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMA # AAGnNbsuwmSFUCkAAQAAAacwDQYJYIZIAWUDBAIBBQCgggFKMBoGCSqGSIb3DQEJ # AzENBgsqhkiG9w0BCRABBDAvBgkqhkiG9w0BCQQxIgQglsvEXee6QnIRoPmaJo1/ # 3hnY2tlkrJm+x5YNvnQKe+UwgfoGCyqGSIb3DQEJEAIvMYHqMIHnMIHkMIG9BCBH # 8H/nCZUC4L0Yqbz3sH3w5kzhwJ4RqCkXXKxNPtqOGzCBmDCBgKR+MHwxCzAJBgNV # BAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4w # HAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29m # dCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAABpzW7LsJkhVApAAEAAAGnMCIEIJHI # 4VbqCua3xNfoxiNrHDyyiISc5TI1q0f+oxPctHRQMA0GCSqGSIb3DQEBCwUABIIC # ANgAU5iQz1pyf/7+CXlohJfrzbJQCdz4LEsfZ011kaWG3o3PgmTt9SDxKW/ynqvV # SuvKFcOejjyEedXqbdAtDQuhMDI4jvLeWHT+mHvR/B181h8VhRCX8oHntDqatjl/ # 8aAJPDrQVej1EjiPwZTEU2xrVqJCTOI2hkpnop3YQadFRSsbZnfIn8dKPz3WqtVV # 4LREuPEJoCuS4vTlqWHTvFLIQvxiiUNI7Y/luZV39jBXaVW7h5DQiWstsDWM/dUC # uPAnTgkEBBUCLRw8jhuGtZ5pQUjyW+GkYhPaGpuEHn+iyzRk+YK3FBwAopJt3vay # 3J62JRXf8/xfx/Xa+wDX+1eKodD0ol5dVerl7s7SHWiPjI4hUAlHZhP4psSj/iY5 # SUWmcCFcGXNlH4z15xD3gdrHKDfbm2R3GVm5WNM7wfc7pV/otr08xP0vUI7eK/Vj # ZdDDRL+X8Nw+/1vveB7ncT/7ELNpr5GkerVidtrM0dQD+/+IYzZMl+UQ5BBzWbSH # 9yPYfEUP+miAnjNLMV4j849guoSt2dA2PyXG4NNZTkmuckkJST2y0g0MfulrsWsM # nyB1kOJ2DVtopaAHin+qJ1qAQoLwmWtSIaU0tkgkfvHNictEGMbr7iqxDzq5YC8t # fR2b/NQfGe5m+U7yvY/VDQW6ukvtOSpuHdOdVqeIxMpF # SIG # End signature block |