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 # MIIoKgYJKoZIhvcNAQcCoIIoGzCCKBcCAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDIyAdWowAswtEu # WXrsIWt6JPDuOUfrSbPnDHzTu6gSQ6CCDXYwggX0MIID3KADAgECAhMzAAADTrU8 # esGEb+srAAAAAANOMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p # bmcgUENBIDIwMTEwHhcNMjMwMzE2MTg0MzI5WhcNMjQwMzE0MTg0MzI5WjB0MQsw # CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u # ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB # AQDdCKiNI6IBFWuvJUmf6WdOJqZmIwYs5G7AJD5UbcL6tsC+EBPDbr36pFGo1bsU # p53nRyFYnncoMg8FK0d8jLlw0lgexDDr7gicf2zOBFWqfv/nSLwzJFNP5W03DF/1 # 1oZ12rSFqGlm+O46cRjTDFBpMRCZZGddZlRBjivby0eI1VgTD1TvAdfBYQe82fhm # WQkYR/lWmAK+vW/1+bO7jHaxXTNCxLIBW07F8PBjUcwFxxyfbe2mHB4h1L4U0Ofa # +HX/aREQ7SqYZz59sXM2ySOfvYyIjnqSO80NGBaz5DvzIG88J0+BNhOu2jl6Dfcq # jYQs1H/PMSQIK6E7lXDXSpXzAgMBAAGjggFzMIIBbzAfBgNVHSUEGDAWBgorBgEE # AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUnMc7Zn/ukKBsBiWkwdNfsN5pdwAw # RQYDVR0RBD4wPKQ6MDgxHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEW # MBQGA1UEBRMNMjMwMDEyKzUwMDUxNjAfBgNVHSMEGDAWgBRIbmTlUAXTgqoXNzci # tW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8vd3d3Lm1pY3Jvc29mdC5j # b20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3JsMGEG # CCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDovL3d3dy5taWNyb3NvZnQu # Y29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3J0 # MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIBAD21v9pHoLdBSNlFAjmk # mx4XxOZAPsVxxXbDyQv1+kGDe9XpgBnT1lXnx7JDpFMKBwAyIwdInmvhK9pGBa31 # TyeL3p7R2s0L8SABPPRJHAEk4NHpBXxHjm4TKjezAbSqqbgsy10Y7KApy+9UrKa2 # kGmsuASsk95PVm5vem7OmTs42vm0BJUU+JPQLg8Y/sdj3TtSfLYYZAaJwTAIgi7d # hzn5hatLo7Dhz+4T+MrFd+6LUa2U3zr97QwzDthx+RP9/RZnur4inzSQsG5DCVIM # pA1l2NWEA3KAca0tI2l6hQNYsaKL1kefdfHCrPxEry8onJjyGGv9YKoLv6AOO7Oh # JEmbQlz/xksYG2N/JSOJ+QqYpGTEuYFYVWain7He6jgb41JbpOGKDdE/b+V2q/gX # UgFe2gdwTpCDsvh8SMRoq1/BNXcr7iTAU38Vgr83iVtPYmFhZOVM0ULp/kKTVoir # IpP2KCxT4OekOctt8grYnhJ16QMjmMv5o53hjNFXOxigkQWYzUO+6w50g0FAeFa8 # 5ugCCB6lXEk21FFB1FdIHpjSQf+LP/W2OV/HfhC3uTPgKbRtXo83TZYEudooyZ/A # Vu08sibZ3MkGOJORLERNwKm2G7oqdOv4Qj8Z0JrGgMzj46NFKAxkLSpE5oHQYP1H # tPx1lPfD7iNSbJsP6LiUHXH1MIIHejCCBWKgAwIBAgIKYQ6Q0gAAAAAAAzANBgkq # 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 # /Xmfwb1tbWrJUnMTDXpQzTGCGgowghoGAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw # EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN # aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp # Z25pbmcgUENBIDIwMTECEzMAAANOtTx6wYRv6ysAAAAAA04wDQYJYIZIAWUDBAIB # BQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO # MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIMB8zrgpN6O8AYtZwz61CDLP # QOk4nTqpYhI4AY6m+izaMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8A # cwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEB # BQAEggEAnINmBBhUKVOqtQKmEzrYpp5f8yqr2VhJdfGc6dd525gblq947DHqrXa/ # I015zGnv4BmhdXsUXOYZik+eGSfD2kumutsqRK8epmBDCfNH29gzufPmVzztGrtG # 7kgz7eM8ZGn6sE4XZFdlNZYpLC/TivRCzqLj+bbsWrwjyVR9b/3A7QJarwRUto9j # AQmuiOdv9sWry4x6MaXgcg6KBwGMu7k/wIpBMacqF4Y6iGQurq1JTHHznzDBdt0A # uB6zgLQA4BJOQNfzUh19ZmyoNlE9qeB7ORaYjgeo4Z7AM/9Nz1LySjzvXG0r/Vnd # oQNImbzRSla/tbyNFmpm/fN6WuoLX6GCF5QwgheQBgorBgEEAYI3AwMBMYIXgDCC # F3wGCSqGSIb3DQEHAqCCF20wghdpAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFSBgsq # hkiG9w0BCRABBKCCAUEEggE9MIIBOQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFl # AwQCAQUABCDVh0+Id0lTCUbqc1YB0c75fyfK480RhoZAbm5D9hWa5QIGZSisyxDA # GBMyMDIzMTAxOTIzNTkxNy40NTFaMASAAgH0oIHRpIHOMIHLMQswCQYDVQQGEwJV # UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE # ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1l # cmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046RTAwMi0w # NUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2Wg # ghHqMIIHIDCCBQigAwIBAgITMwAAAdmcXAWSsINrPgABAAAB2TANBgkqhkiG9w0B # AQsFADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE # BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYD # VQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDAeFw0yMzA2MDExODMy # NThaFw0yNDAyMDExODMyNThaMIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2Fz # aGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENv # cnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25z # MScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046RTAwMi0wNUUwLUQ5NDcxJTAjBgNV # BAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2UwggIiMA0GCSqGSIb3DQEB # AQUAA4ICDwAwggIKAoICAQDV6SDN1rgY2305yLdCdUNvHCEE4Z0ucD6CKvL5lA7H # M81SMkW36RU77UaBL9PScviqfVzE2r2pRbRMtDBMwEx1iaizV2EZsNGGuzeR3XNY # ObQvJVLaCiBktAZdq75BNFIil+SfdpXgKzVQZiDBJDN50WCADNrrb48Z4Z7/Kvyz # aD4Gb+aZeCioB2Gg1m53d+6pUTBc3WO5xHZi/rrI/XdnhiE6/bspjpU5aufClIDx # 0QDq1QRw04adrKhcDWyGL3SaBp/hjN+4JJU7KzvsKWZVdTuXPojnaTwWcHdEGfzx # iaF30zd8SY4YRUcMGPOQORH1IPwkwwlqQkc0HBkJCQziaXY/IpgMRw/XP4Uv+JBJ # 8RZGKZN1zRPWT9d5vHGUSmX3m77RKoCfkgSJifIiQi6Fc0OYKS6gZOA7nd4t+liA # rr9niqeC/UcNOuVrcVC4CbkwfJ2eHkaWh18sUt3UD8QHYLQwn95P+Hm8PZJigr1S # RLcsm8pOPee7PBbndI/VeKJsmQdjek2aFO9VGnUtzDDBowlhXshswZMMkLJ/4jUz # QmUBfm+JAH1516E+G02wS7NgzMwmpHWCmAaFdd7DyJIqGa6bcZrR7QALdkwIhVQD # gzZAuNxqwvh4Ia4ZI5Voyj4b7zWAhmurpwpMpijz+ieeWwf6ZdmysRjR/yZ6UXmG # awIDAQABo4IBSTCCAUUwHQYDVR0OBBYEFBw6wSlTZ6gFXl05w/s3Ga1f51wnMB8G # A1UdIwQYMBaAFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMF8GA1UdHwRYMFYwVKBSoFCG # Tmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY3Jvc29mdCUy # MFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNybDBsBggrBgEFBQcBAQRgMF4w # XAYIKwYBBQUHMAKGUGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2Vy # dHMvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3J0MAwG # A1UdEwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYBBQUHAwgwDgYDVR0PAQH/BAQD # AgeAMA0GCSqGSIb3DQEBCwUAA4ICAQAqNtVYLO61TMuIanC7clt0i+XRRbHwnwNo # 05Q3s4ppFtd4nCmB/TJPDJ6uvEryxs0vw5Y+jQwUiKnhl2VGGwIq0pWDIuaW4ppM # V1pYQfJ6dtBGkRiTP1eKVvARYZMRaITe9ZhwJJnYP83pMxHCxaEsZC4ilY3/55dq # d4ZXTCz/cpG5anmDartnWmgysygNstTwbWJJRj85gYRkjxi/nxKAiEFxl6GfkcnX # Vy8DRFQj1d3AiqsePoeIzxu1iuAJRwDrfe4NnKHqoTgWsv7eCWJnWjWWRt7RRGrp # vzLQo/BxUb8i49UwRg9G5bxpd5Su1b224Gv6G1HRU+qJHB1zoe41D2r/ic2BPous # V9neYK5qI5PHLshAn6YTQllbV9pCbOUvZO0dtdwp5HH2fw6ofJNwKcPElaqkEcxv # rhhRWqwNgaEVTyIV4jMc8jPbx2Nh9zAztnb9NfnDFOE+/gF8cZqTa/T65TGNP3uM # iP3gr8nIXQ2IRwMVUoLmGu2qfmhDoews3dcvk6s1aA6mXHw+MANEIDKKjw3i2G6J # tZkEemu1OXtskg/tGnfywaMgq5CauU9b6enTtA+UE+GKnmiQW6YUHPhBI0L2QG76 # TRBre5PpNVHiyc/01bjUEMpeaB+InAH4nDxYXx18wbJE+e/IbMv0147EFL792dEL # F0XwqqcU0TCCB3EwggVZoAMCAQICEzMAAAAVxedrngKbSZkAAAAAABUwDQYJKoZI # hvcNAQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw # DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x # MjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAy # MDEwMB4XDTIxMDkzMDE4MjIyNVoXDTMwMDkzMDE4MzIyNVowfDELMAkGA1UEBhMC # VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV # BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRp # bWUtU3RhbXAgUENBIDIwMTAwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoIC # AQDk4aZM57RyIQt5osvXJHm9DtWC0/3unAcH0qlsTnXIyjVX9gF/bErg4r25Phdg # M/9cT8dm95VTcVrifkpa/rg2Z4VGIwy1jRPPdzLAEBjoYH1qUoNEt6aORmsHFPPF # dvWGUNzBRMhxXFExN6AKOG6N7dcP2CZTfDlhAnrEqv1yaa8dq6z2Nr41JmTamDu6 # GnszrYBbfowQHJ1S/rboYiXcag/PXfT+jlPP1uyFVk3v3byNpOORj7I5LFGc6XBp # Dco2LXCOMcg1KL3jtIckw+DJj361VI/c+gVVmG1oO5pGve2krnopN6zL64NF50Zu # yjLVwIYwXE8s4mKyzbnijYjklqwBSru+cakXW2dg3viSkR4dPf0gz3N9QZpGdc3E # XzTdEonW/aUgfX782Z5F37ZyL9t9X4C626p+Nuw2TPYrbqgSUei/BQOj0XOmTTd0 # lBw0gg/wEPK3Rxjtp+iZfD9M269ewvPV2HM9Q07BMzlMjgK8QmguEOqEUUbi0b1q # GFphAXPKZ6Je1yh2AuIzGHLXpyDwwvoSCtdjbwzJNmSLW6CmgyFdXzB0kZSU2LlQ # +QuJYfM2BjUYhEfb3BvR/bLUHMVr9lxSUV0S2yW6r1AFemzFER1y7435UsSFF5PA # PBXbGjfHCBUYP3irRbb1Hode2o+eFnJpxq57t7c+auIurQIDAQABo4IB3TCCAdkw # EgYJKwYBBAGCNxUBBAUCAwEAATAjBgkrBgEEAYI3FQIEFgQUKqdS/mTEmr6CkTxG # NSnPEP8vBO4wHQYDVR0OBBYEFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMFwGA1UdIARV # MFMwUQYMKwYBBAGCN0yDfQEBMEEwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWlj # cm9zb2Z0LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0b3J5Lmh0bTATBgNVHSUEDDAK # BggrBgEFBQcDCDAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMC # AYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvX # zpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20v # cGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYI # KwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5j # b20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNydDANBgkqhkiG # 9w0BAQsFAAOCAgEAnVV9/Cqt4SwfZwExJFvhnnJL/Klv6lwUtj5OR2R4sQaTlz0x # M7U518JxNj/aZGx80HU5bbsPMeTCj/ts0aGUGCLu6WZnOlNN3Zi6th542DYunKmC # VgADsAW+iehp4LoJ7nvfam++Kctu2D9IdQHZGN5tggz1bSNU5HhTdSRXud2f8449 # xvNo32X2pFaq95W2KFUn0CS9QKC/GbYSEhFdPSfgQJY4rPf5KYnDvBewVIVCs/wM # nosZiefwC2qBwoEZQhlSdYo2wh3DYXMuLGt7bj8sCXgU6ZGyqVvfSaN0DLzskYDS # PeZKPmY7T7uG+jIa2Zb0j/aRAfbOxnT99kxybxCrdTDFNLB62FD+CljdQDzHVG2d # Y3RILLFORy3BFARxv2T5JL5zbcqOCb2zAVdJVGTZc9d/HltEAY5aGZFrDZ+kKNxn # GSgkujhLmm77IVRrakURR6nxt67I6IleT53S0Ex2tVdUCbFpAUR+fKFhbHP+Crvs # QWY9af3LwUFJfn6Tvsv4O+S3Fb+0zj6lMVGEvL8CwYKiexcdFYmNcP7ntdAoGokL # jzbaukz5m/8K6TT4JDVnK+ANuOaMmdbhIurwJ0I9JZTmdHRbatGePu1+oDEzfbzL # 6Xu/OHBE0ZDxyKs6ijoIYn/ZcGNTTY3ugm2lBRDBcQZqELQdVTNYs6FwZvKhggNN # MIICNQIBATCB+aGB0aSBzjCByzELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp # bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw # b3JhdGlvbjElMCMGA1UECxMcTWljcm9zb2Z0IEFtZXJpY2EgT3BlcmF0aW9uczEn # MCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOkUwMDItMDVFMC1EOTQ3MSUwIwYDVQQD # ExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNloiMKAQEwBwYFKw4DAhoDFQDi # HEW6Ca3n5BgZV/tQ/fCR09Tf96CBgzCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1w # IFBDQSAyMDEwMA0GCSqGSIb3DQEBCwUAAgUA6Nu8yDAiGA8yMDIzMTAxOTE0MzM0 # NFoYDzIwMjMxMDIwMTQzMzQ0WjB0MDoGCisGAQQBhFkKBAExLDAqMAoCBQDo27zI # AgEAMAcCAQACAgXGMAcCAQACAhJhMAoCBQDo3Q5IAgEAMDYGCisGAQQBhFkKBAIx # KDAmMAwGCisGAQQBhFkKAwKgCjAIAgEAAgMHoSChCjAIAgEAAgMBhqAwDQYJKoZI # hvcNAQELBQADggEBAAt0U/jnaKIacPx6hvWybn832T5HizIR0Thyp+7muNfO/0h6 # /aVThHRvAuUgkX2iUNPll0Nj9uxiVf1dR99RHBhWuKl3tYclbqClVOGRdTi2q1tF # ToogrjKCKzpa/l6+kmUme9bmDtbej/esIg6qM8mb1cr5kSzfWahsFB+Q+QMH4txv # WJ/+bMhu/BiSA93cXU5aqv6UkzYREC3VBwLclj65juLICVAz57CJN13FISXGjNpM # 8zu1QHo2qgDoU6HXw88D4PHmVOh7KyighSmykXpfilQOJjSZ4k1FyWpJcAeJeIYN # vxlf5e48XwnicZYN3hfaA3yq185/PmQQHrawG0sxggQNMIIECQIBATCBkzB8MQsw # CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u # ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNy # b3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAdmcXAWSsINrPgABAAAB2TAN # BglghkgBZQMEAgEFAKCCAUowGgYJKoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEEMC8G # CSqGSIb3DQEJBDEiBCBlf0vZlzq85zj96oEaEqBEmaCn449Nmi4bWJYsJWLOYDCB # +gYLKoZIhvcNAQkQAi8xgeowgecwgeQwgb0EIJ+gFbItOm/UMDAnETzbJe0u0DWd # 2Mgpgb0ScbQgB3nzMIGYMIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldh # c2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBD # b3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIw # MTACEzMAAAHZnFwFkrCDaz4AAQAAAdkwIgQgCcREdV95e7PMOKrIr6Feca5I3oxx # fQltVFJrkQfe6OgwDQYJKoZIhvcNAQELBQAEggIAoQfdA4vSaadEQTmohFW4orgO # /oTwNieh02thpXERzaIvYgLvKjIbfSJuzKsLDYKH0Ynw91DqxAKZleaFEF7/2S2P # Dg2U2rC/iwrJb8On0n/vwpxb97ngsnHPgYt51REamrr/gh2yIFWko5yxxciO50BA # 0sLzDo6gEsFnfQvD+aEU+z28g8vfQdLlNNnW2jfg086vxChT7DyFxI8G19Nw70Qm # 50Y/E7w8mAQUkQCGWUrtLaG1CKhSj/qzidPEhkBw+fiBTqOwxjQXS4hREnY6dx7Z # bPb8n4qBpLLBT2HbzXII+jbM6mcuzDPk+EI+hD8Gbr9Jsg9TiiawKpEcPpY3ku6h # 5p+Y+jtzs2jEFzDFQO8uNmlWQ8tgg5TjGDLYLaFLbj0maZhMVQu3bytcv1p1Czfk # ttRWXOQ+t+6SYi756pDHTMzcrrOWsHtFrmXJJVC1UPrRhEnQbfVk4AhUGKJGqA27 # yLW3RNLri4JL8AH7ftd203XGpMItWG+94/OYmuIfz0qtM2xRsRXN6FvMUrz8B4gK # qeCqgl3o4fGXxqfGF0xuFtzip33ehuJXFAhQ2341eS4RmRnEowydiXOq8j39ZsUL # 08mFZj3Wf56u6wK9Marzzk0fZFA0CxsuKI1FmjThd2vYBrf7zFwDdAOw77mdwDeB # Z0LlajAPo4DzDITS9pc= # SIG # End signature block |