icinga-powershell-cluster

1.0.0

provider/helper/Get-IcingaClusterResource.psm1

                                <#

.SYNOPSIS

    Fetch all information on the targeted Server regarding Cluster Resources.

    Returns a hashtable with all required data for monitoring the health of Cluster Resources.

.ROLE

    ### WMI Permissions

    * Root\MSCluster

    * Root\Cimv2

    ### Cluster Permissions

    * Read-Only access on cluster ressources

.OUTPUTS

    System.Hashtable

.LINK

    https://github.com/Icinga/icinga-powershell-cluster

#>

function Get-IcingaClusterResource()

{

    # Check whether or not MSCluster_Resource exists on the targeted system

    $TestClasses  = Test-IcingaWindowsInformation -ClassName MSCluster_Resource -NameSpace 'Root\MSCluster';

    # Check for error Ids with Binary operators

    $BitWiseCheck = Test-IcingaBinaryOperator -Value $TestClasses -Compare NotSpecified, PermissionError -Namespace $TestIcingaWindowsInfoEnums.TestIcingaWindowsInfo;

    # Get the lasth throw exception id

    $ExceptionId  = Get-IcingaLastExceptionId;

    # We return a empty hashtable if for some reason no data from the WMI classes can be retrieved

    if ($BitWiseCheck) {

        return @{'Exception' = $TestClasses; };

    }

    if ($ClusterProviderEnums.ClusterExceptionIds.ContainsKey($ExceptionId)) {

        return @{'Exception' = $ExceptionId; };

    }

    # Throw an exception when the exception ID is not OK, NotSpecified and PermissionError

    if ($TestClasses -ne $TestIcingaWindowsInfoEnums.TestIcingaWindowsInfo.Ok) {

        Exit-IcingaThrowException `

            -CustomMessage ($TestIcingaWindowsInfoEnums.TestIcingaWindowsInfoExceptionType[[int]$TestClasses]) `

            -InputString ($TestIcingaWindowsInfoEnums.TestIcingaWindowsInfoText[[int]$TestClasses]) `

            -ExceptionType Custom `

            -Force;

    }

    # Get some basic infos to cluster resources

    $ClusterResources = Get-IcingaWindowsInformation -ClassName MSCluster_Resource -Namespace 'Root\MSCluster';

    $ClusterData      = @{ };

    foreach ($resource in $ClusterResources) {

        $details = @{

            'Caption'                   = $resource.Caption;

            'Description'               = $resource.Description;

            'InstallDate'               = $resource.InstallDate;

            'Name'                      = $resource.Name;

            'Status'                    = $resource.Status;

            'Characteristics'           = $resource.Characteristics;

            'Flags'                     = $resource.Flags;

            'CoreResource'              = $resource.CoreResource;

            'CryptoCheckpoints'         = $resource.CryptoCheckpoints;

            'DeadlockTimeout'           = $resource.DeadlockTimeout;

            'DeleteRequiresAllNodes'    = $resource.DeleteRequiresAllNodes;

            'EmbeddedFailureAction'     = $resource.EmbeddedFailureAction;

            'Id'                        = $resource.Id;

            'IsAlivePollInterval'       = $resource.IsAlivePollInterval;

            'IsClusterSharedVolume'     = $resource.IsClusterSharedVolume;

            'LastOperationStatusCode'   = $resource.LastOperationStatusCode;

            'LocalQuorumCapable'        = $resource.LocalQuorumCapable;

            'LooksAlivePollInterval'    = $resource.LooksAlivePollInterval;

            'MonitorProcessId'          = $resource.MonitorProcessId;

            'OwnerGroup'                = $resource.OwnerGroup;

            'OwnerNode'                 = $resource.OwnerNode;

            'PendingTimeout'            = $resource.PendingTimeout;

            'PersistentState'           = $resource.PersistentState;

            'PrivateProperties'         = $resource.PrivateProperties;

            'QuorumCapable'             = $resource.QuorumCapable;

            'RegistryCheckpoints'       = $resource.RegistryCheckpoints;

            'RequiredDependencyClasses' = $resource.RequiredDependencyClasses;

            'RequiredDependencyTypes'   = $resource.RequiredDependencyTypes;

            'ResourceClass'             = $resource.ResourceClass;

            'ResourceSpecificData1'     = $resource.ResourceSpecificData1;

            'ResourceSpecificData2'     = $resource.ResourceSpecificData2;

            'ResourceSpecificStatus'    = $resource.ResourceSpecificStatus;

            'RestartAction'             = $resource.RestartAction;

            'RestartDelay'              = $resource.RestartDelay;

            'RestartPeriod'             = $resource.RestartPeriod;

            'RestartThreshold'          = $resource.RestartThreshold;

            'RetryPeriodOnFailure'      = $resource.RetryPeriodOnFailure;

            'SeparateMonitor'           = $resource.SeparateMonitor;

            'State'                     = $resource.State;

            'StatusInformation'         = $resource.StatusInformation;

            'Subclass'                  = $resource.Subclass;

            'Type'                      = $resource.Type;

            'PSComputerName'            = $resource.PSComputerName;

        };

        $ClusterData.Add($resource.Name, $details);

    }

    return $ClusterData;

}