Makros

XenMobile bietet Makros zum Eintragen von Benutzer- und Geräteeigenschaften im Textfeld folgender Elemente:

• Richtlinien
• Benachrichtigungen
• Registrierungsvorlagen
• Automatisierte Aktionen
• Zertifikatsignieranforderungen für Anmeldeinformationsanbieter

XenMobile ersetzt die Makros durch die entsprechenden Benutzer- oder Systemwerte. Sie können beispielsweise den Postfachwert in einem Exchange-Profil für tausende Benutzer vorab eingeben.

Makrosyntax

Ein Makro kann folgendes Format haben:

• ${type.PROPERTYNAME}
• ${type.PROPERTYNAME ['DEFAULT VALUE'] [ | FUNCTION [(ARGUMENT1, ARGUMENT2)]}

Umschließen Sie den gesamten Teil nach dem Dollarzeichen ($) mit geschweiften Klammern ({}).

• Qualifizierte Eigenschaftsnamen verweisen auf eine Benutzereigenschaft, eine Geräteeigenschaft oder eine benutzerdefinierte Eigenschaft.
• Qualifizierte Eigenschaftsnamen bestehen aus einem Präfix gefolgt von dem eigentlichen Eigenschaftsnamen.
• Benutzereigenschaften haben die Form ${user.[PROPERTYNAME] (prefix="user.")}.
• Geräteeigenschaften haben die Form ${device.[PROPERTYNAME] (prefix="device.")}.
• Bei Eigenschaftennamen wird zwischen Groß- und Kleinschreibung unterschieden.

• Eine Funktion kann eine begrenzte Liste sein oder ein Link zu einer Drittanbieter-Referenz, die Funktionen definiert. Das folgende Makro für eine Benachrichtigung enthält die Funktion firstnotnull:

  Gerät ${firstnotnull(device.TEL_NUMBER,device.serialNumber)} wurde gesperrt…

• Bei benutzerdefinierten (von Ihnen erstellten) Makros lautet das Präfix ${custom}. Sie können das Präfix auslassen.

Es folgt ein Beispiel des häufig verwendeten Makros ${user.username} zum Eintragen des Werts “Benutzername” im Textfeld einer Richtlinie. Das Makro ist nützlich beim Konfigurieren von Exchange ActiveSync-Profilen und anderen Profilen, die von mehreren Benutzern verwendet werden. Das folgende Beispiel zeigt, wie Makros in einer Exchange-Richtlinie verwendet werden. Das Makro für Benutzer ist ${user.username}. Das Makro für E-Mail-Adresse ist ${user.mail}.

Das folgende Beispiel zeigt, wie Makros für eine Zertifikatsignieranforderung verwendet werden. Das Makro für Antragstellername ist CN=$user.username. Das Makro für den Wert von Alternativer Antragstellername ist $user.userprincipalname.

Das folgende Beispiel zeigt, wie Makros in einer Benachrichtigungsvorlage verwendet werden. Die Vorlage in dem Beispiel definiert die Nachricht, die an Benutzer gesendet wird, wenn HDX-Anwendungen aufgrund mangelnder Richtlinientreue des Geräts blockiert werden. Das Makro für Meldung ist:

Gerät ${firstnotnull(device.TEL_NUMBER,device.serialNumber)} erfüllt die Geräterichtlinie nicht mehr und HDX-Apps werden gesperrt.

Zum Aufrufen weiterer Beispiele für die Verwendung von Makros in Benachrichtigungen gehen Sie zu Einstellungen > Benachrichtigungsvorlagen, wählen Sie eine vordefinierte Vorlage und klicken Sie auf Bearbeiten.

Das folgende Beispiel zeigt ein Makro in der Geräterichtlinie “Gerätename”. Sie können das Makro, eine Kombination aus Makros oder eine Kombination aus Makros und Text zur eindeutigen Benennung aller Geräte eingeben. Um beispielsweise als Gerätenamen die Seriennummer festzulegen, verwenden Sie ${device.serialnumber}. Verwenden Sie ${device.serialnumber} ${ user.username }, um den Benutzernamen in den Gerätenamen aufzunehmen. Die Geräterichtlinie “Gerätename” funktioniert auf betreuten iOS- und MacOS-Geräten.

Makros für Standardbenachrichtigungsvorlagen

Folgende Makros können Sie in Standardbenachrichtigungsvorlagen verwenden:

• ${account.SUPPORT_EMAIL}
• ${applicationName}
• ${enrollment.andriod.agent.download.url}
• ${enrollment.ios.agent.download.url}
• ${enrollment.pin}
• ${enrollment.url}
• ${enrollment.urls}
• ${enrollment.ios.url}
• ${enrollment.macos.url}
• ${enrollment.android.url}
• ${enrollment.ios.platform}
• ${enrollment.macos.platform}
• ${enrollment.android.platform}
• ${firstnotnull(device.TEL_NUMBER,device.serialNumber)}
• ${firstnotnull(device.TEL_NUMBER,user.mobile)}
• ${outofcompliance.reason(smg_block)}
• ${outofcompliance.reason(whitelist_blacklist_apps_name)}
• ${vpp.account}
• ${vpp.appname}
• ${vpp.url}
• ${zdmserver.hostPath}/enroll

Makros für bestimmte Richtlinien

Bei der Geräterichtlinie für Gerätenamen (für iOS und MacOS) können Sie folgende Makros für den Gerätenamen verwenden:

• ${device.serialnumber}
• ${user.username}@example.com
• ${device.serialnumber}
• ${device.serialnumber}
• ${user.username}
• ${enrollment.pin}
• ${user.dnsroot}

Bei der Webclip-Geräterichtlinie können Sie folgendes Makro für die URL verwenden:

• ${webeas-url}

Bei der Geräterichtlinie für Samsung MDM-Lizenzschlüssel können Sie dieses Makro für den ELM-Lizenzschlüssel verwenden:

• ${elm.license.key}

Makros zum Abrufen integrierter Geräteeigenschaften

Makros für alle Geräteeigenschaften

Makros zum Abrufen integrierter Benutzereigenschaften

Makros für alle Benutzereigenschaften