Az.StackHCI.NetworkHUD.psm1
$Script:ServiceName = "NetworkHud" $Script:ServiceEventLogChannel = "Microsoft-Windows-Networking-NetworkHud/Diagnostic" $Script:ClusterName = $null $Script:NodeNames = @() $Script:ErrorActionPreference = "Stop" Import-LocalizedData -BindingVariable "LocMessage" -FileName "LocalizationMessages" # Start of private functions function ValidateNetworkHudServicePresent { param ( [string] $ComputerName ) $result = Get-WindowsFeature -Name $Script:ServiceName -ComputerName $ComputerName if (-not $result) { #throw $LocMessage.networkhud_management_feature_not_installed -f $Script:ServiceName, $ComputerName } } function ValidateFailoverClusterModulePresent { $moduleName = "FailoverClusters" $result = Get-Module -Name $moduleName -ListAvailable if (-not $result) { throw $LocMessage.networkhud_management_cluster_module_not_installed -f $moduleName } } function GetNodeClusterState { param( [string] $ComputerName ) $signature = @' [DllImport("clusapi.dll", CharSet = CharSet.Unicode, SetLastError = false, ExactSpelling = true)] public static extern int GetNodeClusterState(string nodeName, out int clusterState); '@ if (-not ("Microsoft.NetworkHud.Module.ClusterAPI" -as [type])) { Add-Type -MemberDefinition $signature -Name "ClusterAPI" -Namespace "Microsoft.NetworkHud.Module" | Out-Null } $state = 0 try { [Microsoft.NetworkHud.Module.ClusterAPI]::GetNodeClusterState($ComputerName, [ref] $state) } catch {} return $state } function UpdateClusterInfoAndValidate { param( [string] $ComputerName, [string] $ClusterName ) $Script:NodeNames = @() $Script:ClusterName = $null if ($ClusterName) { ValidateFailoverClusterModulePresent $Script:ClusterName = $ClusterName $nodes = Get-Cluster -Name $ClusterName | Get-ClusterNode | Select-Object Name foreach ($node in $nodes) { $script:NodeNames += $node.Name } } else { if (-not $ComputerName) { $ComputerName = $env:COMPUTERNAME } $nodeClusterState = GetNodeClusterState -ComputerName $ComputerName if ($nodeClusterState -eq 19) { if ($ComputerName -ne $env:COMPUTERNAME) { throw $LocMessage.networkhud_management_remote_node_cluster -f $ComputerName, "-ClusterName" } else { ValidateFailoverClusterModulePresent $cluster = Get-Cluster $Script:ClusterName = $cluster.Name $nodes = $cluster | Get-ClusterNode | Select-Object Name foreach ($node in $nodes) { $script:NodeNames += $node.Name } } } else { $script:NodeNames += $ComputerName } } foreach ($node in $script:NodeNames) { ValidateNetworkHudServicePresent -ComputerName $node } return $Script:NodeNames } function ConvertNetHUDJSON { <# .SYNOPSIS This function converts a hashtable to a JSON object that can be used by the NetworkHUD module. Portions of a JSON object can be difficult to parse, this enables them to be parsed for use in the Network HUD module. #> param ( [Parameter(Mandatory=$True, ValueFromPipeline=$True)] [PSCustomObject] $ExistingObject ) $ExistingObject | Get-Member -MemberType NoteProperty | ForEach-Object { $thisKey = $_.Name [PSCustomObject] @{ Key = $thisKey; Value = $ExistingObject."$thisKey" } } } # End of private functions # Start of public functions function Get-NetHudStatus { [CmdletBinding(DefaultParameterSetName = 'ComputerName')] param( [Parameter(ParameterSetName = 'ComputerName', Mandatory = $false, ValueFromPipeline = $false, Position = 0)] [string] $ComputerName, [Parameter(ParameterSetName = 'ClusterName', Mandatory = $true, ValueFromPipeline = $false, Position = 0)] [string] $ClusterName ) #TODO: Add check for Get-ClusterResource -Name 'Cluster Name' $NodeNames = UpdateClusterInfoAndValidate -ComputerName $ComputerName -ClusterName $ClusterName $AllNodeFeatureStatus = @() # This must be out of the loop because we need an version list to compare each node against; $ContentList = $NodeNames | ForEach-Object { $thisModule = Get-Module -Name Az.StackHCI.NetworkHUD -ListAvailable -CimSession $_ [PSCustomObject] @{ Node = $_ Module = ($thisModule).Name Version = ($thisModule).Version } } $OperationalState = 'Running' foreach ($node in $NodeNames) { $thisNodeAllRequirements = New-Object -TypeName psobject $thisNodeAllRequirements | Add-Member -MemberType NoteProperty -Name Node -Value $node $thisNodeAllRequirements | Add-Member -MemberType NoteProperty -Name OperationalState -Value 'Failed' #region WindowsFeatures $FeatureInstallState = Get-WindowsFeature -ComputerName $node -Name 'Hyper-V', 'Hyper-V-PowerShell', 'Failover-Clustering', 'Data-Center-Bridging', 'RSAT-DataCenterBridging-LLDP-Tools', 'NetworkATC', 'NetworkHUD' $thisNodeFeatureStatus = @() $FeatureInstallState | ForEach-Object { $thisFeature = $_ $thisFeatureStatus = New-Object -TypeName psobject $thisFeatureStatus | Add-Member -MemberType NoteProperty -Name Node -Value $Node $thisFeatureStatus | Add-Member -MemberType NoteProperty -Name Name -Value $thisFeature.Name $thisFeatureStatus | Add-Member -MemberType NoteProperty -Name InstallState -Value $thisFeature.InstallState # This is the nodes entire list of features and status $thisNodeFeatureStatus += $thisFeatureStatus } if ($thisNodeFeatureStatus.InstallState -contains (-not 'Installed')) { $OperationalState = 'Failed' $MissingFeatures = @{ False = $thisNodeFeatureStatus } $thisNodeAllRequirements | Add-Member -MemberType NoteProperty -Name Features -Value $MissingFeatures } else { $InstalledFeatures = @{ True = $thisNodeFeatureStatus } $thisNodeAllRequirements | Add-Member -MemberType NoteProperty -Name Features -Value $InstalledFeatures } #endregion WindowsFeatures #region Service $Service = Get-WmiObject -ComputerName $node -Class Win32_Service | Where-Object { $_.Name -eq 'NetworkHUD' } if ($Service) { if ($Service.Startmode -eq 'Auto') { $thisNodeAllRequirements | Add-Member -MemberType NoteProperty -Name 'ServiceStartup' -Value 'Automatic' } else { $OperationalState = 'Failed' $thisNodeAllRequirements | Add-Member -MemberType NoteProperty -Name 'ServiceStartup' -Value $Service.Startmode } if ($Service.State -eq "Running") { $thisNodeAllRequirements | Add-Member -MemberType NoteProperty -Name 'ServiceStatus' -Value 'Running' # Get Start Time of Service $SvcStartFilter = @{ LogName = "System" ID = 7036 ProviderName = 'Service Control Manager' } $ServiceStartTime = (Get-WinEvent -FilterHashTable $SvcStartFilter -ErrorAction SilentlyContinue | Where-Object { $_.LevelDisplayName -eq 'Information' -and $_.Message -like "*NetworkHUD*running*" } | Select-Object -First 1).TimeCreated # Now look for failures after the start time $SvcFailureFilter = @{ LogName = "Microsoft-Windows-Networking-NetworkHUD/Operational" ID = 105, 106, 109, 110 } $thisNodeEvents = Get-WinEvent -ComputerName $node -FilterHashTable $SvcFailureFilter -MaxEvents 1 -ErrorAction SilentlyContinue | Where-Object TimeCreated -ge $ServiceStartTime # If the system started, don't iterate through the events. if (($thisNodeEvents).ID -ne '105') { $OperationalState = 'Failed' if ($event.ProcessId -ne $Service.ProcessId) { Continue } Switch ($thisNodeEvents.ID) { 106 { $seenID = 'MissingContent' } 109 { $seenID = 'PrequisitesNotMet' } 110 { $seenID = 'CorruptConfiguration' } } if (-not $seenId) { $seenId = 'Unknown'} $thisNodeAllRequirements | Add-Member -MemberType NoteProperty -Name 'ServiceStartFailure' -Value $seenId } else { $thisNodeAllRequirements | Add-Member -MemberType NoteProperty -Name 'ServiceStartFailure' -Value 'None' } } else { $OperationalState = 'Failed' $thisNodeAllRequirements | Add-Member -MemberType NoteProperty -Name 'ServiceStatus' -Value $Service.State $thisNodeAllRequirements | Add-Member -MemberType NoteProperty -Name 'ServiceStartFailure' -Value 'Unknown' } } else { $OperationalState = 'Failed' } #endregion Service #region Content Verification $thisNodeContentVersion = $ContentList | Where-Object Node -eq $node $HighestContentVersion = $ContentList.Version | Sort-Object -Descending | Select-Object -First 1 $thisNodeAllRequirements | Add-Member -MemberType NoteProperty -Name 'ContentVersion' -Value $thisNodeContentVersion.Version if ($thisNodeContentVersion.Version -ge $HighestContentVersion.Version) { $thisNodeAllRequirements | Add-Member -MemberType NoteProperty -Name 'ContentStatus' -Value 'OK' } else { $OperationalState = 'Failed' $thisNodeAllRequirements | Add-Member -MemberType NoteProperty -Name 'ContentStatus' -Value 'UpdateRequired' } #endregion Content #region Cluster and Notifications # Is Clustered, Is Name Resource On, Is Health Enabledd $isClustered = Get-Cluster -WarningAction SilentlyContinue -ErrorAction SilentlyContinue If (-not ($isClustered)) { $OperationalState = 'Degraded' $thisNodeAllRequirements | Add-Member -MemberType NoteProperty -Name 'Clustered' -Value $false $thisNodeAllRequirements | Add-Member -MemberType NoteProperty -Name 'Alerting' -Value 'Not clustered' $thisNodeAllRequirements | Add-Member -MemberType NoteProperty -Name 'Events' -Value $true } else { $thisNodeAllRequirements | Add-Member -MemberType NoteProperty -Name 'Clustered' -Value $true # Ensure the cluster name is online $ClusterResourceName = Get-ClusterResource -Name 'Cluster Name' if ($ClusterResourceName.State -ne 'Online') { $OperationalState = 'Failed' } $thisNodeAllRequirements | Add-Member -MemberType NoteProperty -Name 'ClusterState' -Value $($ClusterResourceName.State) $isHealthy = Get-ClusterResource -Name Health -WarningAction SilentlyContinue -ErrorAction SilentlyContinue if ($isHealthy) { $thisNodeAllRequirements | Add-Member -MemberType NoteProperty -Name 'Alerting' -Value $true $thisNodeAllRequirements | Add-Member -MemberType NoteProperty -Name 'Events' -Value $true } else { $OperationalState = 'Degraded' $thisNodeAllRequirements | Add-Member -MemberType NoteProperty -Name 'Alerting' -Value 'Missing Health Service' $thisNodeAllRequirements | Add-Member -MemberType NoteProperty -Name 'Events' -Value $true } } #endregion Cluster and Notifications $thisNodeAllRequirements.OperationalState = $OperationalState $AllNodeFeatureStatus += $thisNodeAllRequirements } return $AllNodeFeatureStatus #TODO: Add an operational status for each node after the node name } Function Get-NetHudFault { <# .SYNOPSIS This returns the list of health conditions checked by Network HUD and provides a brief description of them. #> [CmdletBinding(DefaultParameterSetName = 'Default')] param ( [Parameter(ParameterSetName = 'Default', Mandatory = $false, ValueFromPipeline = $false, Position = 0)] [switch] $List ) $configJson = Get-Content -Raw -Path $(Join-Path $PSScriptRoot config.json) | ConvertFrom-Json Import-LocalizedData -BindingVariable "LocMessage" -FileName "LocalizationMessages" -BaseDirectory $PSScriptRoot $ScenarioObj = @() $configJson.Scenarios | ConvertNetHUDJSON | ForEach-Object { if ($_.Value.Definition) { $Tags = $_.Value.Tags -Split ',' $_.Value.Definition | ConvertNetHUDJSON | ForEach-Object { $thisScenarioObj = New-Object PSCustomObject $thisScenarioObj | Add-Member -MemberType NoteProperty -Name Tags -Value $Tags $thisScenarioObj | Add-Member -MemberType NoteProperty -Name Fault -Value $_.Key $thisScenarioObj | Add-Member -MemberType NoteProperty -Name Scope -Value $_.Value.FaultScope $thisScenarioObj | Add-Member -MemberType NoteProperty -Name Condition -Value $LocMessage.$($_.Value.FaultCondition) $thisScenarioObj | Add-Member -MemberType NoteProperty -Name Description -Value $LocMessage.$($_.Value.Description) $ScenarioObj += $thisScenarioObj } } } return $ScenarioObj } Function Get-NetHUDLog { [CmdletBinding(DefaultParameterSetName = 'ListAllLogs')] param( [Parameter(ParameterSetName = 'ListAllLogs', Mandatory = $false, ValueFromPipeline = $false, Position = 0)] [Parameter(ParameterSetName = 'ListContentLog', Mandatory = $false, ValueFromPipeline = $false, Position = 0)] [Parameter(ParameterSetName = 'ListOperationalLog', Mandatory = $false, ValueFromPipeline = $false, Position = 0)] [Parameter(ParameterSetName = 'ListDiagnosticLog', Mandatory = $false, ValueFromPipeline = $false, Position = 0)] [Switch] $ListLog, [Parameter(ParameterSetName = 'ListContentLog', Mandatory = $true, ValueFromPipeline = $false, Position = 1)] [Switch] $ContentLog, [Parameter(ParameterSetName = 'ListOperationalLog', Mandatory = $true, ValueFromPipeline = $false, Position = 1)] [Switch] $OperationalLog, [Parameter(ParameterSetName = 'ListDiagnosticLog', Mandatory = $true, ValueFromPipeline = $false, Position = 1)] [Switch] $DiagnosticLog ) if ($PSCmdlet.ParameterSetName -ne 'ClearAll' -and $PSCmdlet.ParameterSetName -ne 'ClearContentLog' -and $PSCmdlet.ParameterSetName -ne 'ClearOperationalLog' -and $PSCmdlet.ParameterSetName -ne 'ClearDiagnosticLog') { $Logs = Get-WinEvent -ListLog 'NetworkHUD', 'Microsoft-Windows-Networking-NetworkHUD/Operational', 'Microsoft-Windows-Networking-NetworkHUD/Diagnostic' -ErrorAction SilentlyContinue | Select-Object IsEnabled, IsLogFull, RecordCount, LogName } if ($PSCmdlet.ParameterSetName -eq 'ListAllLogs') { $Logs } elseif ($PSCmdlet.ParameterSetName -eq 'ListContentLog' -and ($Logs | Where-Object LogName -eq 'NetworkHUD').RecordCount -ne 0) { Get-EventLog -LogName NetworkHud -ErrorAction SilentlyContinue | Format-Table -Wrap -Autosize } elseif ($PSCmdlet.ParameterSetName -eq 'ListOperationalLog' -and ($Logs | Where-Object LogName -eq 'Microsoft-Windows-Networking-NetworkHUD/Operational').RecordCount -ne 0) { Get-WinEvent -LogName Microsoft-Windows-Networking-NetworkHUD/Operational -ErrorAction SilentlyContinue | Format-Table -Wrap -Autosize } elseif ($PSCmdlet.ParameterSetName -eq 'ListDiagnosticLog' -and ($Logs | Where-Object LogName -eq 'Microsoft-Windows-Networking-NetworkHUD/Diagnostic').RecordCount -ne 0) { Get-WinEvent -LogName Microsoft-Windows-Networking-NetworkHUD/Diagnostic -ErrorAction SilentlyContinue | Format-Table -Wrap -Autosize } } Function Clear-NetHUDLog { [CmdletBinding(DefaultParameterSetName = 'ListAllLogs')] param( [Parameter(ParameterSetName = 'ClearContentLog', Mandatory = $true, ValueFromPipeline = $false, Position = 0)] [Switch] $ContentLog, [Parameter(ParameterSetName = 'ClearOperationalLog', Mandatory = $true, ValueFromPipeline = $false, Position = 0)] [Switch] $OperationalLog, [Parameter(ParameterSetName = 'ClearDiagnosticLog', Mandatory = $true, ValueFromPipeline = $false, Position = 0)] [Switch] $DiagnosticLog ) if ($PSCmdlet.ParameterSetName -eq 'ClearContentLog' ) { wevtutil.exe cl NetworkHUD } elseif ($PSCmdlet.ParameterSetName -eq 'ClearOperationalLog') { wevtutil.exe cl Microsoft-Windows-Networking-NetworkHud/Operational } elseif ($PSCmdlet.ParameterSetName -eq 'ClearDiagnosticLog' ) { wevtutil.exe cl Microsoft-Windows-Networking-NetworkHud/Diagnostic } else { wevtutil.exe cl NetworkHUD wevtutil.exe cl Microsoft-Windows-Networking-NetworkHud/Operational wevtutil.exe cl Microsoft-Windows-Networking-NetworkHud/Diagnostic } } ############## # End of public functions # SIG # Begin signature block # MIInwgYJKoZIhvcNAQcCoIInszCCJ68CAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDIyAdWowAswtEu # WXrsIWt6JPDuOUfrSbPnDHzTu6gSQ6CCDXYwggX0MIID3KADAgECAhMzAAADrzBA # DkyjTQVBAAAAAAOvMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p # bmcgUENBIDIwMTEwHhcNMjMxMTE2MTkwOTAwWhcNMjQxMTE0MTkwOTAwWjB0MQsw # CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u # ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB # AQDOS8s1ra6f0YGtg0OhEaQa/t3Q+q1MEHhWJhqQVuO5amYXQpy8MDPNoJYk+FWA # hePP5LxwcSge5aen+f5Q6WNPd6EDxGzotvVpNi5ve0H97S3F7C/axDfKxyNh21MG # 0W8Sb0vxi/vorcLHOL9i+t2D6yvvDzLlEefUCbQV/zGCBjXGlYJcUj6RAzXyeNAN # xSpKXAGd7Fh+ocGHPPphcD9LQTOJgG7Y7aYztHqBLJiQQ4eAgZNU4ac6+8LnEGAL # go1ydC5BJEuJQjYKbNTy959HrKSu7LO3Ws0w8jw6pYdC1IMpdTkk2puTgY2PDNzB # tLM4evG7FYer3WX+8t1UMYNTAgMBAAGjggFzMIIBbzAfBgNVHSUEGDAWBgorBgEE # AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQURxxxNPIEPGSO8kqz+bgCAQWGXsEw # RQYDVR0RBD4wPKQ6MDgxHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEW # MBQGA1UEBRMNMjMwMDEyKzUwMTgyNjAfBgNVHSMEGDAWgBRIbmTlUAXTgqoXNzci # tW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8vd3d3Lm1pY3Jvc29mdC5j # b20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3JsMGEG # CCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDovL3d3dy5taWNyb3NvZnQu # Y29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3J0 # MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIBAISxFt/zR2frTFPB45Yd # mhZpB2nNJoOoi+qlgcTlnO4QwlYN1w/vYwbDy/oFJolD5r6FMJd0RGcgEM8q9TgQ # 2OC7gQEmhweVJ7yuKJlQBH7P7Pg5RiqgV3cSonJ+OM4kFHbP3gPLiyzssSQdRuPY # 1mIWoGg9i7Y4ZC8ST7WhpSyc0pns2XsUe1XsIjaUcGu7zd7gg97eCUiLRdVklPmp # XobH9CEAWakRUGNICYN2AgjhRTC4j3KJfqMkU04R6Toyh4/Toswm1uoDcGr5laYn # TfcX3u5WnJqJLhuPe8Uj9kGAOcyo0O1mNwDa+LhFEzB6CB32+wfJMumfr6degvLT # e8x55urQLeTjimBQgS49BSUkhFN7ois3cZyNpnrMca5AZaC7pLI72vuqSsSlLalG # OcZmPHZGYJqZ0BacN274OZ80Q8B11iNokns9Od348bMb5Z4fihxaBWebl8kWEi2O # PvQImOAeq3nt7UWJBzJYLAGEpfasaA3ZQgIcEXdD+uwo6ymMzDY6UamFOfYqYWXk # ntxDGu7ngD2ugKUuccYKJJRiiz+LAUcj90BVcSHRLQop9N8zoALr/1sJuwPrVAtx # HNEgSW+AKBqIxYWM4Ev32l6agSUAezLMbq5f3d8x9qzT031jMDT+sUAoCw0M5wVt # CUQcqINPuYjbS1WgJyZIiEkBMIIHejCCBWKgAwIBAgIKYQ6Q0gAAAAAAAzANBgkq # hkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x # EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv # bjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5 # IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEwOTA5WjB+MQswCQYDVQQG # EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG # A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYDVQQDEx9NaWNyb3NvZnQg # Q29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC # CgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+laUKq4BjgaBEm6f8MMHt03 # a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc6Whe0t+bU7IKLMOv2akr # rnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4Ddato88tt8zpcoRb0Rrrg # OGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+lD3v++MrWhAfTVYoonpy # 4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nkkDstrjNYxbc+/jLTswM9 # sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6A4aN91/w0FK/jJSHvMAh # dCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmdX4jiJV3TIUs+UsS1Vz8k # A/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL5zmhD+kjSbwYuER8ReTB # w3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zdsGbiwZeBe+3W7UvnSSmn # Eyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3T8HhhUSJxAlMxdSlQy90 # lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS4NaIjAsCAwEAAaOCAe0w # ggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRIbmTlUAXTgqoXNzcitW2o # ynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYD # VR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBDuRQFTuHqp8cx0SOJNDBa # BgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2Ny # bC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3JsMF4GCCsG # AQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3dy5taWNyb3NvZnQuY29t # L3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3J0MIGfBgNV # HSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEFBQcCARYzaHR0cDovL3d3 # dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1hcnljcHMuaHRtMEAGCCsG # AQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkAYwB5AF8AcwB0AGEAdABl # AG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn8oalmOBUeRou09h0ZyKb # C5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7v0epo/Np22O/IjWll11l # hJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0bpdS1HXeUOeLpZMlEPXh6 # I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/KmtYSWMfCWluWpiW5IP0 # wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvyCInWH8MyGOLwxS3OW560 # STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBpmLJZiWhub6e3dMNABQam # ASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJihsMdYzaXht/a8/jyFqGa # J+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYbBL7fQccOKO7eZS/sl/ah # XJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbSoqKfenoi+kiVH6v7RyOA # 9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sLgOppO6/8MO0ETI7f33Vt # Y5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtXcVZOSEXAQsmbdlsKgEhr # /Xmfwb1tbWrJUnMTDXpQzTGCGaIwghmeAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw # EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN # aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp # Z25pbmcgUENBIDIwMTECEzMAAAOvMEAOTKNNBUEAAAAAA68wDQYJYIZIAWUDBAIB # BQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO # MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIMB8zrgpN6O8AYtZwz61CDLP # QOk4nTqpYhI4AY6m+izaMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8A # cwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEB # BQAEggEAKjWRIdCNQZzsLLvZPZdGge1rtOeRKlaLOgF/7KjCHM9BBbq6ew714Zix # ix257SJUn8iWE/jUm/JYKQnyrQ62gH+22xxLqIHhBevcaO1cQ8doNH3Ey0frg/11 # JnDIohvrHhJVC852DRhdyI2CWyHSd9yJ62PvNLIpBNcGepqOTEOKCmXyZakybUCX # 1En8TGLsgR8Ob/7o1kjRSOB9LdKMIcfWM373j8VAL9l9jc1G1KdamFVlLWBwZB81 # 182zE6W5y2PnShdREYyTMYE/w54++8q1yEzvvudUHXR4f70X0uEtPL5AA14D3r0W # zFiJ+cPKCJNS2vVhWb6B3JHmJ0UGAKGCFywwghcoBgorBgEEAYI3AwMBMYIXGDCC # FxQGCSqGSIb3DQEHAqCCFwUwghcBAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFZBgsq # hkiG9w0BCRABBKCCAUgEggFEMIIBQAIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFl # AwQCAQUABCBabCVu1/SbfFCX2seEhaA+i1hHplJGDItRWD6HcDw9mgIGZbqj26xI # GBMyMDI0MDIxNDIyNDMwNi42NjJaMASAAgH0oIHYpIHVMIHSMQswCQYDVQQGEwJV # UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE # ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJl # bGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJjAkBgNVBAsTHVRoYWxlcyBUU1MgRVNO # OjNCRDQtNEI4MC02OUMzMSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBT # ZXJ2aWNloIIRezCCBycwggUPoAMCAQICEzMAAAHlj2rA8z20C6MAAQAAAeUwDQYJ # KoZIhvcNAQELBQAwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x # EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv # bjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwHhcNMjMx # MDEyMTkwNzM1WhcNMjUwMTEwMTkwNzM1WjCB0jELMAkGA1UEBhMCVVMxEzARBgNV # BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv # c29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxhbmQgT3Bl # cmF0aW9ucyBMaW1pdGVkMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjozQkQ0LTRC # ODAtNjlDMzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZTCC # AiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAKl74Drau2O6LLrJO3HyTvO9 # aXai//eNyP5MLWZrmUGNOJMPwMI08V9zBfRPNcucreIYSyJHjkMIUGmuh0rPV5/2 # +UCLGrN1P77n9fq/mdzXMN1FzqaPHdKElKneJQ8R6cP4dru2Gymmt1rrGcNe800C # cD6d/Ndoommkd196VqOtjZFA1XWu+GsFBeWHiez/PllqcM/eWntkQMs0lK0zmCfH # +Bu7i1h+FDRR8F7WzUr/7M3jhVdPpAfq2zYCA8ZVLNgEizY+vFmgx+zDuuU/GChD # K7klDcCw+/gVoEuSOl5clQsydWQjJJX7Z2yV+1KC6G1JVqpP3dpKPAP/4udNqpR5 # HIeb8Ta1JfjRUzSv3qSje5y9RYT/AjWNYQ7gsezuDWM/8cZ11kco1JvUyOQ8x/JD # kMFqSRwj1v+mc6LKKlj//dWCG/Hw9ppdlWJX6psDesQuQR7FV7eCqV/lfajoLpPN # x/9zF1dv8yXBdzmWJPeCie2XaQnrAKDqlG3zXux9tNQmz2L96TdxnIO2OGmYxBAA # ZAWoKbmtYI+Ciz4CYyO0Fm5Z3T40a5d7KJuftF6CToccc/Up/jpFfQitLfjd71cS # +cLCeoQ+q0n0IALvV+acbENouSOrjv/QtY4FIjHlI5zdJzJnGskVJ5ozhji0YRsc # v1WwJFAuyyCMQvLdmPddAgMBAAGjggFJMIIBRTAdBgNVHQ4EFgQU3/+fh7tNczEi # fEXlCQgFOXgMh6owHwYDVR0jBBgwFoAUn6cVXQBeYl2D9OXSZacbUzUZ6XIwXwYD # VR0fBFgwVjBUoFKgUIZOaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9j # cmwvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3JsMGwG # CCsGAQUFBwEBBGAwXjBcBggrBgEFBQcwAoZQaHR0cDovL3d3dy5taWNyb3NvZnQu # Y29tL3BraW9wcy9jZXJ0cy9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIw # MjAxMCgxKS5jcnQwDAYDVR0TAQH/BAIwADAWBgNVHSUBAf8EDDAKBggrBgEFBQcD # CDAOBgNVHQ8BAf8EBAMCB4AwDQYJKoZIhvcNAQELBQADggIBADP6whOFjD1ad8Gk # EJ9oLBuvfjndMyGQ9R4HgBKSlPt3pa0XVLcimrJlDnKGgFBiWwI6XOgw82hdolDi # MDBLLWRMTJHWVeUY1gU4XB8OOIxBc9/Q83zb1c0RWEupgC48I+b+2x2VNgGJUsQI # yPR2PiXQhT5PyerMgag9OSodQjFwpNdGirna2rpV23EUwFeO5+3oSX4JeCNZvgyU # OzKpyMvqVaubo+Glf/psfW5tIcMjZVt0elswfq0qJNQgoYipbaTvv7xmixUJGTbi # xYifTwAivPcKNdeisZmtts7OHbAM795ZvKLSEqXiRUjDYZyeHyAysMEALbIhdXgH # Eh60KoZyzlBXz3VxEirE7nhucNwM2tViOlwI7EkeU5hudctnXCG55JuMw/wb7c71 # RKimZA/KXlWpmBvkJkB0BZES8OCGDd+zY/T9BnTp8si36Tql84VfpYe9iHmy7Pqq # xqMF2Cn4q2a0mEMnpBruDGE/gR9c8SVJ2ntkARy5SfluuJ/MB61yRvT1mUx3lypp # O22ePjBjnwoEvVxbDjT1jhdMNdevOuDeJGzRLK9HNmTDC+TdZQlj+VMgIm8ZeEIR # NF0oaviF+QZcUZLWzWbYq6yDok8EZKFiRR5otBoGLvaYFpxBZUE8mnLKuDlYobjr # xh7lnwrxV/fMy0F9fSo2JxFmtLgtMIIHcTCCBVmgAwIBAgITMwAAABXF52ueAptJ # mQAAAAAAFTANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgT # Cldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m # dCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNh # dGUgQXV0aG9yaXR5IDIwMTAwHhcNMjEwOTMwMTgyMjI1WhcNMzAwOTMwMTgzMjI1 # WjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH # UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQD # Ex1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDCCAiIwDQYJKoZIhvcNAQEB # BQADggIPADCCAgoCggIBAOThpkzntHIhC3miy9ckeb0O1YLT/e6cBwfSqWxOdcjK # NVf2AX9sSuDivbk+F2Az/1xPx2b3lVNxWuJ+Slr+uDZnhUYjDLWNE893MsAQGOhg # fWpSg0S3po5GawcU88V29YZQ3MFEyHFcUTE3oAo4bo3t1w/YJlN8OWECesSq/XJp # rx2rrPY2vjUmZNqYO7oaezOtgFt+jBAcnVL+tuhiJdxqD89d9P6OU8/W7IVWTe/d # vI2k45GPsjksUZzpcGkNyjYtcI4xyDUoveO0hyTD4MmPfrVUj9z6BVWYbWg7mka9 # 7aSueik3rMvrg0XnRm7KMtXAhjBcTyziYrLNueKNiOSWrAFKu75xqRdbZ2De+JKR # Hh09/SDPc31BmkZ1zcRfNN0Sidb9pSB9fvzZnkXftnIv231fgLrbqn427DZM9itu # qBJR6L8FA6PRc6ZNN3SUHDSCD/AQ8rdHGO2n6Jl8P0zbr17C89XYcz1DTsEzOUyO # ArxCaC4Q6oRRRuLRvWoYWmEBc8pnol7XKHYC4jMYctenIPDC+hIK12NvDMk2ZItb # oKaDIV1fMHSRlJTYuVD5C4lh8zYGNRiER9vcG9H9stQcxWv2XFJRXRLbJbqvUAV6 # bMURHXLvjflSxIUXk8A8FdsaN8cIFRg/eKtFtvUeh17aj54WcmnGrnu3tz5q4i6t # AgMBAAGjggHdMIIB2TASBgkrBgEEAYI3FQEEBQIDAQABMCMGCSsGAQQBgjcVAgQW # BBQqp1L+ZMSavoKRPEY1Kc8Q/y8E7jAdBgNVHQ4EFgQUn6cVXQBeYl2D9OXSZacb # UzUZ6XIwXAYDVR0gBFUwUzBRBgwrBgEEAYI3TIN9AQEwQTA/BggrBgEFBQcCARYz # aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9Eb2NzL1JlcG9zaXRvcnku # aHRtMBMGA1UdJQQMMAoGCCsGAQUFBwMIMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIA # QwBBMAsGA1UdDwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNX2 # VsuP6KJcYmjRPZSQW9fOmhjEMFYGA1UdHwRPME0wS6BJoEeGRWh0dHA6Ly9jcmwu # bWljcm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dF8yMDEw # LTA2LTIzLmNybDBaBggrBgEFBQcBAQROMEwwSgYIKwYBBQUHMAKGPmh0dHA6Ly93 # d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYt # MjMuY3J0MA0GCSqGSIb3DQEBCwUAA4ICAQCdVX38Kq3hLB9nATEkW+Geckv8qW/q # XBS2Pk5HZHixBpOXPTEztTnXwnE2P9pkbHzQdTltuw8x5MKP+2zRoZQYIu7pZmc6 # U03dmLq2HnjYNi6cqYJWAAOwBb6J6Gngugnue99qb74py27YP0h1AdkY3m2CDPVt # I1TkeFN1JFe53Z/zjj3G82jfZfakVqr3lbYoVSfQJL1AoL8ZthISEV09J+BAljis # 9/kpicO8F7BUhUKz/AyeixmJ5/ALaoHCgRlCGVJ1ijbCHcNhcy4sa3tuPywJeBTp # kbKpW99Jo3QMvOyRgNI95ko+ZjtPu4b6MhrZlvSP9pEB9s7GdP32THJvEKt1MMU0 # sHrYUP4KWN1APMdUbZ1jdEgssU5HLcEUBHG/ZPkkvnNtyo4JvbMBV0lUZNlz138e # W0QBjloZkWsNn6Qo3GcZKCS6OEuabvshVGtqRRFHqfG3rsjoiV5PndLQTHa1V1QJ # sWkBRH58oWFsc/4Ku+xBZj1p/cvBQUl+fpO+y/g75LcVv7TOPqUxUYS8vwLBgqJ7 # Fx0ViY1w/ue10CgaiQuPNtq6TPmb/wrpNPgkNWcr4A245oyZ1uEi6vAnQj0llOZ0 # dFtq0Z4+7X6gMTN9vMvpe784cETRkPHIqzqKOghif9lwY1NNje6CbaUFEMFxBmoQ # tB1VM1izoXBm8qGCAtcwggJAAgEBMIIBAKGB2KSB1TCB0jELMAkGA1UEBhMCVVMx # EzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoT # FU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxh # bmQgT3BlcmF0aW9ucyBMaW1pdGVkMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjoz # QkQ0LTRCODAtNjlDMzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2Vy # dmljZaIjCgEBMAcGBSsOAwIaAxUA942iGuYFrsE4wzWDd85EpM6RiwqggYMwgYCk # fjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH # UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQD # Ex1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQUFAAIF # AOl3lHMwIhgPMjAyNDAyMTUwMzM1MTVaGA8yMDI0MDIxNjAzMzUxNVowdzA9Bgor # BgEEAYRZCgQBMS8wLTAKAgUA6XeUcwIBADAKAgEAAgID+AIB/zAHAgEAAgITJjAK # AgUA6Xjl8wIBADA2BgorBgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIB # AAIDB6EgoQowCAIBAAIDAYagMA0GCSqGSIb3DQEBBQUAA4GBAEPF8M/MNoD45ZGB # Kw0xpPIu9NsrfUH8ac6df880DomsAtv729JUMLYmLY5us8mDxazuqtXiGgpQz5rk # 955j/vZbbx0OpN4lcUoRPLo20Rl1IhiDihXTtUJJPCw3qVOZGE6noa64svoiAf1/ # gO1CiHFWYlVaioymlvwueb8U+5i5MYIEDTCCBAkCAQEwgZMwfDELMAkGA1UEBhMC # VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV # BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRp # bWUtU3RhbXAgUENBIDIwMTACEzMAAAHlj2rA8z20C6MAAQAAAeUwDQYJYIZIAWUD # BAIBBQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG9w0BCRABBDAvBgkqhkiG9w0B # CQQxIgQgk2tERvu2iL3uSQhMiwAb5izbQY8+qPvcfnO3/Uw3TAQwgfoGCyqGSIb3 # DQEJEAIvMYHqMIHnMIHkMIG9BCAVqdP//qjxGFhe2YboEXeb8I/pAof01CwhbxUH # 9U697TCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9u # MRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRp # b24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAAB # 5Y9qwPM9tAujAAEAAAHlMCIEILVnBgmprI+GG6P8gyh9eD5dz8rCkLZBc+6WmC4Q # VECoMA0GCSqGSIb3DQEBCwUABIICADfMto6HmxShz911+++dLBrOiACyGVBy+bSz # 1GUSrzjaRXPZOH955Cqs+wY3H9tToGWokpv6BPgt7rO0Y6oET0LO9tcWZASLDNuh # HxLrh3JTB8FEed70ZKJUm6MoDEV6amZik3vfl/wz2hF5lRVx3TBhPXxLdmlZyTHp # ztjqngYYhCsAcUSZq/qAIKv76tt2gDyRA1FIAaLk7lZ2X8IO2THMNUM/aXgBQmpr # VIe2Z95ck7IleyMNEuzLIpAs+ZhE9JWYbdhHfBH8/CP7lP1F0mE3BvyMaL2s6SP1 # odOhUIcnZXOIqpGjpMLQyd4eYYgq9mwGR4fEgaf0vARozxvvrtlxoY2fHWmaRQqy # Q8onLj0xdGvpuPXvj0S13PZ0AXcuWELepXMCoPtMxxmZMm2pEUF2LiQfQthy9bnJ # 7JBWnXmpi3tPfQ7sOsvFMhQDyJ6LjelIsVkTZnzapdLAjv4SHahUVZE5L1H+vD43 # NpmgXhIOyM3Ibh79hFt8N0gtxEtpCi7E2/mgcP5GXfotIqhlovQkVdgB6dylwYZ6 # 7AYs7Kwus+/3jVzpF4cg9Z3GdV9wTOnUDVO836GvNN8oTqLn8n1/lNmjvI7Z8c1P # Lhdt6HrZQN8J9TltCaewZTnKwrvZ+RK9OK3RnOZMPWOapolzkd+EtOv9rdimV0SX # MEJfUEeW # SIG # End signature block |