Private/Test-NetScaler.ps1
|
function Test-NetScaler { <# .SYNOPSIS Tests Citrix NetScaler. .DESCRIPTION Logs into a NetScaler ADC and creates a global variable called $NSSession to be used to invoke NITRO Commands, then tests the vServer Status. Currently Testing NetScaler ADC Status vServer Health Status (UP/DOWN/DEGRADED) .PARAMETER NetScalers Comma Delimited List of NetScalers .PARAMETER UserName Username to use to check the NetScaler .PARAMETER Password Password to use to log into the NetScaler .NOTES Current Version: 1.0 Creation Date: 12/03/2018 .CHANGE CONTROL Name Version Date Change Detail David Brett 1.0 12/03/2018 Function Creation Ryan Butler 1.1 27/30/2018 Change in variable scope for nsession David Brett 1.2 29/03/2018 Return Object David Brett 1.3 14/06/2018 Edited function to work with Adams new Test-Series Modules Adam Yarborough 1.4 20/06/2018 Changes just for Influx David Brett 1.5 26/06/2018 Removed Old Code and Cleaned up Function .EXAMPLE None Required #> [CmdletBinding()] Param ( [parameter(Mandatory = $true, ValueFromPipeline = $true)]$NetScaler, [parameter(Mandatory = $true, ValueFromPipeline = $true)]$UserName, [parameter(Mandatory = $true, ValueFromPipeline = $true)][System.Security.SecureString]$SecurePassword ) #Create empty array $Results = @() # Run NetScaler Tests Write-Verbose "Testing NetScaler Virtual Servers" # If NetScaler up log Log in and grab vServer Status $nsession = Connect-NetScaler -NSIP $NetScaler -username $UserName -nspassword $SecurePassword if ($false -eq $nsession) { write-warning "Could not log into the NetScaler" return $false # This is so that Test-Series will handle appropriately. } else { Write-Verbose "NetScaler - $NetScaler Logged In: NSession is $nsession" $vServers = Get-vServer -nsip $NetScaler -nssession $nsession if ($false -eq $vServers) { $Errors = "Unable to retrieve vServers from Netscaler Gateway $Netscaler" $Results += [PSCustomObject]@{ Errors = $Errors } } else { # Loop Through vServers and check Status Write-Verbose "Looping through vServers to check status" foreach ($vServer in $vServers.lbvserver) { $Errors = @() $vServerName = $vServer.name if ($vServer.State -eq "UP") { Write-Verbose "$vServerName is up" if ($vserver.vslbhealth -ne 100) { Write-Verbose "$vServerName is Degraded" $Errors += "$vServerName is Degraded" } } else { Write-Verbose "$vServerName is Down" $Errors += "$vServerName is Down" } $Results += [PSCustomObject]@{ 'vServerName' = $vServerName 'vServerHealth' = [int]$vServer.vslbhealth 'Errors' = $Errors } } } # Disconnect from the NetScaler Disconnect-NetScaler -NSIP $NetScaler -nssession $nsession #Returns test results return $Results } } |