msisaserver.ps1 - powershell script by ActiveXperts Software

msisaserver.ps1 checks whether MS ISA Server is running; it checks services, processes and performance counters.

Use msisaserver.ps1 directly from ActiveXperts Network Monitor; in the Manager's 'Monitor' menu, select 'New Check (Script)' and select msisaserver.ps1. Configure the required parameter, or press 'Load a working sample'.

In ActiveXperts Network Monitor, Administrators can use three different scripting languages: Powershell, VBScript and SSH.

---

msisaserver.ps1 script code

#################################################################################
# ActiveXperts Network Monitor PowerShell script, © ActiveXperts Software B.V.
# For more information about ActiveXperts Network Monitor, visit the ActiveXperts 
# Network Monitor web site at http://www.activexperts.com
#################################################################################
# Script:
#     MsIsaServer.ps1
# Description: 
#     Checks if ISA Server is running; it checks the ISA services    
# Declare Parameters:
#     1) strHost (string) - Hostname or IP address of the server you want to check
#     2) strVersion (String) - ISA Server version
#     3) strAltCredentials (string, optional) - Specify an empty string to use Network Monitor service credentials.
#         To use alternate credentials, enter a server that is defined in Server Credentials table.
#         (To define Server Credentials, choose Tools->Options->Server Credentials)
# Usage:
#     .\MsIsaServer.ps1 '<Hostname | IP>' '<Version>' '[alt-credentials]'
# Sample:
#     .\MsIsaServer.ps1 'localhost' '2006C'
#################################################################################

# -- Declare Parameters
param ( [string]$strHost = '', [string]$strVersion = '', [string]$strAltCredentials = '' )

# -- Use _activexperts.ps1 with common functions 
. 'C:\Program Files\ActiveXperts\Network Monitor\Scripts\Monitor (ps1)\_activexperts.ps1' 


#################################################################################
# // --- Private Functions section ---
#################################################################################

function getSoftwareInfo( $strVersion, [ref]$lstServices, [ref]$lstProcesses, [ref]$lstPerfCounters )
{
  # Retrieve services, processes and counters associated to the specific version of the software. Entries that start 
  # with '!' are optional services/processes/counters and are not checked by default. Remove '!' mark to enable monitoring those items.
  switch( $strVersion )
  {
    '2006C'
    {
      $lstServices.value = @( @( 'isactrl', 'Microsoft ISA Server Control' ), 
                              @( 'isasched', 'Microsoft ISA Server Job Scheduler' ), 
                              @( 'ISASTG', 'Microsoft ISA Server Storage' ),
                              @( '', '' ) )
      $lstProcesses.value = @( 'mspadmin.exe', 'W3Prefch.exe', 'isastg.exe', '' )
      $lstPerfCounters.value = @( @( 'Memory', '', 'Available Bytes', '-gt 104857600' ), 
                                  @( 'Processor', '_TOTAL', '% Processor Time', '-lt 90' ),
                                  @( '', '', '', '' ) )
      return $AXSUCCESS
    } 
    
    '2006F'
    {
      $lstServices.value = @( @( 'isactrl', 'Microsoft ISA Server Control' ), 
                              @( 'isasched', 'Microsoft ISA Server Job Scheduler' ), 
                              @( 'ISASTG', 'Microsoft ISA Server Storage' ), 
                              @( 'fwsrv', 'Microsoft Firewall' ),
                              @( '', '' ) )
      $lstProcesses.value = @( 'mspadmin.exe', 'W3Prefch.exe', 'isastg.exe', 'wspsrv.exe', '' )
      $lstPerfCounters.value = @( @( 'Memory', '', 'Available Bytes', '-gt 104857600' ), 
                                  @( 'Processor', '_TOTAL', '% Processor Time', '-lt 90' ),
                                  @( '', '', '', '' ) )
      return $AXSUCCESS
    }
     
    '2006CF'
    {
      $lstServices.value = @( @( 'isactrl', 'Microsoft ISA Server Control' ), 
                              @( 'isasched', 'Microsoft ISA Server Job Scheduler' ), 
                              @( 'ISASTG', 'Microsoft ISA Server Storage' ), 
                              @( 'fwsrv', 'Microsoft Firewall' ) )
      $lstProcesses.value = @( 'mspadmin.exe', 'W3Prefch.exe', 'isastg.exe', 'wspsrv.exe', '' )
      $lstPerfCounters.value = @( @( 'Memory', '', 'Available Bytes', '-gt 104857600' ), 
                                  @( 'Processor', '_TOTAL', '% Processor Time', '-lt 90' ),
                                  @( '', '', '', '' ) )
      return $AXSUCCESS
    }
    
    '2004C'
    {
      $lstServices.value = @( @( 'isactrl', 'Microsoft ISA Server Control' ),
                              @( '', '' ) )
      $lstProcesses.value = @( 'mspadmin.exe', '' )
      $lstPerfCounters.value = @( , @( '', '', '', '' ) )
      return $AXSUCCESS
    }
    
    '2004F'
    {
      $lstServices.value = @( @( 'isactrl', 'Microsoft ISA Server Control' ),
                              @( '', '' ) )
      $lstProcesses.value = @( 'mspadmin.exe', 'wspsrv.exe', '' )
      $lstPerfCounters.value = @( , @( '', '', '', '' ) )   
      return $AXSUCCESS
    }
    
    '2004CF'
    {
      $lstServices.value = @( @( 'isactrl', 'Microsoft ISA Server Control' ), 
                              @( 'fwsrv', 'Microsoft Firewall' )
                              @( '', '' ) )
      $lstProcesses.value = @( 'mspadmin.exe', 'wspsrv.exe', '' )
      $lstPerfCounters.value = @( , @( '', '', '', '' ) )     
      return $AXSUCCESS
    }
      
    '2000C'
    {
      $lstServices.value = @( @( 'isactrl', 'Microsoft ISA Server Control' ), 
                              @( 'w3proxy', 'Microsoft Web Proxy' ), 
                              @( 'w3schdwn', 'Microsoft Scheduled Cache Content Download' ), 
                              @( '!Gksvc', 'Microsoft Gatekeeper' ) )
      $lstProcesses.value = @( 'mspadmin.exe', 'w3proxy.exe', 'w3prefch.exe', '' )
      $lstPerfCounters.value = @( , ( '', '', '', '' ) )   
      return $AXSUCCESS
    }
    
    '2000F'
    {
      $lstServices.value = @( @( 'isactrl', 'Microsoft ISA Server Control' ), 
                              @( 'w3proxy', 'Microsoft Web Proxy' ), 
                              @( 'w3schdwn', 'Microsoft Scheduled Cache Content Download' ), 
                              @( 'Fwsrv', 'Microsoft Firewall' ), 
                              @( '!Gksvc', 'Microsoft Gatekeeper' )
                              @( '', '' ) )
      $lstProcesses.value = @( 'mspadmin.exe', 'w3proxy.exe', 'w3prefch.exe', 'wspsrv.exe', '' )
      $lstPerfCounters.value = @( , @( '', '', '', '' ) )       
      return $AXSUCCESS
    }

    '2000CF'
    {
      $lstServices.value = @( @( 'isactrl', 'Microsoft ISA Server Control' ), 
                              @( 'w3proxy', 'Microsoft Web Proxy' ), 
                              @( 'w3schdwn', 'Microsoft Scheduled Cache Content Download' ), 
                              @( 'Fwsrv', 'Microsoft Firewall' ), 
                              @( '!Gksvc', 'Microsoft Gatekeeper' ),
                              @( '', '' ) )
      $lstProcesses.value = @( 'mspadmin.exe', 'w3proxy.exe', 'w3prefch.exe', 'wspsrv.exe', '' )
      $lstPerfCounters.value = @( , @( '', '', '', '' ) )       
      return $AXSUCCESS
    }      
    
    default
    {
      $lstServices.value = @( , @( '', '' ) )
      $lstProcesses.value = @( , '' )
      $lstPerfCounters.value = @( , @( '', '', '', '' ) )
      return $AXERROR
    }
  }
}


#################################################################################
# // --- Main script ---
#################################################################################

# -- Clear screen and clear error
cls
$Error.Clear()
  
# -- Validate parameters, return on parameter mismatch
if( $strHost -eq '' -or $strVesion -eq '' )
{
  $res = 'UNCERTAIN: Parameter error - Usage: .\MsIsaServer.ps1 "<Hostname | IP>" "<Version>" [alt-credentials]'
  echo $res
  exit
}

# Declare local variables by assigning an initial value to it
$lstServices = $null
$lstProcesses = $null
$lstPerfCounters = $null

$objAltCredentials = $null
$strExplanation = ''

# If alternate credentials are specified, retrieve the alternate login and password from the ActiveXperts global settings
if( $strAltCredentials -ne '' )
{
  # Get the Alternate Credentials object. Function "AxGetCredentials" is implemented in "activexperts.ps1"
  if( ( AxGetCredentials $strHost  $strAltCredentials ([ref]$objAltCredentials) ([ref]$strExplanation) ) -ne $AXSUCCESS )
  {
    echo $strExplanation
    exit
  }
}


# Retrieve product processes/services/performance-counters list
if( ( getSoftwareInfo $strVersion ([ref]$lstServices) ([ref]$lstProcesses) ([ref]$lstPerfCounters) ) -ne $AXSUCCESS )
{ 
  $res = 'ERROR: Version [' + $strVersion + '] is not supported.'
  echo $res
  exit
}

# -- Check services
if( ( AxCheckServices $strHost ([ref]$lstServices) $objAltCredentials ([ref]$strExplanation) ) -ne $AXSUCCESS )
{
  echo $strExplanation
  exit
}

# -- Check processes
if( ( AxCheckProcesses $strHost ([ref]$lstProcesses) $objAltCredentials ([ref]$strExplanation) ) -ne $AXSUCCESS )
{
  echo $strExplanation
  exit
}

# -- Check performance counters
if( ( AxCheckPerfCounters $strHost ([ref]$lstPerfCounters) $objAltCredentials ([ref]$strExplanation) ) -ne $AXSUCCESS )
{
  echo $strExplanation
  exit
}

# -- Print script result
$res = 'SUCCESS: All services, processes and counters successfully checked'
echo $res
exit


#################################################################################
# // --- Catch script exceptions ---
#################################################################################

trap [Exception]
{
  $res = 'UNCERTAIN: ' + $_.Exception.Message
  echo $res
  exit
}