Home
  •  

AKN475265

Monitor_AKN475265 (UnitMonitor)

Lync server maintenance schedule may be running during non optimal times

Knowledge Base article:

External

http://go.microsoft.com/fwlink/?LinkId=279570

Element properties:

TargetMicrosoft.KnowledgeServices.Lync.2010.UserServicesConfig
Parent MonitorSystem.Health.ConfigurationState
CategoryAlert
EnabledTrue
Alert GenerateTrue
Alert SeverityWarning
Alert PriorityNormal
Alert Auto ResolveTrue
Monitor TypeMicrosoft.KnowledgeServices.Library.PowerShellMonitorEx
RemotableTrue
AccessibilityPublic
Alert Message
Lync server Maintenance schedule may be running during non optimal times
<Details>
<Content>Lync server maintenance may be scheduled to run during normal work hours or periods of high server load and could cause issues with presence information, managing meetings, or conferencing. You can use the Get-CsUserServicesConfiguration cmdlet to verify settings. See the following article for more information. </Content>
<CollectedInformation>
<Info>
<Name>MaintenanceTimeOfDay</Name>
<Value>{0}</Value>
</Info>
</CollectedInformation>
</Details>
RunAsDefault
CommentSupportTopic=TBD;VersionNumber=1.0.0.0;

Source Code:

<UnitMonitor ID="Monitor_AKN475265" Comment="SupportTopic=TBD;VersionNumber=1.0.0.0;" Accessibility="Public" Enabled="true" Target="MicrosoftKnowledgeServicesLyncLibrary!Microsoft.KnowledgeServices.Lync.2010.UserServicesConfig" ParentMonitorID="Health!System.Health.ConfigurationState" Remotable="true" Priority="Normal" TypeID="KnowledgeServicesLibrary!Microsoft.KnowledgeServices.Library.PowerShellMonitorEx" ConfirmDelivery="true">

  <Category>Alert</Category>

  <AlertSettings AlertMessage="MonitorMessage2c93b7936b38467f94b33d293dd7d2d6">

    <AlertOnState>Error</AlertOnState>

    <AutoResolve>true</AutoResolve>

    <AlertPriority>Normal</AlertPriority>

    <AlertSeverity>Warning</AlertSeverity>

    <AlertParameters>

      <AlertParameter1>$Target/Property[Type="MicrosoftKnowledgeServicesLyncLibrary!Microsoft.KnowledgeServices.Lync.2010.UserServicesConfig"]/MaintenanceTimeOfDay$</AlertParameter1>

    </AlertParameters>

  </AlertSettings>

  <OperationalStates>

    <OperationalState ID="Success" MonitorTypeStateID="Success" HealthState="Success"/>

    <OperationalState ID="Error" MonitorTypeStateID="Error" HealthState="Error"/>

  </OperationalStates>

  <Configuration>

    <ScriptName>AKN475265.ps1</ScriptName>

    <Parameters>

      <Parameter>

        <Name>MaintenanceTimeOfDay</Name>

        <Value>$Target/Property[Type="MicrosoftKnowledgeServicesLyncLibrary!Microsoft.KnowledgeServices.Lync.2010.UserServicesConfig"]/MaintenanceTimeOfDay$</Value>

      </Parameter>

    </Parameters>

    <ScriptBody><Script>PARAM($MaintenanceTimeOfDay)

[ScriptBlock]$mainScriptBlock = {





param($MaintenanceTimeOfDay)



$ErrorActionPreference = "Stop"



# Set up the arguments

$scriptargs = new-object psobject

$scriptargs | add-member NoteProperty "MaintenanceTimeOfDay" $MaintenanceTimeOfDay



# Set up the output

$global:scriptoutput = new-object psobject

$scriptoutput | add-member NoteProperty "HasIssue" $false

#----------------------------------------------------- 

# Environment 

#-----------------------------------------------------

$script:lyncPath = ""

if (Join-Path $Env:CommonProgramFiles "\Microsoft Lync Server 2013\Modules\Lync\Lync.psd1" | Test-Path)

{

    $script:lyncPath = Join-Path $Env:CommonProgramFiles "\Microsoft Lync Server 2013\Modules\Lync\Lync.psd1"

    $script:lyncPSVer = 2013

}

elseif (Join-Path $Env:CommonProgramFiles "\Microsoft Lync Server 2010\Modules\Lync\Lync.psd1" | Test-Path)

{

    $script:lyncPath = Join-Path $Env:CommonProgramFiles "\Microsoft Lync Server 2010\Modules\Lync\Lync.psd1"

    $script:lyncPSVer = 2010

}

$ScriptEnv = New-Object psobject

$ScriptEnv | Add-Member NoteProperty "RuntimeError" $false

$ScriptEnv | Add-Member NoteProperty "HasIssue" $false

$ScriptEnv | add-member ScriptMethod "ImportLyncPSModule" -value {

    $m = Get-Module -Name Lync

    if ($m -eq $null)

    {

       Import-Module $script:lyncPath -ErrorAction:SilentlyContinue

    }

}

$ScriptEnv | Add-Member ScriptMethod "IsCMSMaster" -Value {

    Try

    {

        $cmsStatus = Get-CsManagementStoreReplicationStatus -CentralManagementStoreStatus

        $agentHostFqdn = [System.Net.Dns]::GetHostByName([System.Net.Dns]::GetHostName()).HostName

        return $cmsStatus.ActiveMasterFqdn -ieq $agentHostFqdn

    }

    Catch [Microsoft.Rtc.Management.ADConnect.CannotGetDomainInfoException]

    {

    }

    Catch [Microsoft.Rtc.Common.Data.SqlConnectionException]

    {

    }

    Catch [System.Data.SqlClient.SqlException]

    {

    }

    return $false

}



#----------------------------------------------------- 

# MAIN CODE SECTION

#----------------------------------------------------- 



# Environment

$scriptenv = New-Object psobject

$scriptenv | Add-Member NoteProperty "RuntimeError" $false

$scriptenv | Add-Member NoteProperty "HasIssue" $false

$scriptenv | Add-Member NoteProperty "MaintenanceTimeOfDay" ""



# Check to see if Lync Maintenance Time is in the working hours.

function CheckMaintenanceTimeOfDay()

{

    $maintenanceDateTime = [System.DateTime]::Parse($scriptenv.MaintenanceTimeOfDay, [System.Globalization.CultureInfo]::InvariantCulture)

	$maintenanceHour = $maintenanceDateTime.Hour

    

    if (($maintenanceHour -ge 6) -and ($daysUntilExpiration -lt 18))

    {

        $scriptenv.HasIssue = $true

    }

}



# Main Function

function AdvisorRule($scriptargs, $scriptoutput)

{

    trap [Exception]

    {

        $scriptenv.RuntimeError = $true

        continue; 

    }



    $scriptoutput.HasIssue = $false

    $scriptenv.MaintenanceTimeOfDay = $scriptargs.MaintenanceTimeOfDay



    CheckMaintenanceTimeOfDay



    if($scriptenv.HasIssue -eq $true -and $scriptenv.RuntimeError -eq $false)

    {

        $scriptoutput.HasIssue = $true

    }

}

AdvisorRule $scriptargs $scriptoutput



}



Function Test-NeedPSRemoting

{

    $script:lyncPSVer = 0

    if (Join-Path $Env:CommonProgramFiles "\Microsoft Lync Server 2013\Modules\Lync\Lync.psd1" | Test-Path)

    {

        $script:lyncPSVer = 2013

    }

    elseif (Join-Path $Env:CommonProgramFiles "\Microsoft Lync Server 2010\Modules\Lync\Lync.psd1" | Test-Path)

    {

        $script:lyncPSVer = 2010

    }

    $PSCLRVersion = [System.String]::Format("{0}.{1}", $PSVersionTable.CLRVersion.Major, $PSVersionTable.CLRVersion.Minor)

    if (($PSCLRVersion -ieq "2.0") -and ($script:lyncPSVer -ieq 2013))

    {

        return $true

    }

    return $false

}



if ((Test-NeedPSRemoting))

{

    [bool]$script:psRemotingEnabled = $false

    # Enable PowerShell Remoting need elevated BUILTIN\Administrators privilege

    $winRMService = (Get-Service WinRM -ErrorAction SilentlyContinue)

    if ($winRMService -ne $null)

    {

        if ($winRMService.Status -ieq [System.ServiceProcess.ServiceControllerStatus]::Stopped)

        {

            $winRMService.Start()

            $winRMService.WaitForStatus([System.ServiceProcess.ServiceControllerStatus]::Running, [System.TimeSpan]::FromSeconds(15))

        }

        $psSessionConfiguration = (Get-PSSessionConfiguration -Name "Microsoft.PowerShell" -ErrorAction SilentlyContinue)

        if ($psSessionConfiguration.Permission.Contains("BUILTIN\Administrators AccessAllowed"))

        {

            $script:psRemotingEnabled = $true

        }

    }



    # Call remote PS session when PSRemoting is enabled.

    if ($script:psRemotingEnabled -eq $true)

    {

        $session = New-PSSession

        Invoke-Command -Session $session -ScriptBlock $mainScriptBlock -ArgumentList @($MaintenanceTimeOfDay)

        $global:scriptoutput = Invoke-Command -Session $session -ScriptBlock {$global:scriptoutput}

        Remove-PSSession -Session $session

    }

}

else

{

    &amp; $mainScriptBlock $MaintenanceTimeOfDay

}



# set the output

$mom = new-object -comobject "MOM.ScriptAPI"

$bag = $mom.CreatePropertyBag()



if ($scriptoutput.HasIssue -ne $null)

{

	$bag.AddValue("HasIssue", $scriptoutput.HasIssue)

}



$bag



</Script></ScriptBody>

    <SnapIns/>

    <TimeoutSeconds>300</TimeoutSeconds>

    <Schedule>20100</Schedule>

    <ErrorExpression>

      <SimpleExpression>

        <ValueExpression>

          <XPathQuery Type="Boolean">Property[@Name='HasIssue']</XPathQuery>

        </ValueExpression>

        <Operator>Equal</Operator>

        <ValueExpression>

          <Value Type="Boolean">true</Value>

        </ValueExpression>

      </SimpleExpression>

    </ErrorExpression>

    <SuccessExpression>

      <Not>

        <Expression>

          <SimpleExpression>

            <ValueExpression>

              <XPathQuery Type="Boolean">Property[@Name='HasIssue']</XPathQuery>

            </ValueExpression>

            <Operator>Equal</Operator>

            <ValueExpression>

              <Value Type="Boolean">true</Value>

            </ValueExpression>

          </SimpleExpression>

        </Expression>

      </Not>

    </SuccessExpression>

  </Configuration>

</UnitMonitor>