Migrate.Autorest/custom/Helper/AzLocalCommonHelper.ps1
|
function CheckResourceGraphModuleDependency { [Microsoft.Azure.PowerShell.Cmdlets.Migrate.DoNotExportAttribute()] param() process { $module = Get-Module -ListAvailable | Where-Object { $_.Name -eq "Az.ResourceGraph" } if ($null -eq $module) { $message = "Az.ResourceGraph Module must be installed to run this command. Please run 'Install-Module -Name Az.ResourceGraph' to install and continue." throw $message } } } function CheckResourcesModuleDependency { [Microsoft.Azure.PowerShell.Cmdlets.Migrate.DoNotExportAttribute()] param() process { $module = Get-Module -ListAvailable | Where-Object { $_.Name -eq "Az.Resources" } if ($null -eq $module) { $message = "Az.Resources Module must be installed to run this command. Please run 'Install-Module -Name Az.Resources' to install and continue." throw $message } } } function CheckStorageModuleDependency { [Microsoft.Azure.PowerShell.Cmdlets.Migrate.DoNotExportAttribute()] param() process { $module = Get-Module -ListAvailable | Where-Object { $_.Name -eq "Az.Storage" } if ($null -eq $module) { $message = "Az.Storage Module must be installed to run this command. Please run 'Install-Module -Name Az.Storage' to install and continue." throw $message } } } function GetARGQueryForArcResourceBridge { [Microsoft.Azure.PowerShell.Cmdlets.Migrate.DoNotExportAttribute()] param( [Parameter(Mandatory)] [System.String] # Specifies HCI Cluster Id. ${HCIClusterID} ) process { $query = @" resources | where type == 'microsoft.extendedlocation/customlocations' | mv-expand ClusterId = properties['clusterExtensionIds'] | extend ClusterId = toupper(tostring(ClusterId)) | extend CustomLocation = toupper(tostring(id)) | extend resourceBridgeID = toupper(tostring(properties['hostResourceId'])) | extend customLocationRegion = location | join ( kubernetesconfigurationresources | where type == 'microsoft.kubernetesconfiguration/extensions' | where properties['ConfigurationSettings']['HCIClusterID'] =~ '$HCIClusterID' | project ClusterId = id | extend ClusterId = toupper(tostring(ClusterId)) ) on ClusterId | join ( resources | where type == 'microsoft.resourceconnector/appliances' | where properties['provisioningState'] == 'Succeeded' | extend statusOfTheBridge = properties['status'] | extend resourceBridgeID = toupper(tostring(id)) ) on resourceBridgeID "@ return $query } } function IsReservedOrTrademarked { [Microsoft.Azure.PowerShell.Cmdlets.Migrate.DoNotExportAttribute()] param( [Parameter(Mandatory)] [System.String] # Specifies VM name. ${Value} ) $uppercased = $Value.ToUpper(); # cannot be exactly one of these, but could be slightly different (e.g. hololens2) $reservedWords = @( "ACCESS", "APP_CODE", "APP_THEMES", "APP_DATA", "APP_GLOBALRESOURCES", "APP_LOCALRESOURCES", "APP_WEBREFERENCES", "APP_BROWSERS", "AZURE", "BING", "BIZSPARK", "BIZTALK", "CORTANA", "DIRECTX", "DOTNET", "DYNAMICS", "EXCEL", "EXCHANGE", "FOREFRONT", "GROOVE", "HOLOLENS", "HYPERV", "KINECT", "LYNC", "MSDN", "O365", "OFFICE", "OFFICE365", "ONEDRIVE", "ONENOTE", "OUTLOOK", "POWERPOINT", "SHAREPOINT", "SKYPE", "VISIO", "VISUALSTUDIO" ) # The following words can't be used as either a whole word or a substring in the name: $microsoft = "MICROSOFT"; $windows = "WINDOWS"; # The following words can't be used at the start of a resource name, but can be used later in the name: $startLogin = "LOGIN"; $startXbox = "XBOX"; if ($uppercased.startsWith($startLogin) -or $uppercased.startsWith($startXbox)) { return $true; } if ($uppercased.contains($microsoft) -or $uppercased.contains($windows)) { return $true; } foreach ($reservedName in $reservedWords) { if ($uppercased -eq $reservedName) { return $true; } } return $false; } function GenerateHashForArtifact { [Microsoft.Azure.PowerShell.Cmdlets.Migrate.DoNotExportAttribute()] param( [Parameter(Mandatory)] [System.String] # Specifies resource group name. ${Artifact} ) $hashCode = 0 $artifactLength = $Artifact.Length $tempItemLength = 0 if ($artifactLength -gt 0) { while ($tempItemLength -lt $artifactLength) { $hashCode = ((($hashCode -shl 5) - $hashCode) + $Artifact[$tempItemLength++] -bor 0) # Treat as Double, then convert to Bytes, then convert back to Int32 to match JavaScript behavior $hashCode = [System.BitConverter]::ToInt32([System.BitConverter]::GetBytes($hashCode), 0) } } if ($hashCode -lt 0) { return -1 * $hashCode } else { return $hashCode } } function InvokeAzMigrateGetCommandWithRetries { [Microsoft.Azure.PowerShell.Cmdlets.Migrate.DoNotExportAttribute()] param( [Parameter(Mandatory)] [System.String] # Specifies the name of Az.Migrate command. ${CommandName}, [Parameter(Mandatory)] [System.Collections.Hashtable] # Specifies the parameters for Az.Migrate command. ${Parameters}, [Parameter()] [System.Int32] # Specifies the maximum number of retries. ${MaxRetryCount} = 3, [Parameter()] [System.Int32] # Specifies the delay between retries in seconds. ${RetryDelayInSeconds} = 30, [Parameter()] [System.String] # Specifies the error message to throw if command fails. ${ErrorMessage} = "Internal Az.Migrate commands failed to execute." ) process { # Filter out ErrorAction and ErrorVariable from the parameters $params = @{} foreach ($key in $Parameters.Keys) { if ($key -ne "ErrorAction" -and $key -ne "ErrorVariable") { $params[$key] = $Parameters[$key] } } # Extract user-specified ErrorAction and ErrorVariable or defaults # but do not include them in $params if ($Parameters.ContainsKey("ErrorVariable")) { $errorVariable = $Parameters["ErrorVariable"] } else { $errorVariable = "notPresent" } if ($Parameters.ContainsKey("ErrorAction")) { $errorAction = $Parameters["ErrorAction"] } else { $errorAction = "Continue" } for ($i = 0; $i -le $MaxRetryCount; $i++) { try { $result = & $CommandName @params -ErrorVariable $errorVariable -ErrorAction $errorAction if ($null -eq $result) { throw $ErrorMessage } break } catch { if ($i -lt $MaxRetryCount) { Start-Sleep -Seconds $RetryDelayInSeconds } else { throw "Get command failed after $MaxRetryCount retries. Error: $($_.Exception)" } } } return $result } } function Test-ReplicationPrequisites { [Microsoft.Azure.PowerShell.Cmdlets.Migrate.DoNotExportAttribute()] param ( [Parameter(Mandatory)] [string] ${ResourceGroupName}, [Parameter(Mandatory)] [string] ${VaultName}, [Parameter(Mandatory)] [string] ${ProtectedItemName}, [Parameter(Mandatory)] [System.String] ${MigrationType} ) # Check if the VM is already protected $protectedItem = Az.Migrate.Internal\Get-AzMigrateProtectedItem ` -ResourceGroupName $ResourceGroupName ` -VaultName $VaultName ` -Name $ProtectedItemName ` -ErrorAction SilentlyContinue if ($null -ne $protectedItem) { throw $VmReplicationValidationMessages.AlreadyInReplication } # Check the VM power status if ($Machine.PowerStatus -eq $PowerStatus.OffVMware -or $Machine.PowerStatus -eq $PowerStatus.OffHyperV) { throw $VmReplicationValidationMessages.VmPoweredOff } # Hyper-V scenario checks if ($MigrationType -eq $AzLocalInstanceTypes.HyperVToAzLocal) { # Hyper-V VMs with 'otherguestfamily' OS type and missing OS name could also mean Hyper-V Integration Services are not running if ([string]::IsNullOrEmpty($Machine.OperatingSystemDetailOSType) -or ($Machine.OperatingSystemDetailOSType -eq $OsTypes.OtherGuestFamily -and [string]::IsNullOrEmpty($Machine.GuestOSDetailOsname))) { throw $VmReplicationValidationMessages.HyperVIntegrationServicesNotRunning } # Hyper-V VMs should be highly available if (![string]::IsNullOrEmpty($Machine.ClusterId) -and $Machine.HighAvailability -eq $HighAvailability.NO) { throw $VmReplicationValidationMessages.VmNotHighlyAvailable } } # VMware scenario checks if ($MigrationType -eq $AzLocalInstanceTypes.VMwareToAzLocal) { # VMware tools should be running to support static ip migration if ($Machine.VMwareToolsStatus -eq $VMwareToolsStatus.NotRunning) { Write-Warning $VmReplicationValidationMessages.VmWareToolsNotRunning } if ($Machine.VMwareToolsStatus -eq $VMwareToolsStatus.NotInstalled) { Write-Warning $VmReplicationValidationMessages.VmWareToolsNotInstalled } } # Only OS type of windowsguest and linuxguest are supported for Hyper-V and VMware scenarios if ($Machine.OperatingSystemDetailOSType -ne $OsTypes.WindowsGuest -and $Machine.OperatingSystemDetailOSType -ne $OsTypes.LinuxGuest) { Write-Warning $VmReplicationValidationMessages.OsTypeNotSupported } } function Test-AzureResourceIdFormat { [Microsoft.Azure.PowerShell.Cmdlets.Migrate.DoNotExportAttribute()] param( [Parameter(Mandatory = $true)] [string] $Data, [Parameter(Mandatory = $true)] [string] $Format ) try { if ([string]::IsNullOrWhiteSpace($Data)) { return $false } # Find where format string starts (after first /) $firstTokenEnd = $Format.IndexOf("/", 1) if ($firstTokenEnd -eq -1) { return $false } $formatPrefix = $Format.Substring(0, $firstTokenEnd) $matchIndex = $Data.ToLower().IndexOf($formatPrefix.ToLower()) if ($matchIndex -eq -1) { return $false } $processData = $Data.Substring($matchIndex) $processFormat = $Format $tokens = @() $counter = 0 while ($true) { $markerPattern = "{$counter}" $markerStartIndex = $processFormat.IndexOf($markerPattern) if ($markerStartIndex -eq -1) { break } $markerEndIndex = $processData.IndexOf("/", $markerStartIndex) if ($markerEndIndex -eq -1) { $token = $processData.Substring($markerStartIndex) if ([string]::IsNullOrWhiteSpace($token)) { return $false } $tokens += $token } else { $token = $processData.Substring($markerStartIndex, $markerEndIndex - $markerStartIndex) if ([string]::IsNullOrWhiteSpace($token)) { return $false } $tokens += $token $processData = $processData.Substring($markerEndIndex) $processFormat = $processFormat.Substring($markerStartIndex + $markerPattern.Length) } $counter++ } # Verify format matches with the extracted tokens $formatWithTokens = $Format for ($i = 0; $i -lt $tokens.Count; $i++) { $formatWithTokens = $formatWithTokens -replace "\{$i\}", $tokens[$i] } return $Data.ToLower() -like $formatWithTokens.ToLower() } catch { return $false } } function New-AzMigrateSolutionNotFoundException { [Microsoft.Azure.PowerShell.Cmdlets.Migrate.DoNotExportAttribute()] param( [Parameter(Mandatory)] [string] ${Name}, [Parameter(Mandatory)] [string] ${ResourceGroupName}, [Parameter(Mandatory)] [string] ${ProjectName} ) return "No Azure Migrate Solution '$Name' found in resource group '$ResourceGroupName' and project '$ProjectName'. Please verify your appliance setup." } function New-ReplicationVaultNotFoundInAMHSolutionException { [Microsoft.Azure.PowerShell.Cmdlets.Migrate.DoNotExportAttribute()] param( [Parameter(Mandatory)] [string] ${VaultId} ) return "Invalid replication vault ID '$VaultId' found in Azure Migrate Solution 'Servers-Migration-ServerMigration_DataReplication'. Please reach out to Microsoft support for assistance if this issue persists." } function New-InvalidResourceIdProvidedException { [Microsoft.Azure.PowerShell.Cmdlets.Migrate.DoNotExportAttribute()] param( [Parameter(Mandatory)] [string] ${ResourceId}, [Parameter(Mandatory)] [ValidateSet("MigrateProject", "Job", "ProtectedItem", "ResourceGroup", "DiscoveredMachine", "StorageContainer", "LogicalNetwork")] [string] ${ResourceType}, [Parameter(Mandatory)] [string] ${Format} ) return "Invalid '$ResourceType' Id '$ResourceId' provided. Please provide a valid '$ResourceType' ARM id with format '$Format'." } function New-AzMigrateSiteNotFoundException { [Microsoft.Azure.PowerShell.Cmdlets.Migrate.DoNotExportAttribute()] param( [Parameter(Mandatory)] [string] ${Name}, [Parameter(Mandatory)] [string] ${ResourceGroupName}, [Parameter(Mandatory)] [string] ${SiteType} ) return "Machine site '$Name' with Type '$SiteType' not found. Please verify in your Azure Migrate project resource group '$ResourceGroupName' and re-run this command if exists." } function New-AzMigrateProtectedItemNotFoundException { [Microsoft.Azure.PowerShell.Cmdlets.Migrate.DoNotExportAttribute()] param( [Parameter(Mandatory)] [string] ${Id} ) return "Replication item is not found with Id '$Id'. Re-run this command if exists." } function New-AzMigrateDiscoveredMachineNotFoundException { [Microsoft.Azure.PowerShell.Cmdlets.Migrate.DoNotExportAttribute()] param( [Parameter(Mandatory)] [string] ${Name}, [Parameter(Mandatory)] [string] ${ResourceGroupName}, [Parameter(Mandatory)] [string] ${SiteName} ) return "Machine '$Name' not found in resource group '$ResourceGroupName' and site '$SiteName'." } function New-OffAzureResourceNotFoundException { [Microsoft.Azure.PowerShell.Cmdlets.Migrate.DoNotExportAttribute()] param( [Parameter(Mandatory)] [ValidateSet("HyperV", "VMware")] [string] ${Scenario}, [Parameter(Mandatory)] [string] [ValidateSet("Host", "Cluster", "VCenter")] ${Type}, [Parameter(Mandatory)] [string] ${Name}, [Parameter(Mandatory)] [string] ${ResourceGroupName}, [Parameter(Mandatory)] [string] ${SiteName} ) return "'$Scenario' '$Name' not found in resource group '$ResourceGroupName' and site '$SiteName'." } # SIG # Begin signature block # MIIoVQYJKoZIhvcNAQcCoIIoRjCCKEICAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCv9WyQfgSrIIJm # LQ5ifs2yF9hc7Gemvh+B0ROGut+deqCCDYUwggYDMIID66ADAgECAhMzAAAEhJji # EuB4ozFdAAAAAASEMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p # bmcgUENBIDIwMTEwHhcNMjUwNjE5MTgyMTM1WhcNMjYwNjE3MTgyMTM1WjB0MQsw # CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u # ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB # AQDtekqMKDnzfsyc1T1QpHfFtr+rkir8ldzLPKmMXbRDouVXAsvBfd6E82tPj4Yz # aSluGDQoX3NpMKooKeVFjjNRq37yyT/h1QTLMB8dpmsZ/70UM+U/sYxvt1PWWxLj # MNIXqzB8PjG6i7H2YFgk4YOhfGSekvnzW13dLAtfjD0wiwREPvCNlilRz7XoFde5 # KO01eFiWeteh48qUOqUaAkIznC4XB3sFd1LWUmupXHK05QfJSmnei9qZJBYTt8Zh # ArGDh7nQn+Y1jOA3oBiCUJ4n1CMaWdDhrgdMuu026oWAbfC3prqkUn8LWp28H+2S # LetNG5KQZZwvy3Zcn7+PQGl5AgMBAAGjggGCMIIBfjAfBgNVHSUEGDAWBgorBgEE # AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUBN/0b6Fh6nMdE4FAxYG9kWCpbYUw # VAYDVR0RBE0wS6RJMEcxLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh # dGlvbnMgTGltaXRlZDEWMBQGA1UEBRMNMjMwMDEyKzUwNTM2MjAfBgNVHSMEGDAW # gBRIbmTlUAXTgqoXNzcitW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8v # d3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIw # MTEtMDctMDguY3JsMGEGCCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDov # L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDEx # XzIwMTEtMDctMDguY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIB # AGLQps1XU4RTcoDIDLP6QG3NnRE3p/WSMp61Cs8Z+JUv3xJWGtBzYmCINmHVFv6i # 8pYF/e79FNK6P1oKjduxqHSicBdg8Mj0k8kDFA/0eU26bPBRQUIaiWrhsDOrXWdL # m7Zmu516oQoUWcINs4jBfjDEVV4bmgQYfe+4/MUJwQJ9h6mfE+kcCP4HlP4ChIQB # UHoSymakcTBvZw+Qst7sbdt5KnQKkSEN01CzPG1awClCI6zLKf/vKIwnqHw/+Wvc # Ar7gwKlWNmLwTNi807r9rWsXQep1Q8YMkIuGmZ0a1qCd3GuOkSRznz2/0ojeZVYh # ZyohCQi1Bs+xfRkv/fy0HfV3mNyO22dFUvHzBZgqE5FbGjmUnrSr1x8lCrK+s4A+ # bOGp2IejOphWoZEPGOco/HEznZ5Lk6w6W+E2Jy3PHoFE0Y8TtkSE4/80Y2lBJhLj # 27d8ueJ8IdQhSpL/WzTjjnuYH7Dx5o9pWdIGSaFNYuSqOYxrVW7N4AEQVRDZeqDc # fqPG3O6r5SNsxXbd71DCIQURtUKss53ON+vrlV0rjiKBIdwvMNLQ9zK0jy77owDy # XXoYkQxakN2uFIBO1UNAvCYXjs4rw3SRmBX9qiZ5ENxcn/pLMkiyb68QdwHUXz+1 # fI6ea3/jjpNPz6Dlc/RMcXIWeMMkhup/XEbwu73U+uz/MIIHejCCBWKgAwIBAgIK # YQ6Q0gAAAAAAAzANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNV # BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv # c29mdCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlm # aWNhdGUgQXV0aG9yaXR5IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEw # OTA5WjB+MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE # BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYD # VQQDEx9NaWNyb3NvZnQgQ29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG # 9w0BAQEFAAOCAg8AMIICCgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+la # UKq4BjgaBEm6f8MMHt03a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc # 6Whe0t+bU7IKLMOv2akrrnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4D # dato88tt8zpcoRb0RrrgOGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+ # lD3v++MrWhAfTVYoonpy4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nk # kDstrjNYxbc+/jLTswM9sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6 # A4aN91/w0FK/jJSHvMAhdCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmd # X4jiJV3TIUs+UsS1Vz8kA/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL # 5zmhD+kjSbwYuER8ReTBw3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zd # sGbiwZeBe+3W7UvnSSmnEyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3 # T8HhhUSJxAlMxdSlQy90lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS # 4NaIjAsCAwEAAaOCAe0wggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRI # bmTlUAXTgqoXNzcitW2oynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTAL # BgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBD # uRQFTuHqp8cx0SOJNDBaBgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jv # c29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf # MDNfMjIuY3JsMF4GCCsGAQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3 # dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf # MDNfMjIuY3J0MIGfBgNVHSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEF # BQcCARYzaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1h # cnljcHMuaHRtMEAGCCsGAQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkA # YwB5AF8AcwB0AGEAdABlAG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn # 8oalmOBUeRou09h0ZyKbC5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7 # v0epo/Np22O/IjWll11lhJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0b # pdS1HXeUOeLpZMlEPXh6I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/ # KmtYSWMfCWluWpiW5IP0wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvy # CInWH8MyGOLwxS3OW560STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBp # mLJZiWhub6e3dMNABQamASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJi # hsMdYzaXht/a8/jyFqGaJ+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYb # BL7fQccOKO7eZS/sl/ahXJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbS # oqKfenoi+kiVH6v7RyOA9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sL # gOppO6/8MO0ETI7f33VtY5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtX # cVZOSEXAQsmbdlsKgEhr/Xmfwb1tbWrJUnMTDXpQzTGCGiYwghoiAgEBMIGVMH4x # CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt # b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01p # Y3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTECEzMAAASEmOIS4HijMV0AAAAA # BIQwDQYJYIZIAWUDBAIBBQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQw # HAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIOHO # 2qaQHODsfrf2WTE+lSEsxztvLDSAALOzfuzSGp0pMEIGCisGAQQBgjcCAQwxNDAy # oBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5j # b20wDQYJKoZIhvcNAQEBBQAEggEAV+UqjOl6ENEf6WfNERBV6yCliKRWfIxHKN7j # qvggQSFrnrtulMe/yY+xaJvI/tBXEOUiziXDFXvxQYlxso34hgsDwXKE7uyxid2m # xBZPySo9a0+Wlk36IiZ5r7WzsUVaBOB/8+q7aOqW1HcXtmW5apS5AJSh6sNFtQeZ # dxgjToV7DeeEyh1dGXYxm1ty0XOWEXhaUuRFDi8pXEpEI/+uyXyBWLBKTnxyHPcH # Mq+iCGTUuG/tkmFNypARqelFgqk4Pamu3r5SNmyJS1I/i9Quo0SXjiMljDxQMAMG # ADPSIW8oO8hjuNPz7GdTbjWmVn9FiDkykZeWZGB+qghZTlHS6qGCF7AwghesBgor # BgEEAYI3AwMBMYIXnDCCF5gGCSqGSIb3DQEHAqCCF4kwgheFAgEDMQ8wDQYJYIZI # AWUDBAIBBQAwggFaBgsqhkiG9w0BCRABBKCCAUkEggFFMIIBQQIBAQYKKwYBBAGE # WQoDATAxMA0GCWCGSAFlAwQCAQUABCAUDebgRtW0WK4q5XjXH4qJF7Y+17A4Ve6A # zN74hdT03AIGaUMuaxssGBMyMDI2MDExMDAxMTUxMi44NDFaMASAAgH0oIHZpIHW # MIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH # UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQL # EyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJzAlBgNVBAsT # Hm5TaGllbGQgVFNTIEVTTjo0QzFBLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9z # b2Z0IFRpbWUtU3RhbXAgU2VydmljZaCCEf4wggcoMIIFEKADAgECAhMzAAACGCXZ # kgXi5+XkAAEAAAIYMA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1w # IFBDQSAyMDEwMB4XDTI1MDgxNDE4NDgyNVoXDTI2MTExMzE4NDgyNVowgdMxCzAJ # BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k # MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jv # c29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UECxMeblNoaWVs # ZCBUU1MgRVNOOjRDMUEtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGlt # ZS1TdGFtcCBTZXJ2aWNlMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA # sdzo6uuQJqAfxLnvEBfIvj6knK+p6bnMXEFZ/QjPOFywlcjDfzI8Dg1nzDlxm7/p # qbvjWhyvazKmFyO6qbPwClfRnI57h5OCixgpOOCGJJQIZSTiMgui3B8DPiFtJPcf # zRt3FsnxjLXwBIjGgnjGfmQl7zejA1WoYL/qBmQhw/FDFTWebxfo4m0RCCOxf2qw # j31aOjc2aYUePtLMXHsXKPFH0tp5SKIF/9tJxRSg0NYEvQqVilje8aQkPd3qzAux # 2Mc5HMSK4NMTtVVCYAWDUZ4p+6iDI9t5BNCBIsf5ooFNUWtxCqnpFYiLYkHfFfxh # VUBZ8LGGxYsA36snD65s2Hf4t86k0e8WelH/usfhYqOM3z2yaI8rg08631IkwqUz # yQoEPqMsHgBem1xpmOGSIUnVvTsAv+lmECL2RqrcOZlZax8K0aiij8h6UkWBN2IA # /ikackTSGVRBQmWWZuLFWV/T4xuNzscC0X7xo4fetgpsqaEA0jY/QevkTvLv4OlN # N9eOL8LNh7Vm0R65P7oabOQDqtUFAwCgjgPJ0iV/jQCaMAcO3SYpG5wSAYiJkk4X # LjNSlNxU2Idjs1sORhl7s7LC6hOb7bVAHVwON74GxfFNiEIA6BfudANjpQJ0nUc/ # ppEXpT4pgDBHsYtV8OyKSjKsIxOdFR7fIJIjDc8DvUkCAwEAAaOCAUkwggFFMB0G # A1UdDgQWBBQkLqHEXDobY7dHuoQCBa4sX7aL0TAfBgNVHSMEGDAWgBSfpxVdAF5i # XYP05dJlpxtTNRnpcjBfBgNVHR8EWDBWMFSgUqBQhk5odHRwOi8vd3d3Lm1pY3Jv # c29mdC5jb20vcGtpb3BzL2NybC9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENB # JTIwMjAxMCgxKS5jcmwwbAYIKwYBBQUHAQEEYDBeMFwGCCsGAQUFBzAChlBodHRw # Oi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01pY3Jvc29mdCUyMFRp # bWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNydDAMBgNVHRMBAf8EAjAAMBYGA1Ud # JQEB/wQMMAoGCCsGAQUFBwMIMA4GA1UdDwEB/wQEAwIHgDANBgkqhkiG9w0BAQsF # AAOCAgEAnkjRhjwPgdoIpvt4YioT/j0LWuBxF3ARBKXDENggraKvC0oRPwbjAmsX # nPEmtuo5MD8uJ9Xw9eYrxqqkK4DF9snZMrHMfooxCa++1irLz8YoozC4tci+a4N3 # 7Sbke1pt1xs9qZtvkPgZGWn5BcwVfmAwSZLHi2CuZ06Y0/X+t6fNBnrbMVovNaDX # 4WPdyI9GEzxfIggDsck2Ipo4VXL/Arcz7p2F7bEZGRuyxjgMC+woCkDJaH/yk/wc # ZpAsixe4POdN0DW6Zb35O3Dg3+a6prANMc3WIdvfKDl75P0aqcQbQAR7b0f4gH4N # MkUct0Wm4GN5KhsE1YK7V/wAqDKmK4jx3zLz3a8Hsxa9HB3GyitlmC5sDhOl4QTG # N5kRi6oCoV4hK+kIFgnkWjHhSRNomz36QnbCSG/BHLEm2GRU9u3/I4zUd9E1AC97 # IJEGfwb+0NWb3QEcrkypdGdWwl0LEObhrQR9B1V7+edcyNmsX0p2BX0rFpd1PkXJ # Sbxf8IcEiw/bkNgagZE+VlDtxXeruLdo5k3lGOv7rPYuOEaoZYxDvZtpHP9P36wm # W4INjR6NInn2UM+krP/xeLnRbDBkm9RslnoDhVraliKDH62BxhcgL9tiRgOHlcI0 # wqvVWLdv8yW8rxkawOlhCRqT3EKECW8ktUAPwNbBULkT+oWcvBcwggdxMIIFWaAD # AgECAhMzAAAAFcXna54Cm0mZAAAAAAAVMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYD # VQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEe # MBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3Nv # ZnQgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgMjAxMDAeFw0yMTA5MzAxODIy # MjVaFw0zMDA5MzAxODMyMjVaMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo # aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y # cG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEw # MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA5OGmTOe0ciELeaLL1yR5 # vQ7VgtP97pwHB9KpbE51yMo1V/YBf2xK4OK9uT4XYDP/XE/HZveVU3Fa4n5KWv64 # NmeFRiMMtY0Tz3cywBAY6GB9alKDRLemjkZrBxTzxXb1hlDcwUTIcVxRMTegCjhu # je3XD9gmU3w5YQJ6xKr9cmmvHaus9ja+NSZk2pg7uhp7M62AW36MEBydUv626GIl # 3GoPz130/o5Tz9bshVZN7928jaTjkY+yOSxRnOlwaQ3KNi1wjjHINSi947SHJMPg # yY9+tVSP3PoFVZhtaDuaRr3tpK56KTesy+uDRedGbsoy1cCGMFxPLOJiss254o2I # 5JasAUq7vnGpF1tnYN74kpEeHT39IM9zfUGaRnXNxF803RKJ1v2lIH1+/NmeRd+2 # ci/bfV+AutuqfjbsNkz2K26oElHovwUDo9Fzpk03dJQcNIIP8BDyt0cY7afomXw/ # TNuvXsLz1dhzPUNOwTM5TI4CvEJoLhDqhFFG4tG9ahhaYQFzymeiXtcodgLiMxhy # 16cg8ML6EgrXY28MyTZki1ugpoMhXV8wdJGUlNi5UPkLiWHzNgY1GIRH29wb0f2y # 1BzFa/ZcUlFdEtsluq9QBXpsxREdcu+N+VLEhReTwDwV2xo3xwgVGD94q0W29R6H # XtqPnhZyacaue7e3PmriLq0CAwEAAaOCAd0wggHZMBIGCSsGAQQBgjcVAQQFAgMB # AAEwIwYJKwYBBAGCNxUCBBYEFCqnUv5kxJq+gpE8RjUpzxD/LwTuMB0GA1UdDgQW # BBSfpxVdAF5iXYP05dJlpxtTNRnpcjBcBgNVHSAEVTBTMFEGDCsGAQQBgjdMg30B # ATBBMD8GCCsGAQUFBwIBFjNodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3Bz # L0RvY3MvUmVwb3NpdG9yeS5odG0wEwYDVR0lBAwwCgYIKwYBBQUHAwgwGQYJKwYB # BAGCNxQCBAweCgBTAHUAYgBDAEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMB # Af8wHwYDVR0jBBgwFoAU1fZWy4/oolxiaNE9lJBb186aGMQwVgYDVR0fBE8wTTBL # oEmgR4ZFaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMv # TWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3JsMFoGCCsGAQUFBwEBBE4wTDBKBggr # BgEFBQcwAoY+aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNS # b29DZXJBdXRfMjAxMC0wNi0yMy5jcnQwDQYJKoZIhvcNAQELBQADggIBAJ1Vffwq # reEsH2cBMSRb4Z5yS/ypb+pcFLY+TkdkeLEGk5c9MTO1OdfCcTY/2mRsfNB1OW27 # DzHkwo/7bNGhlBgi7ulmZzpTTd2YurYeeNg2LpypglYAA7AFvonoaeC6Ce5732pv # vinLbtg/SHUB2RjebYIM9W0jVOR4U3UkV7ndn/OOPcbzaN9l9qRWqveVtihVJ9Ak # vUCgvxm2EhIRXT0n4ECWOKz3+SmJw7wXsFSFQrP8DJ6LGYnn8AtqgcKBGUIZUnWK # NsIdw2FzLixre24/LAl4FOmRsqlb30mjdAy87JGA0j3mSj5mO0+7hvoyGtmW9I/2 # kQH2zsZ0/fZMcm8Qq3UwxTSwethQ/gpY3UA8x1RtnWN0SCyxTkctwRQEcb9k+SS+ # c23Kjgm9swFXSVRk2XPXfx5bRAGOWhmRaw2fpCjcZxkoJLo4S5pu+yFUa2pFEUep # 8beuyOiJXk+d0tBMdrVXVAmxaQFEfnyhYWxz/gq77EFmPWn9y8FBSX5+k77L+Dvk # txW/tM4+pTFRhLy/AsGConsXHRWJjXD+57XQKBqJC4822rpM+Zv/Cuk0+CQ1Zyvg # DbjmjJnW4SLq8CdCPSWU5nR0W2rRnj7tfqAxM328y+l7vzhwRNGQ8cirOoo6CGJ/ # 2XBjU02N7oJtpQUQwXEGahC0HVUzWLOhcGbyoYIDWTCCAkECAQEwggEBoYHZpIHW # MIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH # UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQL # EyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJzAlBgNVBAsT # Hm5TaGllbGQgVFNTIEVTTjo0QzFBLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9z # b2Z0IFRpbWUtU3RhbXAgU2VydmljZaIjCgEBMAcGBSsOAwIaAxUAnWtGrXWiuNE8 # QrKfm4CtGr57z+mggYMwgYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2Fz # aGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENv # cnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAx # MDANBgkqhkiG9w0BAQsFAAIFAO0L/kgwIhgPMjAyNjAxMDkyMjIzMDRaGA8yMDI2 # MDExMDIyMjMwNFowdzA9BgorBgEEAYRZCgQBMS8wLTAKAgUA7Qv+SAIBADAKAgEA # AgIj/gIB/zAHAgEAAgITRzAKAgUA7Q1PyAIBADA2BgorBgEEAYRZCgQCMSgwJjAM # BgorBgEEAYRZCgMCoAowCAIBAAIDB6EgoQowCAIBAAIDAYagMA0GCSqGSIb3DQEB # CwUAA4IBAQDEWmu40fPwK97d5toMXNERz3czWIQCYfn06esmb3CMjJZovkAPcst1 # g5WTRxNRfKFgP4RyHoxc+FneNS0CTbhxLgEPoUW+orGPcTYw3zuucSBCuhiT32X9 # G6IxpSM5G4IJrh/QkVCgIBIkvXOk7WL0u9sv0rrg3M+kld4assUwsRulVBiWF4+M # aM0FArQpaIRT8u7Hq2++dDd4hxLHUvAdyOJ0IyhFNzdOZ3SwV3xSN7C/RSdqtwjA # G9N2ouuTmQ3gnqsC8s2+9wHnPBLLCwwuw3mVyNey0DoOmE7OVts1ohoGWfnYVPWL # nL5acDon4ngu1ocs9tVZFn0swBxh4qXfMYIEDTCCBAkCAQEwgZMwfDELMAkGA1UE # BhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAc # BgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0 # IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAIYJdmSBeLn5eQAAQAAAhgwDQYJYIZI # AWUDBAIBBQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG9w0BCRABBDAvBgkqhkiG # 9w0BCQQxIgQgciGThvvGTt3Tw1M3kjmSY7TAi8p7m9w8bVocfJ3oWnAwgfoGCyqG # SIb3DQEJEAIvMYHqMIHnMIHkMIG9BCCZE9yJuOTItIwWaES6lzGKK1XcSoz1ynRz # aOVzx9eFajCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5n # dG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9y # YXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMz # AAACGCXZkgXi5+XkAAEAAAIYMCIEIGqOkVDYm7kSjyXTrUlgQjA48aQ7dd/9BFdm # R4u6bTJgMA0GCSqGSIb3DQEBCwUABIICAHFqxZfCOQsTEcrUxPB48UIWk5WBh69a # /MUkj85xtFX4bJOYMyzMwuW6yaZNcWGpN0kQgbsHui9bQdoBnmjXZZIegFEAOD7e # DMsH/UQ2JBZSn9spNWwCIo6TRSs1vzh9JLvgVwhWDE+SdP8OzfiXQRCPL0RgxiuN # OIwMiKaQEFj9Z6RVvOjU3e11TI4ce1Da6LuTFPkWmHR0Y0hMPV4xNvmUKo7FCltG # 2IaEE8wOiV65iAaBCwyAJxVyve9h2ArtQwwHmsDqE7dfPj1i/H2ocozvdTZsVFjY # a9u6sDjj0Q3FznEGzdZwYy7j1Fol5UniVdGwf85lcLD50yrXFRBqII4T5PJ5rF0x # 5JJnlVPISECKtv8doLH8B1W/lWot0rYUibGRDrIsScKu/AeijGaXbngbi7Wcbnyn # cPv0EM7Z5b1LM8LtFMieAbUoJUjKBq4y4KdH9hvNZPPSdFeeJ9vfXWda1VQP8cjN # 6JKUFIt45leYxVGPeaPgIrRHP0ttaJbHE93UtXVJ0Ic5XXi0Vh5tKWh1vhzWXFtD # nW+sGHRJ98OgTrzZiWK+RMYZhudIKZE5QG2jBa2113UqhUG1nIdN9Xe4IvcdakHB # IkKvB79cApsZYyXhCuk6qRBF59abgyoxKVu81V5B/pkBuPc7z2jekEwSzblIvHOq # aYLT90fFWSM/ # SIG # End signature block |