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 # MIInvgYJKoZIhvcNAQcCoIInrzCCJ6sCAQExDzANBglghkgBZQMEAgEFADB5Bgor # 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 # /Xmfwb1tbWrJUnMTDXpQzTGCGZ4wghmaAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw # EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN # aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp # Z25pbmcgUENBIDIwMTECEzMAAAOvMEAOTKNNBUEAAAAAA68wDQYJYIZIAWUDBAIB # BQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO # MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIMB8zrgpN6O8AYtZwz61CDLP # QOk4nTqpYhI4AY6m+izaMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8A # cwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEB # BQAEggEAKjWRIdCNQZzsLLvZPZdGge1rtOeRKlaLOgF/7KjCHM9BBbq6ew714Zix # ix257SJUn8iWE/jUm/JYKQnyrQ62gH+22xxLqIHhBevcaO1cQ8doNH3Ey0frg/11 # JnDIohvrHhJVC852DRhdyI2CWyHSd9yJ62PvNLIpBNcGepqOTEOKCmXyZakybUCX # 1En8TGLsgR8Ob/7o1kjRSOB9LdKMIcfWM373j8VAL9l9jc1G1KdamFVlLWBwZB81 # 182zE6W5y2PnShdREYyTMYE/w54++8q1yEzvvudUHXR4f70X0uEtPL5AA14D3r0W # zFiJ+cPKCJNS2vVhWb6B3JHmJ0UGAKGCFygwghckBgorBgEEAYI3AwMBMYIXFDCC # FxAGCSqGSIb3DQEHAqCCFwEwghb9AgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFYBgsq # hkiG9w0BCRABBKCCAUcEggFDMIIBPwIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFl # AwQCAQUABCBabCVu1/SbfFCX2seEhaA+i1hHplJGDItRWD6HcDw9mgIGZbqdZBLT # GBIyMDI0MDIwMTE5MDMwMC4wNFowBIACAfSggdikgdUwgdIxCzAJBgNVBAYTAlVT # MRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQK # ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVs # YW5kIE9wZXJhdGlvbnMgTGltaXRlZDEmMCQGA1UECxMdVGhhbGVzIFRTUyBFU046 # OEQ0MS00QkY3LUIzQjcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNl # cnZpY2WgghF4MIIHJzCCBQ+gAwIBAgITMwAAAePfvZuaHGiDIgABAAAB4zANBgkq # hkiG9w0BAQsFADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQ # MA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9u # MSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDAeFw0yMzEw # MTIxOTA3MjlaFw0yNTAxMTAxOTA3MjlaMIHSMQswCQYDVQQGEwJVUzETMBEGA1UE # CBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9z # b2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVy # YXRpb25zIExpbWl0ZWQxJjAkBgNVBAsTHVRoYWxlcyBUU1MgRVNOOjhENDEtNEJG # Ny1CM0I3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIIC # IjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAvqQNaB5Gn5/FIFQPo3/K4Qml # eCDMF40bkoHwz0BshZ4SiQmA6CGUyDwmaqQ2wHhaXU0RdHtwvq+U8KxYYsyHKqax # xC7fr/yHZvHpNTgzx1VkR3pXhT6X2Cm175UX3WQ4jfl86onp5AMzBIFDlz0SU8VS # KNMDvNXtjk9FitLgUv2nj3hOJ0KkEQfk3oA7m7zA0D+Mo73hmR+OC7uwsXxJR2tz # UZE0STYX3UvenFH7fYWy5BNmLyGq2sWkQ5HFvJKCJAE/dwft8+V43U3KeExF/pPt # cLUvQ9HIrL0xnpMFau7Yd5aK+TEi57WctBv87+fSPZBV3jZl/QCtcH9WrniBDwki # 9QfRxu/JYzw+iaEWLqrYXuF7jeOGvHK+fVeLWnAc5WxsfbpjEMpNbGXbSF9At3PP # hFVOjxwVEx1ALGUqRKehw9ap9X/gfkA9I9eTSvwJz9wya9reDgS+6kXgSttI7RQ2 # cJG/tQPGVIaLCIaSafLneaq0Bns0t4+EW3B/GnoBMiiOXwleOvf5udBZQIMJ3k5q # nnh8Z4ZhTwrE6iGbPrTgGBPXh7exFYAGlb6hdhILIVDdJlDf8s1NVvL0Q2y4SHZQ # hApZTuW/tyGsGscIPDSMz5bA6NhRLtjEwCFpLI5qGlu50Au9FRelCEQsWg7q07H/ # rqHOqCNJM4Rjem7joEUCAwEAAaOCAUkwggFFMB0GA1UdDgQWBBSxrg1mvjUVt6Fn # xj56nabZiJipAzAfBgNVHSMEGDAWgBSfpxVdAF5iXYP05dJlpxtTNRnpcjBfBgNV # HR8EWDBWMFSgUqBQhk5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2Ny # bC9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcmwwbAYI # KwYBBQUHAQEEYDBeMFwGCCsGAQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29mdC5j # b20vcGtpb3BzL2NlcnRzL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAy # MDEwKDEpLmNydDAMBgNVHRMBAf8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMI # MA4GA1UdDwEB/wQEAwIHgDANBgkqhkiG9w0BAQsFAAOCAgEAt76bLqnU08wRbW3v # RrxjaEbGPqyINK6UYCzhTGaR/PEwCJziPT4ZM9sfGTX3eZDQVE9r121tFtp7NXQY # uQSxRZMYXa0/pawN2Xn+UPjBRDvoCsU56dwKkrmy8TSw7QXKGskdnEwsI5yW93q8 # Ag86RkBiKEEf9FdzHNuKWI4Kv//fDtESewu46n/u+VckCwbOYl6wE//QRGrGMq50 # 9a4EbP+p1GUm06Xme/01mTIuKDgPmHL2nYRzXNqi2IuIecn2aWwkRxQOFiPw+dic # mOOwLG/7InNqjZpQeIhDMxsWr4zTxzy4ER/6zfthtlDtcAXHB7YRUkBTClaOa0nd # vfNJZMyYVa6cWvZouTq9V5LS7UzIR8S/7RsOT43eOawLBsuQz0VoOLurYe1SffPq # TsCcRNzbx0C8t/+KipStVhPAGttEfhdUUS9ohD6Lt6wNCJxZbV0IMD8nfE6gIQJX # rzrXWOuJqN91WDyjRan4UKDkIBS2yWA4W6JhQuBzGerOSY/aLnxkRrSubgtnKYcH # OwgxTTIya5WYCRjFt0QOLleqVki6k+mqYPr98uMPi5vRIQS206mDSenStr8w0J+/ # +1WEm3PnCCIQgpf6zhqRrAt9j7XrEMHrg2bQegaz8bLzbe6UibgbKtRyk1nGde8T # o5kyMj9XUCBICDxT+F4xa5lNZVQwggdxMIIFWaADAgECAhMzAAAAFcXna54Cm0mZ # AAAAAAAVMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMK # V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0 # IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZpY2F0 # ZSBBdXRob3JpdHkgMjAxMDAeFw0yMTA5MzAxODIyMjVaFw0zMDA5MzAxODMyMjVa # MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS # ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMT # HU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMIICIjANBgkqhkiG9w0BAQEF # AAOCAg8AMIICCgKCAgEA5OGmTOe0ciELeaLL1yR5vQ7VgtP97pwHB9KpbE51yMo1 # V/YBf2xK4OK9uT4XYDP/XE/HZveVU3Fa4n5KWv64NmeFRiMMtY0Tz3cywBAY6GB9 # alKDRLemjkZrBxTzxXb1hlDcwUTIcVxRMTegCjhuje3XD9gmU3w5YQJ6xKr9cmmv # Haus9ja+NSZk2pg7uhp7M62AW36MEBydUv626GIl3GoPz130/o5Tz9bshVZN7928 # jaTjkY+yOSxRnOlwaQ3KNi1wjjHINSi947SHJMPgyY9+tVSP3PoFVZhtaDuaRr3t # pK56KTesy+uDRedGbsoy1cCGMFxPLOJiss254o2I5JasAUq7vnGpF1tnYN74kpEe # HT39IM9zfUGaRnXNxF803RKJ1v2lIH1+/NmeRd+2ci/bfV+AutuqfjbsNkz2K26o # ElHovwUDo9Fzpk03dJQcNIIP8BDyt0cY7afomXw/TNuvXsLz1dhzPUNOwTM5TI4C # vEJoLhDqhFFG4tG9ahhaYQFzymeiXtcodgLiMxhy16cg8ML6EgrXY28MyTZki1ug # poMhXV8wdJGUlNi5UPkLiWHzNgY1GIRH29wb0f2y1BzFa/ZcUlFdEtsluq9QBXps # xREdcu+N+VLEhReTwDwV2xo3xwgVGD94q0W29R6HXtqPnhZyacaue7e3PmriLq0C # AwEAAaOCAd0wggHZMBIGCSsGAQQBgjcVAQQFAgMBAAEwIwYJKwYBBAGCNxUCBBYE # FCqnUv5kxJq+gpE8RjUpzxD/LwTuMB0GA1UdDgQWBBSfpxVdAF5iXYP05dJlpxtT # NRnpcjBcBgNVHSAEVTBTMFEGDCsGAQQBgjdMg30BATBBMD8GCCsGAQUFBwIBFjNo # dHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL0RvY3MvUmVwb3NpdG9yeS5o # dG0wEwYDVR0lBAwwCgYIKwYBBQUHAwgwGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBD # AEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU1fZW # y4/oolxiaNE9lJBb186aGMQwVgYDVR0fBE8wTTBLoEmgR4ZFaHR0cDovL2NybC5t # aWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0XzIwMTAt # MDYtMjMuY3JsMFoGCCsGAQUFBwEBBE4wTDBKBggrBgEFBQcwAoY+aHR0cDovL3d3 # dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0y # My5jcnQwDQYJKoZIhvcNAQELBQADggIBAJ1VffwqreEsH2cBMSRb4Z5yS/ypb+pc # FLY+TkdkeLEGk5c9MTO1OdfCcTY/2mRsfNB1OW27DzHkwo/7bNGhlBgi7ulmZzpT # Td2YurYeeNg2LpypglYAA7AFvonoaeC6Ce5732pvvinLbtg/SHUB2RjebYIM9W0j # VOR4U3UkV7ndn/OOPcbzaN9l9qRWqveVtihVJ9AkvUCgvxm2EhIRXT0n4ECWOKz3 # +SmJw7wXsFSFQrP8DJ6LGYnn8AtqgcKBGUIZUnWKNsIdw2FzLixre24/LAl4FOmR # sqlb30mjdAy87JGA0j3mSj5mO0+7hvoyGtmW9I/2kQH2zsZ0/fZMcm8Qq3UwxTSw # ethQ/gpY3UA8x1RtnWN0SCyxTkctwRQEcb9k+SS+c23Kjgm9swFXSVRk2XPXfx5b # RAGOWhmRaw2fpCjcZxkoJLo4S5pu+yFUa2pFEUep8beuyOiJXk+d0tBMdrVXVAmx # aQFEfnyhYWxz/gq77EFmPWn9y8FBSX5+k77L+DvktxW/tM4+pTFRhLy/AsGConsX # HRWJjXD+57XQKBqJC4822rpM+Zv/Cuk0+CQ1ZyvgDbjmjJnW4SLq8CdCPSWU5nR0 # W2rRnj7tfqAxM328y+l7vzhwRNGQ8cirOoo6CGJ/2XBjU02N7oJtpQUQwXEGahC0 # HVUzWLOhcGbyoYIC1DCCAj0CAQEwggEAoYHYpIHVMIHSMQswCQYDVQQGEwJVUzET # MBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMV # TWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFu # ZCBPcGVyYXRpb25zIExpbWl0ZWQxJjAkBgNVBAsTHVRoYWxlcyBUU1MgRVNOOjhE # NDEtNEJGNy1CM0I3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2 # aWNloiMKAQEwBwYFKw4DAhoDFQA9iJe7w5FDiG8py4TsYrQI6DFaeqCBgzCBgKR+ # MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS # ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMT # HU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqGSIb3DQEBBQUAAgUA # 6WXEXjAiGA8yMDI0MDIwMTE1MTg1NFoYDzIwMjQwMjAyMTUxODU0WjB0MDoGCisG # AQQBhFkKBAExLDAqMAoCBQDpZcReAgEAMAcCAQACAgCoMAcCAQACAhIAMAoCBQDp # ZxXeAgEAMDYGCisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkKAwKgCjAIAgEAAgMH # oSChCjAIAgEAAgMBhqAwDQYJKoZIhvcNAQEFBQADgYEARShoUfc5ADFSfPPjXnn1 # fg0E+USC6IowOjyhC7tc56dj7z6d0EeUm0iiXsehJ0zfyq5x6uzFVTTK5HL5VF/6 # CNhmLWXNWHKdIiZCtovEIXqg4ONt/zx3KH1kuAeVeGXYQLmu1sxRjlWGqSvphjNz # SmS6LwNOM100CzFmm1eH/zUxggQNMIIECQIBATCBkzB8MQswCQYDVQQGEwJVUzET # MBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMV # TWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1T # dGFtcCBQQ0EgMjAxMAITMwAAAePfvZuaHGiDIgABAAAB4zANBglghkgBZQMEAgEF # AKCCAUowGgYJKoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEEMC8GCSqGSIb3DQEJBDEi # BCBsgcwQ4HAjwnrk4Qu5OBfE+xznmVuu6Yyg/uN+ooHkqDCB+gYLKoZIhvcNAQkQ # Ai8xgeowgecwgeQwgb0EIDPUI6vlsP5k90SBCNa9wha4MlxBt2Crw12PTHIy5iYq # MIGYMIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAO # BgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEm # MCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAHj372b # mhxogyIAAQAAAeMwIgQgs0CDFYkFU+A5NIaO3zoPCnx1Xvl5xPlOmr2HwMnVVxEw # DQYJKoZIhvcNAQELBQAEggIAL7ByyYoqg67gPfrTreKsV9j2paj5Ke95d07BUc6A # JVImyyyQDRk6JIAp2mq4O+OxTTiu7J7Nmsc8DrP7IV4MyQns5XLOZhpA1Tx8we6i # 2uNpK0frlYjvI7+aUUJUrocLHEX56N6MJ/nHHKeh7Ot5vw6VmdGxBjQ8hMHS2+hK # 3OZkNShm13eAFSF9vbmM/mVI+awGKCuySv8qumiSqPjmQcGAiddI8puidFEE8/1G # Z2K9PJOo/RlV9FAmzOlrVvMxKDjnXlIrMmpYweYfBqXZiEWzCycBhnn2pmlGKQhT # E9dDRxs1zl9DOlF0dGzqs2ZhOvXUWrNFkJ0GSfhwlhGIx9lyxH/CcOVPzU7x5Nfv # ANj3v/kj0J+0bfwNM+KG9UPqLOS+yUzc6PBRxcwJqLHnRPFXxoyVbKfypXVGjnFK # 3ZnV3/lZQPeV4J/8lAbL1TD2OqIxGr6uOVmTcG42HbjLTVR9zRVVVBCAAQIHBRfi # dL1XIqW8lbIUqUcyAEBQRJoTg+Nd6ALOfN9psMN/dvZ09u76Uw2prsHTJxnGTVUF # bHv8KWhlfTqKXt5mHb0XAmKw6KRHnyqK6e17w6JkFifj+xmXw9K4YcxJ5flkHpkw # dwj/TCWtsH3GNUwU++3R9Y5YLAPQqhcr+uhaSuE/yZ8O0gCBpVGVvbG1cq3WOzGz # Csg= # SIG # End signature block |