Enroll Email Health Monitor (Mobile Device Manager Log)

Microsoft.SystemCenter.MobileDeviceManager.2008.1_1.EnrollmentAdministrationServices.EnrollEmail.MobileDeviceManager.NewDiagnoser.EventBased.UnitMonitor (UnitMonitor)

Knowledge Base article:

Enroll Email (Aspect)

This aspect contains the enrollment email objects that you can monitor in the Enrollment Administration Service. These health monitors include the following detector.

Green Health State

Event ID 2200: ENROLLMENT_SEND_EMAIL_SUCCEEDED - Succeeded to send e-mail to: X.

Yellow Health State

Event ID 2201: ENROLLMENT_SEND_EMAIL_FAILED - Failed to send email after create pending enrollment request.

New Diagnoser (Diagnoser)

This issue occurs if MDM Enrollment Server encounters an error when sending the enrollment confirmation e-mail message to the client device. Check resolution information on how to resolve this issue.

Enable Exchange Server to relay messages from MDM (Resolution)

If the enrollment request succeeds but the user does not receive the enrollment e-mail message, check the MDM section in Event Viewer for error message, Event 2201 - Error: System.Net.Mail.SmtpException: Syntax error, command unrecognized. The server response was: 5.7.3 Authentication unsuccessful.

This error indicates that there was a problem in sending the enrollment e-mail message. This problem can occur if the e-mail system is running Microsoft Exchange Server 2007 with anonymous relay disabled.To resolve this issue, enable anonymous relay in Exchange Server 2007 by following the instructions at this Microsoft Web site: http://go.microsoft.com/fwlink/?LinkId=108241

Verify Mail Configuration (Resolution)

After you create a new enrollment request and specify an e-mail address, the user does not receive the enrollment e-mail message. This e-mail message contains the URL for MDM Enrollment Server and the one-time password for device enrollment. To resolve this issue, follow these steps:

From MDM Console, make sure that you select the Send e-mail check box.
If you are creating the enrollment request by running the New-EnrollmentRequest cmdlet, use the -SendMail parameter.
Make sure that the e-mail address for the device owner is correct.
Specify a valid e-mail sender by running the Set-EnrollmentConfig cmdlet with the EmailSender parameter. For example: Set-EnrollmentConfig -EmailSender [email protected].
If the EmailSender value is not a valid Microsoft Exchange Server 2007 e-mail account, or is otherwise not properly configured to send e-mail, then MDM has no way to send the enrollment e-mail message.
Run the following MDM Shell command to specify the SMTP server to send e-mail messages:
Set-EnrollmentConfig -SmtpServer smtp.yourdomain.com

By default, MDM uses localhost to send the e-mail message that contains the one-time enrollment password. When you run the Get-EnrollmentConfig cmdlet in MDM Shell, you can see that the SmptServer entry specifies localhost. The following shows you other parameters that you can modify:

Set-EnrollmentConfig -SmtpServer
Set-EnrollmentConfig -EmailSubject

Set-EnrollmentConfig -EmailBodyTemplate

Set-EnrollmentConfig -EmailSender

If the enrollment request succeeds but the user does not receive the enrollment e-mail message, check the MDM section in Event Viewer for this error message:

Event 2201 - Error: System.Net.Mail.SmtpException: Syntax error, command unrecognized. The server response was: 5.7.3 Authentication unsuccessful.

This error indicates that there was a problem in sending the enrollment e-mail message. This problem can occur if the e-mail system is running Microsoft Exchange Server 2007 with anonymous relay disabled. To resolve this issue, enable anonymous relay in Exchange Server 2007 by following the instructions at this Microsoft Web site: http://go.microsoft.com/fwlink/?LinkId=108241.

Element properties:

Target

Microsoft.SystemCenter.MobileDeviceManager.2008.1_1.EnrollmentAdministrationServices.ClassType

Parent Monitor

System.Health.AvailabilityState

Category

StateCollection

Enabled

True

Alert Generate

True

Alert Severity

MatchMonitorHealth

Alert Priority

Normal

Alert Auto Resolve

True

Monitor Type

Microsoft.Windows.2SingleEventLog2StateMonitorType

Remotable

True

Accessibility

Public

Alert Message

Enroll Email Alert

{0}

RunAs

Default

Source Code:

<UnitMonitor ID="Microsoft.SystemCenter.MobileDeviceManager.2008.1_1.EnrollmentAdministrationServices.EnrollEmail.MobileDeviceManager.NewDiagnoser.EventBased.UnitMonitor" Accessibility="Public" Enabled="onEssentialMonitoring" Target="Microsoft.SystemCenter.MobileDeviceManager.2008.1_1.EnrollmentAdministrationServices.ClassType" ParentMonitorID="SystemHealth!System.Health.AvailabilityState" Remotable="true" Priority="Normal" TypeID="Windows!Microsoft.Windows.2SingleEventLog2StateMonitorType" ConfirmDelivery="true">

  <Category>StateCollection</Category>

  <AlertSettings AlertMessage="Microsoft.SystemCenter.MobileDeviceManager.2008.1_1.EnrollmentAdministrationServices.EnrollEmail.MobileDeviceManager.NewDiagnoser.EventBased.UnitMonitor.AlertMessage">

    <AlertOnState>Warning</AlertOnState>

    <AutoResolve>true</AutoResolve>

    <AlertPriority>Normal</AlertPriority>

    <AlertSeverity>MatchMonitorHealth</AlertSeverity>

    <AlertParameters>

      <AlertParameter1>$Data/Context/EventDescription$</AlertParameter1>

    </AlertParameters>

  </AlertSettings>

  <OperationalStates>

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

    <OperationalState ID="Negative" MonitorTypeStateID="SecondEventRaised" HealthState="Warning"/>

  </OperationalStates>

  <Configuration>

    <FirstComputerName>$Target/Host/Host/Host/Property[Type="Windows!Microsoft.Windows.Computer"]/NetworkName$</FirstComputerName>

    <FirstLogName>Mobile Device Manager</FirstLogName>

    <FirstExpression>

      <And>

        <Expression>

          <SimpleExpression>

            <ValueExpression>

              <XPathQuery>PublisherName</XPathQuery>

            </ValueExpression>

            <Operator>Equal</Operator>

            <ValueExpression>

              <Value>Enrollment</Value>

            </ValueExpression>

          </SimpleExpression>

        </Expression>

        <Expression>

          <SimpleExpression>

            <ValueExpression>

              <XPathQuery>EventDisplayNumber</XPathQuery>

            </ValueExpression>

            <Operator>Equal</Operator>

            <ValueExpression>

              <Value>2200</Value>

            </ValueExpression>

          </SimpleExpression>

        </Expression>

      </And>

    </FirstExpression>

    <SecondComputerName>$Target/Host/Host/Host/Property[Type="Windows!Microsoft.Windows.Computer"]/NetworkName$</SecondComputerName>

    <SecondLogName>Mobile Device Manager</SecondLogName>

    <SecondExpression>

      <And>

        <Expression>

          <SimpleExpression>

            <ValueExpression>

              <XPathQuery>PublisherName</XPathQuery>

            </ValueExpression>

            <Operator>Equal</Operator>

            <ValueExpression>

              <Value>Enrollment</Value>

            </ValueExpression>

          </SimpleExpression>

        </Expression>

        <Expression>

          <SimpleExpression>

            <ValueExpression>

              <XPathQuery>EventDisplayNumber</XPathQuery>

            </ValueExpression>

            <Operator>Equal</Operator>

            <ValueExpression>

              <Value>2201</Value>

            </ValueExpression>

          </SimpleExpression>

        </Expression>

      </And>

    </SecondExpression>

  </Configuration>

</UnitMonitor>