Microsoft.AzureStack.Util.ConvertNetwork.psm1
function Get-CidrFromSubnetMask { <# .Synopsis Using a subnet mask value, return the cidr as an int32. .EXAMPLE Get-CidrFromSubnetMask -SubnetMask 255.255.255.252 30 #> [CmdletBinding()] [OutputType([System.Int32])] param ( [Parameter(Mandatory = $true)] [IPAddress] $SubnetMask ) # Using a subnet mask, count the 1's in the binary output to determine the Cidr. $Private:bits = 0 $SubnetMask.GetAddressBytes() | ForEach-Object { $binary = [System.Convert]::ToString($_, 2) $bits += $binary.TrimEnd('0').Length } return $bits } function Get-SubnetMaskFromCidr { <# .Synopsis Using a network CIDR value, convert the bit value to a subnet mask. .EXAMPLE Get-SubnetMaskFromCidr -Cidr 20 AddressFamily : InterNetwork ScopeId : IsIPv6Multicast : False IsIPv6LinkLocal : False IsIPv6SiteLocal : False IsIPv6Teredo : False IsIPv4MappedToIPv6 : False Address : 15794175 IPAddressToString : 255.255.240.0 #> [CmdletBinding()] [OutputType([IPAddress])] param ( [Parameter(Mandatory = $true)] [ValidateRange(0, 32)] [int32] $Cidr ) # Create a 32bit binary string $Private:binary = ('1' * $Cidr).PadRight(32, '0') # Split every the binary every 8 bits and convert it back to an int $Private:octets = New-Object -TypeName System.Collections.ArrayList for ($i = 0; $i -lt 32; $i += 8) { $bOctet = $Private:binary.Substring($i, 8) $octets.Add( ([System.Convert]::ToInt32($bOctet, 2) ) ) | Out-Null } [System.Net.IPAddress]$ipAddress = ( $octets -join ('.') ) return $ipAddress } function Get-IPHostMaskFromSubnetMask { <# .Synopsis Using a subnet mask, this will invert the mask to an IP Host Mask. .EXAMPLE Get-IPHostMaskFromSubnetMask -SubnetMask 255.255.255.0 AddressFamily : InterNetwork ScopeId : IsIPv6Multicast : False IsIPv6LinkLocal : False IsIPv6SiteLocal : False IsIPv6Teredo : False IsIPv4MappedToIPv6 : False Address : 4278190080 IPAddressToString : 0.0.0.255 #> [OutputType([System.Net.IPAddress])] [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [System.Net.IPAddress] $SubnetMask ) # Using the subnet mask, invert the values and return the inverse mask. $aIP = $SubnetMask.GetAddressBytes() $aInverse = $aIP | ForEach-Object { 255 -bxor $_ } [System.Net.IPAddress]$inverse = $aInverse -join ('.') return $inverse } function Get-NetworkAddressFromIP { <# .SYNOPSIS Using a IP within a given subnet with its CIDR bit value, return the Network address of the subnet. .EXAMPLE Get-NetworkAddressFromIP -IPv4Address 10.10.10.10 -IPv4Mask 255.255.252.0 AddressFamily : InterNetwork ScopeId : IsIPv6Multicast : False IsIPv6LinkLocal : False IsIPv6SiteLocal : False IsIPv6Teredo : False IsIPv4MappedToIPv6 : False Address : 526858 IPAddressToString : 10.10.8.0 .EXAMPLE Get-NetworkAddressFromIP -IPv4Address 10.10.10.10 -CIDR 22 AddressFamily : InterNetwork ScopeId : IsIPv6Multicast : False IsIPv6LinkLocal : False IsIPv6SiteLocal : False IsIPv6Teredo : False IsIPv4MappedToIPv6 : False Address : 526858 IPAddressToString : 10.10.8.0 #> [OutputType([System.Net.IPAddress])] [CmdletBinding()] param ( # IPv4 Address that within the IPv4Mask Subnet [Parameter(Mandatory = $true, ParameterSetName = 'MASK')] [Parameter(Mandatory = $true, ParameterSetName = 'CIDR')] [System.Net.IPAddress] $IPv4Address, # Subnet Mask Value [Parameter(Mandatory = $true, ParameterSetName = 'MASK')] [System.Net.IPAddress] $IPv4Mask, # CIDR bit value [Parameter(Mandatory = $true, ParameterSetName = 'CIDR')] [System.Int32] $CIDR ) # Level set so we always utilize a subnet mask, if a CIDR is given. if ($PSBoundParameters.Keys -eq 'CIDR') { [System.Net.IPAddress]$Private:mask = Get-SubnetMaskFromCidr -Cidr $CIDR } else { [System.Net.IPAddress]$Private:mask = $IPv4Mask } <# # Break the subnet into an Array # use the BAnd operator for each octet in the address. # this will convert an address to an network address. #> $aAddress = $IPv4Address.GetAddressBytes() $aMask = $Private:mask.GetAddressBytes() $aNetwork = for ($i = 0; $i -lt 4; $i++) { $aAddress[$i] -band $aMask[$i] } [System.Net.IPAddress]$ipAddress = ( $aNetwork -join ('.') ) return $ipAddress } function Get-BroadcastAddressFromIP { <# .SYNOPSIS Using an IPv4 address return the broadcast address for a given CIDR/MASK. .EXAMPLE Get-BroadcastAddressFromIP -IPv4Address 10.10.13.0 -IPv4Mask 255.255.252.0 AddressFamily : InterNetwork ScopeId : IsIPv6Multicast : False IsIPv6LinkLocal : False IsIPv6SiteLocal : False IsIPv6Teredo : False IsIPv4MappedToIPv6 : False Address : 4279175690 IPAddressToString : 10.10.15.255 .EXAMPLE Get-BroadcastAddressFromIP -IPv4Address 10.10.13.0 -CIDR 22 AddressFamily : InterNetwork ScopeId : IsIPv6Multicast : False IsIPv6LinkLocal : False IsIPv6SiteLocal : False IsIPv6Teredo : False IsIPv4MappedToIPv6 : False Address : 4279175690 IPAddressToString : 10.10.15.255 #> [OutputType([System.Net.IPAddress])] [CmdletBinding()] param ( [Parameter(Mandatory = $true, ParameterSetName = 'MASK')] [Parameter(Mandatory = $true, ParameterSetName = 'CIDR')] [System.Net.IPAddress] $IPv4Address, # Subnet Mask used to determine the broadcast address [Parameter(Mandatory = $true, ParameterSetName = 'MASK')] [System.Net.IPAddress] $IPv4Mask, # CIDR bit value [Parameter(Mandatory = $true, ParameterSetName = 'CIDR')] [System.Int32] $CIDR ) # Level set so we always utilize a subnet mask, if a CIDR is given. if ($PSBoundParameters.Keys -eq 'CIDR') { $mask = (Get-SubnetMaskFromCidr -Cidr $CIDR).ToString() } else { $mask = $IPv4Mask.ToString() } $aHostMask = (Get-IPHostMaskFromSubnetMask -SubnetMask $mask).ToString() -Split ('\.') <# # Break the subnet into an Array # use the BOR operator for each octet in the address. # this will convert an address to an broadcast address. #> $aAddress = $IPv4Address.GetAddressBytes() $Private:aBroadcast = for ($i = 0; $i -lt 4; $i++) { [System.Int32]$aAddress[$i] -bor [System.Int32]$aHostMask[$i] } [System.Net.IPAddress]$ipAddress = ( $aBroadcast -join ('.') ) return $ipAddress } function Export-SubnetFromAddress { <# .SYNOPSIS Subnet a network using the existing cidr and the new cidr .EXAMPLE Export-SubnetFromAddress -Subnet '10.10.10.0' -Cidr 30 -NewCidr 32 Position Network Cidr Supernet -------- ------- ---- -------- 0 10.10.10.0 32 10.10.10.0/30 1 10.10.10.1 32 10.10.10.0/30 2 10.10.10.2 32 10.10.10.0/30 3 10.10.10.3 32 10.10.10.0/30 #> [CmdLetBinding()] [OutputType([OutputType])] Param( # Starting Subnet Address [Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] [IPAddress] $Subnet, # Cidr of the starting subnet. [Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] [Int32] $Cidr, # New Cidr the network will be subneted to. [Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] [Int32] $NewCidr ) BEGIN { Write-Verbose -Message "Enter $($MyInvocation.MyCommand.Name)" $message = "At: {0}:{1}`n Line: {2}" -f $MyInvocation.ScriptName, $MyInvocation.ScriptLineNumber, $MyInvocation.Line Write-Verbose -Message "Invoked $message" } PROCESS { # ('10.10.13.0' 30) $network = Get-NetworkAddressFromIP -IPv4Address $Subnet -CIDR $Cidr # '0.13.10.10' [IPAddress]$revAddress = Set-AddressInReverse -Address $network $newSubnet = New-Object -TypeName System.Collections.ArrayList $broadcast = Get-BroadcastAddressFromIP -IPv4Address $Subnet -CIDR $Cidr $cidrInc = Get-IPCountInNetwork -Cidr $NewCidr $i = 0 do { $decAddr = ($revAddress.Address + $i) $address = [PSCustomObject]@{ Position = $newSubnet.Count Network = [IPAddress]::Parse($decAddr).IPAddressToString Cidr = $newCidr Supernet = "$($network.IPAddressToString)/${CIDR}" } $newSubnet.Add($address) | Out-Null $testBroadcast = (Get-BroadcastAddressFromIP -IPv4Address $address.Network -CIDR $newCidr) $i += $cidrInc } Until($broadcast.Equals($testBroadcast)) return $newSubnet } END { Write-Verbose -Message "Exit $($MyInvocation.MyCommand.Name)" } } function Get-IPCountInNetwork { <# .SYNOPSIS Calculate the total number of IP address in a network. .EXAMPLE Get-IPCountInNetwork -Cidr 24 256 #> [CmdLetBinding()] [OutputType([Int32])] Param( # Cidr bit value of the subnet, this will be used to determine the number of hosts IP's are in a given subnet. [Parameter(Mandatory = $true)] [ValidateRange(0, 32)] [Int32] $CIDR ) BEGIN { Write-Verbose -Message "Enter $($MyInvocation.MyCommand.Name)" $message = "At: {0}:{1}`n Line: {2}" -f $MyInvocation.ScriptName, $MyInvocation.ScriptLineNumber, $MyInvocation.Line Write-Verbose -Message "Invoked $message" } PROCESS { $bits = 32 - $CIDR [Int32]$result = [Math]::Pow(2, $bits) return $result } END { Write-Verbose -Message "Exit $($MyInvocation.MyCommand.Name)" } } function Set-AddressInReverse { [CmdLetBinding()] Param( # Parameter Description [Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] [IPAddress] $Address ) BEGIN { Write-Verbose -Message "Enter $($MyInvocation.MyCommand.Name)" $message = "At: {0}:{1}`n Line: {2}" -f $MyInvocation.ScriptName, $MyInvocation.ScriptLineNumber, $MyInvocation.Line Write-Verbose -Message "Invoked $message" } PROCESS { # (10, 10, 13, 0) $nByte = $Address.GetAddressBytes() # (0, 13, 10, 10) [Array]::Reverse($nByte) # (0.13.10.10) $result = $nByte -Join ('.') return $result } END { Write-Verbose -Message "Exit $($MyInvocation.MyCommand.Name)" } } function New-MicrosoftAzureStackUtilConvertNetwork { <# .SYNOPSIS Returns a object with all the capbilites included as a single object. .EXAMPLE New-Microsoft.AzureStack.Util.ConvertNetwork -IPv4Address 10.10.13.20 -Cidr 22 IPv4Address : 10.10.13.5 Network : 10.10.12.0 Cidr : 22 Mask : 255.255.252.0 Broadcast : 10.10.15.255 .OUTPUTS Microsoft.AzureStack.Util.ConvertNetwork .NOTES TypeName: Microsoft.AzureStack.Util.ConvertNetwork Name MemberType Definition ---- ---------- ---------- Equals Method bool Equals(System.Object obj) GetHashCode Method int GetHashCode() GetType Method type GetType() ToString Method string ToString() Cidr NoteProperty int Cidr=22 IPv4Address NoteProperty System.String IPv4Address=10.10.13.5 GetBroadcast ScriptMethod System.Object GetBroadcast(); GetInverseMask ScriptMethod System.Object GetInverseMask(); GetIPInSubnet ScriptMethod System.Object GetIPInSubnet(); GetMask ScriptMethod System.Object GetMask(); GetNetwork ScriptMethod System.Object GetNetwork(); NewSubnet ScriptMethod System.Object NewSubnet(); Broadcast ScriptProperty System.Object Broadcast {get=… InverseMask ScriptProperty System.Object InverseMask {get=… Mask ScriptProperty System.Object Mask {get=… Network ScriptProperty System.Object Network {get=… #> [CmdLetBinding()] Param( # IP Address [Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] [IPAddress] $IPv4Address, # CIDR bit value [Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] [ValidateRange(0, 32)] [Int32] $CIDR ) BEGIN { Write-Verbose -Message "Enter $($MyInvocation.MyCommand.Name)" $message = "At: {0}:{1}`n Line: {2}" -f $MyInvocation.ScriptName, $MyInvocation.ScriptLineNumber, $MyInvocation.Line Write-Verbose -Message "Invoked $message" } PROCESS { $result = [PSCustomObject]@{ PSTypeName = 'Microsoft.AzureStack.Util.ConvertNetwork' } Add-Member -InputObject $result -MemberType NoteProperty -Name IPv4Address -Value $IPv4Address.IPAddressToString Add-Member -InputObject $result -MemberType ScriptProperty -Name Network -Value { return $this.GetNetwork().IPAddressToString } Add-Member -InputObject $result -MemberType NoteProperty -Name Cidr -Value $Cidr Add-Member -InputObject $result -MemberType ScriptProperty -Name Mask -Value { return $this.GetMask().IPAddressToString } Add-Member -InputObject $result -MemberType ScriptProperty -Name InverseMask -Value { return $this.GetInverseMask().IPAddressToString } Add-Member -InputObject $result -MemberType ScriptProperty -Name Broadcast -Value { return $this.GetBroadcast().IPAddressToString } Add-Member -InputObject $result -MemberType ScriptMethod -Name GetBroadcast -Value { return Get-BroadcastAddressFromIP -IPv4Address $this.IPv4Address -CIDR $this.Cidr } Add-Member -InputObject $result -MemberType ScriptMethod -Name GetNetwork -Value { return Get-NetworkAddressFromIP -IPv4Address $this.IPv4Address -CIDR $this.Cidr } Add-Member -InputObject $result -MemberType ScriptMethod -Name GetMask -Value { return Get-SubnetMaskFromCidr -Cidr $this.Cidr } Add-Member -InputObject $result -MemberType ScriptMethod -Name GetIPInSubnet -Value { return Get-IPCountInNetwork -Cidr $this.Cidr } Add-Member -InputObject $result -MemberType ScriptMethod -Name NewSubnet -Value { param ( [Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] [ValidateRange(0, 32)] [ValidateScript({$_ -gt $this.Cidr})] [int32] $NewCidr ) return Export-SubnetFromAddress -Subnet $this.GetNetwork() -Cidr $this.Cidr -NewCidr $NewCidr } Add-Member -InputObject $result -MemberType ScriptMethod -Name GetInverseMask -Value { return Get-IPHostMaskFromSubnetMask -SubnetMask $this.GetMask() } return $result } END { Write-Verbose -Message "Exit $($MyInvocation.MyCommand.Name)" } } # SIG # Begin signature block # MIInuQYJKoZIhvcNAQcCoIInqjCCJ6YCAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDgehdLjKeFQ5/t # pOZcGJ1EI1lw8LTdBb1sWq/UwXTXnaCCDYEwggX/MIID56ADAgECAhMzAAACUosz # qviV8znbAAAAAAJSMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p # bmcgUENBIDIwMTEwHhcNMjEwOTAyMTgzMjU5WhcNMjIwOTAxMTgzMjU5WjB0MQsw # CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u # ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB # AQDQ5M+Ps/X7BNuv5B/0I6uoDwj0NJOo1KrVQqO7ggRXccklyTrWL4xMShjIou2I # sbYnF67wXzVAq5Om4oe+LfzSDOzjcb6ms00gBo0OQaqwQ1BijyJ7NvDf80I1fW9O # L76Kt0Wpc2zrGhzcHdb7upPrvxvSNNUvxK3sgw7YTt31410vpEp8yfBEl/hd8ZzA # v47DCgJ5j1zm295s1RVZHNp6MoiQFVOECm4AwK2l28i+YER1JO4IplTH44uvzX9o # RnJHaMvWzZEpozPy4jNO2DDqbcNs4zh7AWMhE1PWFVA+CHI/En5nASvCvLmuR/t8 # q4bc8XR8QIZJQSp+2U6m2ldNAgMBAAGjggF+MIIBejAfBgNVHSUEGDAWBgorBgEE # AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUNZJaEUGL2Guwt7ZOAu4efEYXedEw # UAYDVR0RBEkwR6RFMEMxKTAnBgNVBAsTIE1pY3Jvc29mdCBPcGVyYXRpb25zIFB1 # ZXJ0byBSaWNvMRYwFAYDVQQFEw0yMzAwMTIrNDY3NTk3MB8GA1UdIwQYMBaAFEhu # ZOVQBdOCqhc3NyK1bajKdQKVMFQGA1UdHwRNMEswSaBHoEWGQ2h0dHA6Ly93d3cu # bWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY0NvZFNpZ1BDQTIwMTFfMjAxMS0w # Ny0wOC5jcmwwYQYIKwYBBQUHAQEEVTBTMFEGCCsGAQUFBzAChkVodHRwOi8vd3d3 # Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01pY0NvZFNpZ1BDQTIwMTFfMjAx # MS0wNy0wOC5jcnQwDAYDVR0TAQH/BAIwADANBgkqhkiG9w0BAQsFAAOCAgEAFkk3 # uSxkTEBh1NtAl7BivIEsAWdgX1qZ+EdZMYbQKasY6IhSLXRMxF1B3OKdR9K/kccp # kvNcGl8D7YyYS4mhCUMBR+VLrg3f8PUj38A9V5aiY2/Jok7WZFOAmjPRNNGnyeg7 # l0lTiThFqE+2aOs6+heegqAdelGgNJKRHLWRuhGKuLIw5lkgx9Ky+QvZrn/Ddi8u # TIgWKp+MGG8xY6PBvvjgt9jQShlnPrZ3UY8Bvwy6rynhXBaV0V0TTL0gEx7eh/K1 # o8Miaru6s/7FyqOLeUS4vTHh9TgBL5DtxCYurXbSBVtL1Fj44+Od/6cmC9mmvrti # yG709Y3Rd3YdJj2f3GJq7Y7KdWq0QYhatKhBeg4fxjhg0yut2g6aM1mxjNPrE48z # 6HWCNGu9gMK5ZudldRw4a45Z06Aoktof0CqOyTErvq0YjoE4Xpa0+87T/PVUXNqf # 7Y+qSU7+9LtLQuMYR4w3cSPjuNusvLf9gBnch5RqM7kaDtYWDgLyB42EfsxeMqwK # WwA+TVi0HrWRqfSx2olbE56hJcEkMjOSKz3sRuupFCX3UroyYf52L+2iVTrda8XW # esPG62Mnn3T8AuLfzeJFuAbfOSERx7IFZO92UPoXE1uEjL5skl1yTZB3MubgOA4F # 8KoRNhviFAEST+nG8c8uIsbZeb08SeYQMqjVEmkwggd6MIIFYqADAgECAgphDpDS # 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/BvW1taslScxMNelDNMYIZjjCCGYoCAQEwgZUwfjELMAkG # A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx # HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9z # b2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAxMQITMwAAAlKLM6r4lfM52wAAAAACUjAN # BglghkgBZQMEAgEFAKCBrjAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgor # BgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQgjaGJupyd # hK+37C6N3FKVHS8jdQJ3nve2m8dFoDDDAdEwQgYKKwYBBAGCNwIBDDE0MDKgFIAS # AE0AaQBjAHIAbwBzAG8AZgB0oRqAGGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbTAN # BgkqhkiG9w0BAQEFAASCAQAN8SI8bb5dQ0HsdF0YEG0axI6Ic6iqqN/gsFNT5WPr # ukaj3ogh4yVlK9dRXK8r/WrOCCCxFI9lnF3rgmnhl7wuO3iNdticG++V3dA0/T9a # MtnFP7u+GWZSWO+FWsBEHWaX/Pikhfzs2928HR8WThdkNb9v5oKbwPCLRtSDGNbY # RzW/vdMlZKXrQpoQA1Y6+YIs0H/fpMxbF07F4y2xHoWlMVdOMAHJvhjDrb5EEelM # GKS/TfHPre5jkWAN0/wRzROP+FPOA9cezXjgVVK4tomkGG5EFLZsHUSoIlfsEMdQ # CN0yyGBqRJW8t+sw1YGRTyi3dwf2Pq2vx1ApIc/4zpNGoYIXGDCCFxQGCisGAQQB # gjcDAwExghcEMIIXAAYJKoZIhvcNAQcCoIIW8TCCFu0CAQMxDzANBglghkgBZQME # AgEFADCCAVgGCyqGSIb3DQEJEAEEoIIBRwSCAUMwggE/AgEBBgorBgEEAYRZCgMB # MDEwDQYJYIZIAWUDBAIBBQAEIDxIsJA9rIijRgfMq/8xhjYxZX0mRxQfNmoX1Kw4 # gTqnAgZhwh6aoS8YEjIwMjIwMTEyMTIxMzI1Ljc3WjAEgAIB9KCB2KSB1TCB0jEL # MAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1v # bmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWlj # cm9zb2Z0IElyZWxhbmQgT3BlcmF0aW9ucyBMaW1pdGVkMSYwJAYDVQQLEx1UaGFs # ZXMgVFNTIEVTTjozQkQ0LTRCODAtNjlDMzElMCMGA1UEAxMcTWljcm9zb2Z0IFRp # bWUtU3RhbXAgU2VydmljZaCCEWgwggcUMIIE/KADAgECAhMzAAABibS/hjCEHEuP # AAEAAAGJMA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX # YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQg # Q29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAy # MDEwMB4XDTIxMTAyODE5Mjc0MVoXDTIzMDEyNjE5Mjc0MVowgdIxCzAJBgNVBAYT # AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD # VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJ # cmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEmMCQGA1UECxMdVGhhbGVzIFRTUyBF # U046M0JENC00QjgwLTY5QzMxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1w # IFNlcnZpY2UwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC9BlfFkWZr # qmWa47K82lXzE407BxiiVkb8GPJlYZKTkk4ZovKsoh3lXFUdYeWyYkThK+fOx2mw # qZXHyi04294hQW9Jx4RmnxVea7mbV+7wvtz7eXBdyJuNxyq0S+1CyWiRBXHSv4vn # hpus0NqvAUbvchpGJ0hLWL1z66cnyhjKENEusLKwUBXHJCE81mRYrtnz9Ua6Roos # BYdcKH/5HneHjaAUv73+YAAvHMJde6h+Lx/9coKbvE3BVzWE40ILPqir3gC5/NU2 # SQhbhutRCBikJwmb1TRc2ZC+2uilgOf1S1jxhDQ0p6dc+12Asd1Dw2e/eKASsout # YjRrmfmON0p/CT7ya9qSp1maU6x545LVeylA0kArW5mWUAhNydBk5w7mh+M5Dfe6 # NZyQBd3P7/HejuXgBT9NI4zMZkzCFR21XALd1Jsi2lJUWCeMzYI4Qn3OAJp286Ks # YMs3jvWNkjaMKWSOwlN2A+TfjdNADgkW92z+6dmrS4uv6eJndfjg4HHbH6BWWWfZ # zhRtlc254DjJLVMkZtskUggsCZNQD0C6Pl4hIZNs2LJbHv0ecI5Nqvf1AQqjObgu # dOYNfLT8oj8f+dhkYq5Md9yQ/bzBBLTqsP58NLnEvBxEwJb3YOQdea1uEbJGKUE4 # vkvFl6VB/G3njCXhZQLQB0ASiU96Q4PA7wIDAQABo4IBNjCCATIwHQYDVR0OBBYE # FJdvH7NHWngggB6C4DqscqSt+XtQMB8GA1UdIwQYMBaAFJ+nFV0AXmJdg/Tl0mWn # G1M1GelyMF8GA1UdHwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWljcm9zb2Z0LmNv # bS9wa2lvcHMvY3JsL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEw # KDEpLmNybDBsBggrBgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0dHA6Ly93d3cu # bWljcm9zb2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwVGltZS1TdGFt # cCUyMFBDQSUyMDIwMTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwEwYDVR0lBAwwCgYI # KwYBBQUHAwgwDQYJKoZIhvcNAQELBQADggIBAI60t2lZQjgrB8sut9oqssH3YOps # CykZYzjVNo7gmX6wfE+jnba67cYpAKOaRFat4e2V/LL2Q6TstZrHeTeR7wa19619 # uHuofQt5XZc5aDf0E6cd/qZNxmrsVhJllyHUkNCNz3z452WjD6haKHQNu3gJX97X # 1lwT7WfXPNaSyRQR3R/mM8hSKzfen6+RjyzN24C0Jwhw8VSEjwdvlqU9QA8yMbPA # pvs0gpud/yPxw/XwCzki95yQXSiHVzDrdFj+88rrYsNh2mLtacbY5u+eB9ZUq3CL # BMjiMePZw72rfscN788+XbXqBKlRmHRqnbiYqYwN9wqnU3iYR2zHPiix46s9h4Ww # cdYkUnoCK++qfvQpN4mmnmv4PFKpt5LLSbEhQ6r+UBpTGA1JBVRfbq3yv59yKSh8 # q/bdYeu1FXe3utVOwH1jOtFqKKSbPrwrkdZ230ypQvE9A+j6mlnQtGqQ5p7jrr5Q # pFjQnFa12sxzm8eUdl+eqNrCP9GwzZLpDp9r1P0KdjU3PsNgEbfJknII8WyuBTTm # z2WOp+xKm2kV1SH1Hhx74vvVJYMszbH/UwUsscAxtewSnwqWgQa1oNQufG19La1i # F+4oapFegR8M8Aych1O9A+HcYdDhKOSQEBEcvQxjvlqWEZModaMLZotU6jyhsogG # TyF+cUNR/8TJXDi5MIIHcTCCBVmgAwIBAgITMwAAABXF52ueAptJmQAAAAAAFTAN # BgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0 # b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3Jh # dGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9y # aXR5IDIwMTAwHhcNMjEwOTMwMTgyMjI1WhcNMzAwOTMwMTgzMjI1WjB8MQswCQYD # VQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEe # MBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3Nv # ZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCC # AgoCggIBAOThpkzntHIhC3miy9ckeb0O1YLT/e6cBwfSqWxOdcjKNVf2AX9sSuDi # vbk+F2Az/1xPx2b3lVNxWuJ+Slr+uDZnhUYjDLWNE893MsAQGOhgfWpSg0S3po5G # awcU88V29YZQ3MFEyHFcUTE3oAo4bo3t1w/YJlN8OWECesSq/XJprx2rrPY2vjUm # ZNqYO7oaezOtgFt+jBAcnVL+tuhiJdxqD89d9P6OU8/W7IVWTe/dvI2k45GPsjks # UZzpcGkNyjYtcI4xyDUoveO0hyTD4MmPfrVUj9z6BVWYbWg7mka97aSueik3rMvr # g0XnRm7KMtXAhjBcTyziYrLNueKNiOSWrAFKu75xqRdbZ2De+JKRHh09/SDPc31B # mkZ1zcRfNN0Sidb9pSB9fvzZnkXftnIv231fgLrbqn427DZM9ituqBJR6L8FA6PR # c6ZNN3SUHDSCD/AQ8rdHGO2n6Jl8P0zbr17C89XYcz1DTsEzOUyOArxCaC4Q6oRR # RuLRvWoYWmEBc8pnol7XKHYC4jMYctenIPDC+hIK12NvDMk2ZItboKaDIV1fMHSR # lJTYuVD5C4lh8zYGNRiER9vcG9H9stQcxWv2XFJRXRLbJbqvUAV6bMURHXLvjflS # xIUXk8A8FdsaN8cIFRg/eKtFtvUeh17aj54WcmnGrnu3tz5q4i6tAgMBAAGjggHd # MIIB2TASBgkrBgEEAYI3FQEEBQIDAQABMCMGCSsGAQQBgjcVAgQWBBQqp1L+ZMSa # voKRPEY1Kc8Q/y8E7jAdBgNVHQ4EFgQUn6cVXQBeYl2D9OXSZacbUzUZ6XIwXAYD # VR0gBFUwUzBRBgwrBgEEAYI3TIN9AQEwQTA/BggrBgEFBQcCARYzaHR0cDovL3d3 # dy5taWNyb3NvZnQuY29tL3BraW9wcy9Eb2NzL1JlcG9zaXRvcnkuaHRtMBMGA1Ud # JQQMMAoGCCsGAQUFBwMIMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMAsGA1Ud # DwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNX2VsuP6KJcYmjR # PZSQW9fOmhjEMFYGA1UdHwRPME0wS6BJoEeGRWh0dHA6Ly9jcmwubWljcm9zb2Z0 # LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNy # bDBaBggrBgEFBQcBAQROMEwwSgYIKwYBBQUHMAKGPmh0dHA6Ly93d3cubWljcm9z # b2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3J0MA0G # CSqGSIb3DQEBCwUAA4ICAQCdVX38Kq3hLB9nATEkW+Geckv8qW/qXBS2Pk5HZHix # BpOXPTEztTnXwnE2P9pkbHzQdTltuw8x5MKP+2zRoZQYIu7pZmc6U03dmLq2HnjY # Ni6cqYJWAAOwBb6J6Gngugnue99qb74py27YP0h1AdkY3m2CDPVtI1TkeFN1JFe5 # 3Z/zjj3G82jfZfakVqr3lbYoVSfQJL1AoL8ZthISEV09J+BAljis9/kpicO8F7BU # hUKz/AyeixmJ5/ALaoHCgRlCGVJ1ijbCHcNhcy4sa3tuPywJeBTpkbKpW99Jo3QM # vOyRgNI95ko+ZjtPu4b6MhrZlvSP9pEB9s7GdP32THJvEKt1MMU0sHrYUP4KWN1A # PMdUbZ1jdEgssU5HLcEUBHG/ZPkkvnNtyo4JvbMBV0lUZNlz138eW0QBjloZkWsN # n6Qo3GcZKCS6OEuabvshVGtqRRFHqfG3rsjoiV5PndLQTHa1V1QJsWkBRH58oWFs # c/4Ku+xBZj1p/cvBQUl+fpO+y/g75LcVv7TOPqUxUYS8vwLBgqJ7Fx0ViY1w/ue1 # 0CgaiQuPNtq6TPmb/wrpNPgkNWcr4A245oyZ1uEi6vAnQj0llOZ0dFtq0Z4+7X6g # MTN9vMvpe784cETRkPHIqzqKOghif9lwY1NNje6CbaUFEMFxBmoQtB1VM1izoXBm # 8qGCAtcwggJAAgEBMIIBAKGB2KSB1TCB0jELMAkGA1UEBhMCVVMxEzARBgNVBAgT # Cldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m # dCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxhbmQgT3BlcmF0 # aW9ucyBMaW1pdGVkMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjozQkQ0LTRCODAt # NjlDMzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaIjCgEB # MAcGBSsOAwIaAxUAIaUJreR63J657Ltsk2laQy6IJxCggYMwgYCkfjB8MQswCQYD # VQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEe # MBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3Nv # ZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQUFAAIFAOWI9NowIhgP # MjAyMjAxMTIxNDM0MDJaGA8yMDIyMDExMzE0MzQwMlowdzA9BgorBgEEAYRZCgQB # MS8wLTAKAgUA5Yj02gIBADAKAgEAAgIMcQIB/zAHAgEAAgISjjAKAgUA5YpGWgIB # ADA2BgorBgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIBAAIDB6EgoQow # CAIBAAIDAYagMA0GCSqGSIb3DQEBBQUAA4GBAFUJo18U1aLIwxldELjb1+fy+g+2 # 8ow3ot2Dd9mhcJycsdl5KUvowAvNfDrQrmgPP9W5OHd+iEwmKURxA/pyi9OqE/e+ # CeqfHzJw+MyH56D8OtNjrJgneve8gFn4dMmugzUAa0u3Vqb1VQRQi4F7pjL8HO3v # sG2G5DTjTxJgetjPMYIEDTCCBAkCAQEwgZMwfDELMAkGA1UEBhMCVVMxEzARBgNV # BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv # c29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAg # UENBIDIwMTACEzMAAAGJtL+GMIQcS48AAQAAAYkwDQYJYIZIAWUDBAIBBQCgggFK # MBoGCSqGSIb3DQEJAzENBgsqhkiG9w0BCRABBDAvBgkqhkiG9w0BCQQxIgQgAt1A # P2cM1NzM3kvfJf8vOnJ075wRahwVSvbyvyIvavwwgfoGCyqGSIb3DQEJEAIvMYHq # MIHnMIHkMIG9BCBmd0cx3FBXVWxulYc5MepYTJy9xEmbtxjr2X9SZPyPRTCBmDCB # gKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQH # EwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNV # BAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAABibS/hjCEHEuP # AAEAAAGJMCIEIGAiarhZxMGgzLsbkaFyYFIPFm9v9JuxaZe5//U+/K2eMA0GCSqG # SIb3DQEBCwUABIICAFW3oElC8l3761LqjWJSmDTVa1K3OxJML2X1xf2V7n2byr7O # msRQKA2JmZTGnOcADrqmkFrHaqpHgnJ5casHAgSBpIvhOojpEwbV/o1lSHGzo+8H # D4/fDA+muJFVev+PqFOIZXkfQOQrzl4MlYs/cuGMPAfFsp27i8NxYyspAJZAhKkV # doibo++JiO3u05R2ppmtdcTXoJA2cNJm4Tyb6cWhs98kZJ7Qd44YHYs1U8pY1Yt/ # YuMI4hyLBDy155spY7hEekTeedCL4vHY2hRnH0v8BJxL1DGnozQaGwuJvW3PnD9w # OOnyPjJZaS/w8IMC39WWhSU6NthrBPMNvIiSIsnuZAlycRjvq0qjWHVyw9quRatz # xAeJYhMUm3VX4Iqw6U2GXpIGsYFmgBE5iP7XFtO2JuKqYnIklxTdzwYwOm/AIBDl # K9eHhaxVbmjKe+W2ZcueuY5jodPQRhxlJphm1RKVy4Xhuw2XRB4O9hkU/+96698+ # v68VIl4p6qkX8+RJxY7y85eXaeQ2WnLI500yDAiRdwXh9J2qBeg6A7pSWSCiGzGB # A6fA29iLX/f1KKFPGK0D2RIWrAt54U2TWTsxvezur8Mah5/RvtzkAq98W09aBU1v # ruFrCDN/M31OaTnDZwuDjeYtoKS25NoDDEIujt3oHc8AIOu227m5FGFntaLi # SIG # End signature block |