managedAppProtection-Ressourcentyp

Namespace: microsoft.graph

Wichtig: Microsoft Graph APIs unter der /beta-Version können geändert werden. Die Produktionsverwendung wird nicht unterstützt.

Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.

Diese Richtlinie wird verwendet, um detaillierte Verwaltungseinstellungen für eine bestimmte Gruppe von Apps zu konfigurieren.

Erbt von managedAppPolicy.

Methoden

Methode	Rückgabetyp	Beschreibung
managedAppProtections auflisten	managedAppProtection-Sammlung	Listet die Eigenschaften und Beziehungen von managedAppProtection-Objekten auf.
managedAppProtection abrufen	managedAppProtection	Liest die Eigenschaften und Beziehungen des managedAppProtection-Objekts.
targetApps-Aktion	Keine	Noch nicht dokumentiert.

Eigenschaften

Eigenschaft	Typ	Beschreibung
displayName	Zeichenfolge	Anzeigename der Richtlinie Geerbt von managedAppPolicy.
description	String	Beschreibung der Richtlinie Geerbt von managedAppPolicy.
createdDateTime	DateTimeOffset	Datum und Uhrzeit der Erstellung der Richtlinie Geerbt von managedAppPolicy.
lastModifiedDateTime	DateTimeOffset	Datum und Uhrzeit der letzten Änderung der Richtlinie Geerbt von managedAppPolicy.
roleScopeTagIds	String-Sammlung	Liste der Bereichstags für diese Entitätsinstanz. Geerbt von managedAppPolicy.
id	Zeichenfolge	Schlüssel der Entität Geerbt von managedAppPolicy.
Version	String	Version der Entität Geerbt von managedAppPolicy.
periodOfflineBeforeAccessCheck	Dauer	Zeitraum, nach dem der Zugriff überprüft wird, wenn das Gerät nicht mit dem Internet verbunden ist.
periodOnlineBeforeAccessCheck	Dauer	Zeitraum, nach dem der Zugriff überprüft wird, wenn das Gerät mit dem Internet verbunden ist.
allowedInboundDataTransferSources	managedAppDataTransferLevel	Quellen, von denen Daten übermittelt werden dürfen. Mögliche Werte: allApps, managedApps, none.
allowedOutboundDataTransferDestinations	managedAppDataTransferLevel	Ziele, an die Daten übermittelt werden dürfen. Mögliche Werte: allApps, managedApps, none.
organizationalCredentialsRequired	Boolean	Gibt an, ob von der Organisation bereitgestellte Anmeldeinformationen zur Nutzung der App erforderlich sind.
allowedOutboundClipboardSharingLevel	managedAppClipboardSharingLevel	Regelt die Freigabe der Zwischenablage für Apps auf dem verwalteten Gerät. Mögliche Werte: allApps, managedAppsWithPasteIn, managedApps, blocked.
dataBackupBlocked	Boolean	Gibt an, ob die Sicherung der Daten der verwalteten App blockiert werden soll.
deviceComplianceRequired	Boolean	Gibt an, ob Gerätekonformität erforderlich ist.
managedBrowserToOpenLinksRequired	Boolean	Gibt an, ob Internetlinks in der verwalteten Browser-App oder einem benutzerdefinierten Browser geöffnet werden sollen, der durch CustomBrowserProtocol (für iOS) oder CustomBrowserPackageId/CustomBrowserDisplayName (für Android) angegeben wird.
saveAsBlocked	Boolean	Gibt an, ob Benutzer das Menüelement „Speichern unter“ verwenden dürfen, um eine Kopie geschützter Dateien zu speichern.
periodOfflineBeforeWipeIsEnforced	Dauer	Legt fest, wie lange eine App ohne Internetverbindung sein darf, bevor sämtliche verwalteten Daten gelöscht werden.
pinRequired	Boolean	Gibt an, ob eine PIN auf App-Ebene erforderlich ist.
maximumPinRetries	Int32	Maximale Anzahl falscher Pin-Wiederholungsversuche, bevor die verwaltete App blockiert oder zurückgesetzt wird.
simplePinBlocked	Boolean	Gibt an, ob einfache PINs blockiert werden sollen.
minimumPinLength	Int32	Erforderliche PIN-Mindestlänge für PINs auf App-Ebene, wenn „pinRequired“ auf „true“ gesetzt ist.
pinCharacterSet	managedAppPinCharacterSet	Zulässige Zeichensätze für PINs auf App-Ebene, wenn „pinRequired“ auf „true“ gesetzt ist. Mögliche Werte: numeric, alphanumericAndSymbol.
periodBeforePinReset	Dauer	Zeitraum, nach dem die für alle Ebenen geltende PIN zurückgesetzt werden muss, wenn „pinRequired“ auf „true“ gesetzt ist.
allowedDataStorageLocations	managedAppDataStorageLocation-Sammlung	Datenspeicherorte, an denen der Benutzer verwaltete Daten speichern darf.
contactSyncBlocked	Boolean	Gibt an, ob eine Synchronisierung von Kontakten mit dem Gerät des Benutzers erlaubt ist.
printBlocked	Boolean	Gibt an, ob über verwaltete Apps gedruckt werden darf.
fingerprintBlocked	Boolean	Gibt an, ob statt einer PIN der Fingerabdruckleser verwendet werden darf, wenn „pinRequired“ auf „true“ gesetzt ist.
disableAppPinIfDevicePinIsSet	Boolean	Gibt an, ob die Verwendung der App-PIN erforderlich ist, wenn die Geräte-PIN gesetzt ist.
maximumRequiredOsVersion	Zeichenfolge	Versionen, die größer als die angegebene Version sind, blockieren den Zugriff der verwalteten App auf Unternehmensdaten.
maximumWarningOsVersion	Zeichenfolge	Versionen, die größer als die angegebene Version sind, blockieren den Zugriff der verwalteten App auf Unternehmensdaten.
maximumWipeOsVersion	Zeichenfolge	Versionen, die größer als die angegebene Version sind, blockieren den Zugriff der verwalteten App auf Unternehmensdaten.
minimumRequiredOsVersion	String	Unter älteren Versionen als der angegebenen Version ist der Zugriff auf Unternehmensdaten für die verwaltete App blockiert.
minimumWarningOsVersion	String	Ist eine ältere Version als die angegebene Version installiert, wird in der verwalteten App die Warnmeldung angezeigt, dass kein Zugriff auf Unternehmensdaten erlaubt ist.
minimumRequiredAppVersion	String	Unter älteren Versionen als der angegebenen Version ist der Zugriff auf Unternehmensdaten für die verwaltete App blockiert.
minimumWarningAppVersion	String	Unter älteren Versionen als der angegebenen Version wird eine Warnmeldung in der verwalteten App angezeigt.
minimumWipeOsVersion	Zeichenfolge	Versionen, die kleiner oder gleich der angegebenen Version sind, löschen die verwaltete App und die zugehörigen Unternehmensdaten.
minimumWipeAppVersion	Zeichenfolge	Versionen, die kleiner oder gleich der angegebenen Version sind, löschen die verwaltete App und die zugehörigen Unternehmensdaten.
appActionIfDeviceComplianceRequired	managedAppRemediationAction	Definiert ein verwaltetes App-Verhalten, entweder blockieren oder zurücksetzen, wenn das Gerät entweder gerootet oder jailbroken ist, wenn DeviceComplianceRequired auf "true" festgelegt ist. Mögliche Werte sind: block, wipe und warn.
appActionIfMaximumPinRetriesExceeded	managedAppRemediationAction	Definiert ein verwaltetes App-Verhalten, entweder blockieren oder zurücksetzen, basierend auf der maximalen Anzahl falscher Pin-Wiederholungsversuche. Mögliche Werte sind: block, wipe und warn.
pinRequiredInquiredOfBiometricTimeout	Dauer	Timeout in Minuten für eine App-Pin anstelle von nicht biometrischen Kennungen
allowedOutboundClipboardSharingExceptionLength	Int32	Geben Sie die Anzahl der Zeichen an, die aus Organisationsdaten und -konten in eine beliebige Anwendung ausgeschnitten oder kopiert werden können. Diese Einstellung setzt die Einschränkung "AllowedOutboundClipboardSharingLevel" außer Kraft. Der Standardwert "0" bedeutet, dass keine Ausnahme zulässig ist.
notificationRestriction	managedAppNotificationRestriction	Geben Sie die App-Benachrichtigungseinschränkung an. Mögliche Werte sind: allow, blockOrganizationalData und block.
previousPinBlockCount	Int32	Erfordert, dass ein Pin von der in dieser Eigenschaft angegebenen Nummer eindeutig ist.
managedBrowser	managedBrowserType	Gibt an, in welchen verwalteten Browsern Internetlinks geöffnet werden sollen. Wenn diese Eigenschaft konfiguriert ist, sollte ManagedBrowserToOpenLinksRequired "true" sein. Mögliche Werte sind: notConfigured und microsoftEdge.
maximumAllowedDeviceThreatLevel	managedAppDeviceThreatLevel	Maximal zulässige Geräte-Bedrohungsstufe, wie von der MTD-App gemeldet. Mögliche Werte: notConfigured, secured, low, medium, high.
mobileThreatDefenseRemediationAction	managedAppRemediationAction	Bestimmt, welche Aktion ausgeführt werden soll, wenn der Schwellenwert für die Bedrohungserkennung für mobile Bedrohungen nicht erreicht wird. Warnen ist kein unterstützter Wert für diese Eigenschaft. Mögliche Werte sind: block, wipe und warn.
blockDataIngestionIntoOrganizationDocuments	Boolesch	Gibt an, ob ein Benutzer Daten in Organisationsdokumente übertragen kann.
allowedDataIngestionLocations	managedAppDataIngestionLocation-Sammlung	Datenspeicherorte, an denen der Benutzer verwaltete Daten speichern darf.
appActionIfUnableToAuthenticateUser	managedAppRemediationAction	Wenn festgelegt, wird angegeben, welche Aktion ausgeführt werden soll, wenn der Benutzer nicht einchecken kann, da sein Authentifizierungstoken ungültig ist. Dies geschieht, wenn der Benutzer in AAD gelöscht oder deaktiviert wird. Mögliche Werte sind: block, wipe und warn.
dialerRestrictionLevel	managedAppPhoneNumberRedirectLevel	Die Klassen von Wählhilfe-Apps, die eine Telefonnummer per Klick-und-Los öffnen dürfen. Mögliche Werte: allApps, managedApps, customApp, blocked.
gracePeriodToBlockAppsDuringOffClockHours	Dauer	Eine Karenzzeit, bevor der App-Zugriff außerhalb der Uhr blockiert wird.

Beziehungen

Keine

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "@odata.type": "#microsoft.graph.managedAppProtection",
  "displayName": "String",
  "description": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "roleScopeTagIds": [
    "String"
  ],
  "id": "String (identifier)",
  "version": "String",
  "periodOfflineBeforeAccessCheck": "String (duration)",
  "periodOnlineBeforeAccessCheck": "String (duration)",
  "allowedInboundDataTransferSources": "String",
  "allowedOutboundDataTransferDestinations": "String",
  "organizationalCredentialsRequired": true,
  "allowedOutboundClipboardSharingLevel": "String",
  "dataBackupBlocked": true,
  "deviceComplianceRequired": true,
  "managedBrowserToOpenLinksRequired": true,
  "saveAsBlocked": true,
  "periodOfflineBeforeWipeIsEnforced": "String (duration)",
  "pinRequired": true,
  "maximumPinRetries": 1024,
  "simplePinBlocked": true,
  "minimumPinLength": 1024,
  "pinCharacterSet": "String",
  "periodBeforePinReset": "String (duration)",
  "allowedDataStorageLocations": [
    "String"
  ],
  "contactSyncBlocked": true,
  "printBlocked": true,
  "fingerprintBlocked": true,
  "disableAppPinIfDevicePinIsSet": true,
  "maximumRequiredOsVersion": "String",
  "maximumWarningOsVersion": "String",
  "maximumWipeOsVersion": "String",
  "minimumRequiredOsVersion": "String",
  "minimumWarningOsVersion": "String",
  "minimumRequiredAppVersion": "String",
  "minimumWarningAppVersion": "String",
  "minimumWipeOsVersion": "String",
  "minimumWipeAppVersion": "String",
  "appActionIfDeviceComplianceRequired": "String",
  "appActionIfMaximumPinRetriesExceeded": "String",
  "pinRequiredInsteadOfBiometricTimeout": "String (duration)",
  "allowedOutboundClipboardSharingExceptionLength": 1024,
  "notificationRestriction": "String",
  "previousPinBlockCount": 1024,
  "managedBrowser": "String",
  "maximumAllowedDeviceThreatLevel": "String",
  "mobileThreatDefenseRemediationAction": "String",
  "blockDataIngestionIntoOrganizationDocuments": true,
  "allowedDataIngestionLocations": [
    "String"
  ],
  "appActionIfUnableToAuthenticateUser": "String",
  "dialerRestrictionLevel": "String",
  "gracePeriodToBlockAppsDuringOffClockHours": "String (duration)"
}