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 # MIInpQYJKoZIhvcNAQcCoIInljCCJ5ICAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDIyAdWowAswtEu # WXrsIWt6JPDuOUfrSbPnDHzTu6gSQ6CCDYUwggYDMIID66ADAgECAhMzAAADri01 # UchTj1UdAAAAAAOuMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p # bmcgUENBIDIwMTEwHhcNMjMxMTE2MTkwODU5WhcNMjQxMTE0MTkwODU5WjB0MQsw # CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u # ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB # AQD0IPymNjfDEKg+YyE6SjDvJwKW1+pieqTjAY0CnOHZ1Nj5irGjNZPMlQ4HfxXG # yAVCZcEWE4x2sZgam872R1s0+TAelOtbqFmoW4suJHAYoTHhkznNVKpscm5fZ899 # QnReZv5WtWwbD8HAFXbPPStW2JKCqPcZ54Y6wbuWV9bKtKPImqbkMcTejTgEAj82 # 6GQc6/Th66Koka8cUIvz59e/IP04DGrh9wkq2jIFvQ8EDegw1B4KyJTIs76+hmpV # M5SwBZjRs3liOQrierkNVo11WuujB3kBf2CbPoP9MlOyyezqkMIbTRj4OHeKlamd # WaSFhwHLJRIQpfc8sLwOSIBBAgMBAAGjggGCMIIBfjAfBgNVHSUEGDAWBgorBgEE # AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUhx/vdKmXhwc4WiWXbsf0I53h8T8w # VAYDVR0RBE0wS6RJMEcxLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh # dGlvbnMgTGltaXRlZDEWMBQGA1UEBRMNMjMwMDEyKzUwMTgzNjAfBgNVHSMEGDAW # gBRIbmTlUAXTgqoXNzcitW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8v # d3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIw # MTEtMDctMDguY3JsMGEGCCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDov # L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDEx # XzIwMTEtMDctMDguY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIB # AGrJYDUS7s8o0yNprGXRXuAnRcHKxSjFmW4wclcUTYsQZkhnbMwthWM6cAYb/h2W # 5GNKtlmj/y/CThe3y/o0EH2h+jwfU/9eJ0fK1ZO/2WD0xi777qU+a7l8KjMPdwjY # 0tk9bYEGEZfYPRHy1AGPQVuZlG4i5ymJDsMrcIcqV8pxzsw/yk/O4y/nlOjHz4oV # APU0br5t9tgD8E08GSDi3I6H57Ftod9w26h0MlQiOr10Xqhr5iPLS7SlQwj8HW37 # ybqsmjQpKhmWul6xiXSNGGm36GarHy4Q1egYlxhlUnk3ZKSr3QtWIo1GGL03hT57 # xzjL25fKiZQX/q+II8nuG5M0Qmjvl6Egltr4hZ3e3FQRzRHfLoNPq3ELpxbWdH8t # Nuj0j/x9Crnfwbki8n57mJKI5JVWRWTSLmbTcDDLkTZlJLg9V1BIJwXGY3i2kR9i # 5HsADL8YlW0gMWVSlKB1eiSlK6LmFi0rVH16dde+j5T/EaQtFz6qngN7d1lvO7uk # 6rtX+MLKG4LDRsQgBTi6sIYiKntMjoYFHMPvI/OMUip5ljtLitVbkFGfagSqmbxK # 7rJMhC8wiTzHanBg1Rrbff1niBbnFbbV4UDmYumjs1FIpFCazk6AADXxoKCo5TsO # zSHqr9gHgGYQC2hMyX9MGLIpowYCURx3L7kUiGbOiMwaMIIHejCCBWKgAwIBAgIK # 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/Xmfwb1tbWrJUnMTDXpQzTGCGXYwghlyAgEBMIGVMH4x # CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt # b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01p # Y3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTECEzMAAAOuLTVRyFOPVR0AAAAA # A64wDQYJYIZIAWUDBAIBBQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQw # HAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIMB8 # zrgpN6O8AYtZwz61CDLPQOk4nTqpYhI4AY6m+izaMEIGCisGAQQBgjcCAQwxNDAy # oBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5j # b20wDQYJKoZIhvcNAQEBBQAEggEAvxUR0okGjuAhuztXAvhgrbIbS/CgjFEq2QP6 # ajGDLvWPkfMR6Pe1Lqcuz4Gh/ex5w417kDHWiG4+xeoLsOBLhFxSYR3+AJiqLWwh # Wkjv029gnO4k2H4nPP2cXJ9qYp9j3lIX6auFyM+/tns41jvjP6vhtoDlMunRSEdi # bhJA76lLIT5SwtKoUaYgkOd3AyJAcS7u8hiXONvCIyDe9i9ejFKbSOaWDMolI8B5 # yKvXSJHmflDFMzsyW2jaSb0+ORKvBvPcY2kl4tfyx+oW9mfomciMgEBmIeEyH9w5 # vBKgetQ35GJolQrdhKSbZurmAEL2FMV+f1yEdbtNjKc4KrX79aGCFwAwghb8Bgor # BgEEAYI3AwMBMYIW7DCCFugGCSqGSIb3DQEHAqCCFtkwghbVAgEDMQ8wDQYJYIZI # AWUDBAIBBQAwggFRBgsqhkiG9w0BCRABBKCCAUAEggE8MIIBOAIBAQYKKwYBBAGE # WQoDATAxMA0GCWCGSAFlAwQCAQUABCAjCcBkkDsAWvGDd6PkZVe8eD8kK0yiD2bT # c2JnjLLqlAIGZbpSeK/SGBMyMDI0MDIwMTIyNDExOC45MzJaMASAAgH0oIHQpIHN # MIHKMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH # UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQL # ExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMSYwJAYDVQQLEx1UaGFsZXMg # VFNTIEVTTjpFQUNFLUUzMTYtQzkxRDElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUt # U3RhbXAgU2VydmljZaCCEVcwggcMMIIE9KADAgECAhMzAAABw4tv00i/DpFdAAEA # AAHDMA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo # aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y # cG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEw # MB4XDTIyMTEwNDE5MDEyOVoXDTI0MDIwMjE5MDEyOVowgcoxCzAJBgNVBAYTAlVT # MRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQK # ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJTAjBgNVBAsTHE1pY3Jvc29mdCBBbWVy # aWNhIE9wZXJhdGlvbnMxJjAkBgNVBAsTHVRoYWxlcyBUU1MgRVNOOkVBQ0UtRTMx # Ni1DOTFEMSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIIC # IjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAu+u86s3R/q+ikos80aD42Ym2 # 1NDOZtldNRxMFUxm4o9kVWkSh2c8jOCxJXwV2KFodCTxpGQs9jy5nUI+Lq/bt0HW # tSYPMPPtet420gzwM1EsR26kbpwlBHxFY4hk3y3AH+1YKf9bhvPs7kPbXbH7gdac # iteB+F7FoORt9e0D/dsBeG80GZAF2y6LWAj6C2mMqlafXkwbfTyQanuX65Yu+xMp # yJ1fAREpuR766rePrqlE0KaaeD0nqOgGrTkSZeCMDPH6OtJ00jXMwbIDyH7l4fYR # eIsTfzN5Gf3Uairsjea+KFy22lU8elnIXjoeyx3pcesH+q5arY1c6HPfeSnkeMok # /gxnB7P1Mjt7I9EI9thQtMvy/1SUmLG12rBR/DfheE/VJpcm/TYeoV11NfQQnl/j # BbPbSRBp0HGqTIcWDpY6MgSdBoQET1DvpE4PX4sndNGc1wGyg45pH62ZMfUF/CzG # Z7iV637RtnQFXDzTxoSEEkdXMdWDJG+jjxoC16lRk1xFnfkA4uoma4mKso7qvE6d # 27+K6yzISWQ7TjutYLKJnSzNvfiNiuyv/0xxCASSARvOQ3v9cegvM/pnuU9c6s+4 # gmK3+5jhcvnWGQqJE0tpYHmk3bmmBL1gHm9TjBJz5m/8rvHM3Rw3OUhV4/wmAL32 # KmPR5Ubb4ww5HNGiuY0CAwEAAaOCATYwggEyMB0GA1UdDgQWBBQcGL7N2NdvAaK8 # TcLrxMTsa8aB1jAfBgNVHSMEGDAWgBSfpxVdAF5iXYP05dJlpxtTNRnpcjBfBgNV # HR8EWDBWMFSgUqBQhk5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2Ny # bC9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcmwwbAYI # KwYBBQUHAQEEYDBeMFwGCCsGAQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29mdC5j # b20vcGtpb3BzL2NlcnRzL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAy # MDEwKDEpLmNydDAMBgNVHRMBAf8EAjAAMBMGA1UdJQQMMAoGCCsGAQUFBwMIMA0G # CSqGSIb3DQEBCwUAA4ICAQDd8qZbHBqdBFRDxGGwDollnRyd0WmUnjqoP+5QCH4v # MPBt4umHVhJuyeRkDELkTWZuWqK3U1z2HnGatbnETcHUlywlH+3I7R7fU0zKYw2P # LA+VawCcrnsICgE3242EsEC/Z0YU740NJ/xbuzrGtTEtUIiQvr2ACPJyhsPote8I # tTf4uNW4Mbo1QP0tjcBKCgEezIC4DYUM0BYCWCmeZmNwAlxfpTliOFEKB9UaSqHS # s51cH8JY0gqL3LwI9LYfjEO77++HY/nMqXCMi9ihUKoIp2Tfjfzdm5Ng5V+yw8+w # Xl29RcW4Q4CvHntNfKxT9oQ3J7YBQQEHWJPg8TNR9w4B82FzmrDd8sL6ETvGux5h # FcwmF+Q2rT5Ma8dYUSdCSg/ihoEYUGJZnZL9nyDp1snflSVX7FpLyALzDDlHBW1C # JhYVffJRoqz1D4kRooqRBNRaMFMPingywwbEghMheJKNoda7AGgq+1HH1afRlE+9 # qYW9FKMezxeQmf8gcuAuhr9IAXyaF9DF0PJ5f4uhzOSvIC1BkJtzF6op45UYaI7V # +9X8dcwXbZJnIIAH1cjVO8KEChxKIkpk4Qgy0PocgUwaGWqmLWRu1hQ1WJWnQXvv # BYeYDGWbj/PtSlywv6m8mujLepfMvJcU25KWklSP2FuNx6aOVfeje+pgbwIQIVQ1 # nTCCB3EwggVZoAMCAQICEzMAAAAVxedrngKbSZkAAAAAABUwDQYJKoZIhvcNAQEL # BQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQH # EwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNV # BAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDEwMB4X # DTIxMDkzMDE4MjIyNVoXDTMwMDkzMDE4MzIyNVowfDELMAkGA1UEBhMCVVMxEzAR # BgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1p # Y3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3Rh # bXAgUENBIDIwMTAwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDk4aZM # 57RyIQt5osvXJHm9DtWC0/3unAcH0qlsTnXIyjVX9gF/bErg4r25PhdgM/9cT8dm # 95VTcVrifkpa/rg2Z4VGIwy1jRPPdzLAEBjoYH1qUoNEt6aORmsHFPPFdvWGUNzB # RMhxXFExN6AKOG6N7dcP2CZTfDlhAnrEqv1yaa8dq6z2Nr41JmTamDu6GnszrYBb # fowQHJ1S/rboYiXcag/PXfT+jlPP1uyFVk3v3byNpOORj7I5LFGc6XBpDco2LXCO # Mcg1KL3jtIckw+DJj361VI/c+gVVmG1oO5pGve2krnopN6zL64NF50ZuyjLVwIYw # XE8s4mKyzbnijYjklqwBSru+cakXW2dg3viSkR4dPf0gz3N9QZpGdc3EXzTdEonW # /aUgfX782Z5F37ZyL9t9X4C626p+Nuw2TPYrbqgSUei/BQOj0XOmTTd0lBw0gg/w # EPK3Rxjtp+iZfD9M269ewvPV2HM9Q07BMzlMjgK8QmguEOqEUUbi0b1qGFphAXPK # Z6Je1yh2AuIzGHLXpyDwwvoSCtdjbwzJNmSLW6CmgyFdXzB0kZSU2LlQ+QuJYfM2 # BjUYhEfb3BvR/bLUHMVr9lxSUV0S2yW6r1AFemzFER1y7435UsSFF5PAPBXbGjfH # CBUYP3irRbb1Hode2o+eFnJpxq57t7c+auIurQIDAQABo4IB3TCCAdkwEgYJKwYB # BAGCNxUBBAUCAwEAATAjBgkrBgEEAYI3FQIEFgQUKqdS/mTEmr6CkTxGNSnPEP8v # BO4wHQYDVR0OBBYEFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMFwGA1UdIARVMFMwUQYM # KwYBBAGCN0yDfQEBMEEwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWljcm9zb2Z0 # LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0b3J5Lmh0bTATBgNVHSUEDDAKBggrBgEF # BQcDCDAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYD # VR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvXzpoYxDBW # BgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2Ny # bC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYIKwYBBQUH # AQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtp # L2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNydDANBgkqhkiG9w0BAQsF # AAOCAgEAnVV9/Cqt4SwfZwExJFvhnnJL/Klv6lwUtj5OR2R4sQaTlz0xM7U518Jx # Nj/aZGx80HU5bbsPMeTCj/ts0aGUGCLu6WZnOlNN3Zi6th542DYunKmCVgADsAW+ # iehp4LoJ7nvfam++Kctu2D9IdQHZGN5tggz1bSNU5HhTdSRXud2f8449xvNo32X2 # pFaq95W2KFUn0CS9QKC/GbYSEhFdPSfgQJY4rPf5KYnDvBewVIVCs/wMnosZiefw # C2qBwoEZQhlSdYo2wh3DYXMuLGt7bj8sCXgU6ZGyqVvfSaN0DLzskYDSPeZKPmY7 # T7uG+jIa2Zb0j/aRAfbOxnT99kxybxCrdTDFNLB62FD+CljdQDzHVG2dY3RILLFO # Ry3BFARxv2T5JL5zbcqOCb2zAVdJVGTZc9d/HltEAY5aGZFrDZ+kKNxnGSgkujhL # mm77IVRrakURR6nxt67I6IleT53S0Ex2tVdUCbFpAUR+fKFhbHP+CrvsQWY9af3L # wUFJfn6Tvsv4O+S3Fb+0zj6lMVGEvL8CwYKiexcdFYmNcP7ntdAoGokLjzbaukz5 # m/8K6TT4JDVnK+ANuOaMmdbhIurwJ0I9JZTmdHRbatGePu1+oDEzfbzL6Xu/OHBE # 0ZDxyKs6ijoIYn/ZcGNTTY3ugm2lBRDBcQZqELQdVTNYs6FwZvKhggLOMIICNwIB # ATCB+KGB0KSBzTCByjELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x # EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv # bjElMCMGA1UECxMcTWljcm9zb2Z0IEFtZXJpY2EgT3BlcmF0aW9uczEmMCQGA1UE # CxMdVGhhbGVzIFRTUyBFU046RUFDRS1FMzE2LUM5MUQxJTAjBgNVBAMTHE1pY3Jv # c29mdCBUaW1lLVN0YW1wIFNlcnZpY2WiIwoBATAHBgUrDgMCGgMVAPEdL+Ps+h03 # e+SLXdGzuY7tLu7OoIGDMIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldh # c2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBD # b3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIw # MTAwDQYJKoZIhvcNAQEFBQACBQDpZiJ2MCIYDzIwMjQwMjAxMjIwMDIyWhgPMjAy # NDAyMDIyMjAwMjJaMHcwPQYKKwYBBAGEWQoEATEvMC0wCgIFAOlmInYCAQAwCgIB # AAICJ38CAf8wBwIBAAICEgAwCgIFAOlnc/YCAQAwNgYKKwYBBAGEWQoEAjEoMCYw # DAYKKwYBBAGEWQoDAqAKMAgCAQACAwehIKEKMAgCAQACAwGGoDANBgkqhkiG9w0B # AQUFAAOBgQBJDIkRH8Kl7CcEeOMDJXnQo4FiGjpaTb0OS5//2FoCkr8aF4/1sw4s # UU7uy07eZ5ImoRIx8mQnZuEFLJFK1MDq8miwxKIl/xwzq5ro/nZvI7p5oVvKKHl0 # 4QmvKUo19MCY8kUXn1AYu02SP+bsU5FmmruPXGaue4tBlQnQvKJyJjGCBA0wggQJ # AgEBMIGTMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYD # VQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAk # BgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAABw4tv00i/ # DpFdAAEAAAHDMA0GCWCGSAFlAwQCAQUAoIIBSjAaBgkqhkiG9w0BCQMxDQYLKoZI # hvcNAQkQAQQwLwYJKoZIhvcNAQkEMSIEIHeeu+glKNm3j8cVMLQW1o+YuMJY6WxL # HmLi0zDraAayMIH6BgsqhkiG9w0BCRACLzGB6jCB5zCB5DCBvQQg0vtTm2+SSerh # 1KiAkwrJTALxTfJotlPcDZ2ZSn78KkkwgZgwgYCkfjB8MQswCQYDVQQGEwJVUzET # MBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMV # TWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1T # dGFtcCBQQ0EgMjAxMAITMwAAAcOLb9NIvw6RXQABAAABwzAiBCCC0PTbYnpRWOrV # lEja79MS9dup6dumBTOU7Rg76Flf5DANBgkqhkiG9w0BAQsFAASCAgCTuyKADaiZ # Z+TekIiDi6QDDfsv3CadRG8PPKFzcBVAcfbeoyBMYY3+mzLs/L6lhXw75j9GRfPj # hUgOrxYA3xFKLz3jWeBPMgHHbJ0dQJ2Q1/XPQtWoZs8N5Teh0A2ku/zNmbZfkay2 # /eyYfby2tUBaKCDp4w9awFCpO2X4Lk3hts0qVRoQL/o8HvELRXneqM9SsuWU2M1x # J69cDU0Q4QsjEAbKAmlEIWpC7ztlOVl1dEJhSSfrP011Hbh/3bJvnOV4lMeR4kMt # XDXQVr2LjDA/lt4RhCRjy5POtKFqdvCSBhaXZN94VZSXJ8dBLN+1sHBHWYA+fdgX # JB8dknNpsmlYIKck5eoupBIx5YFq+z/+zQ+lZjq838qqs5s6OYLNSKoxwb43zvj9 # lcsH6FGn3Szoy/sEAqsF9AdLpgmlbx2rzB6WfNDf5cV3cyU1tbaDNDTn/ECZ1sFN # texYL0O7Pc82Njclgfvo4BlC6ETCnDKMqnqNO0zwF38Q4DpkC3JoYTycvwn+Xit8 # qICpj64XtAsG+nFBHKVM9GMxRR7/MtDlNhKJpVc/Ri5AMjC2Adyv2IsmLkRd84Um # 7SxTzeA6KYCuR7Ezm9coSCAfN+PeS4bKez3UX8fT9iSpbeyrAaK0DGSP9Zr+BEzx # m5JpG7/PvlCOhZMEXkr0PFQGnUZKmINUIQ== # SIG # End signature block |