Aktualisieren von mobileAppPolicySetItem
Namespace: microsoft.graph
Wichtig: Microsoft Graph-APIs unter der /beta-Version können sich ändern. Die Verwendung in der Produktion wird nicht unterstützt.
Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.
Aktualisieren sie die Eigenschaften eines mobileAppPolicySetItem-Objekts .
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.
Berechtigungstyp | Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten) |
---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | DeviceManagementConfiguration.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt |
Anwendung | DeviceManagementConfiguration.ReadWrite.All |
HTTP-Anforderung
PATCH /deviceAppManagement/policySets/{policySetId}/items/{policySetItemId}
Anforderungsheader
Kopfzeile | Wert |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Annehmen | application/json |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung für das mobileAppPolicySetItem-Objekt an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen des mobileAppPolicySetItem-Objekts erforderlich sind.
Eigenschaft | Typ | Beschreibung |
---|---|---|
id | Zeichenfolge | Schlüssel des PolicySetItem-Objekts. Geerbt von policySetItem |
createdDateTime | DateTimeOffset | Erstellungszeit des PolicySetItem. Geerbt von policySetItem |
lastModifiedDateTime | DateTimeOffset | Zeitpunkt der letzten Änderung von PolicySetItem. Geerbt von policySetItem |
payloadId | Zeichenfolge | PayloadId des PolicySetItem-Objekts. Geerbt von policySetItem |
itemType | Zeichenfolge | policySetType des PolicySetItem-Objekts. Geerbt von policySetItem |
displayName | Zeichenfolge | DisplayName des PolicySetItem-Objekts. Geerbt von policySetItem |
status | policySetStatus | Status des PolicySetItem. Geerbt von policySetItem. Mögliche Werte sind: unknown , validating , partialSuccess , success , error und notAssigned . |
errorCode | errorCode | Fehlercode, falls vorhanden. Geerbt von policySetItem. Mögliche Werte: noError , unauthorized , notFound , deleted |
guidedDeploymentTags | Zeichenfolgensammlung | Tags der geführten Bereitstellung geerbt von policySetItem |
intent | installIntent | Installieren Sie die Absicht von MobileAppPolicySetItem. Mögliche Werte: available , required , uninstall , availableWithoutEnrollment . |
settings | mobileAppAssignmentSettings | Einstellungen von MobileAppPolicySetItem. |
Antwort
Wenn die Methode erfolgreich verläuft, werden der 200 OK
Antwortcode und ein aktualisiertes mobileAppPolicySetItem-Objekt im Antworttext zurückgegeben.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
PATCH https://graph.microsoft.com/beta/deviceAppManagement/policySets/{policySetId}/items/{policySetItemId}
Content-type: application/json
Content-length: 896
{
"@odata.type": "#microsoft.graph.mobileAppPolicySetItem",
"payloadId": "Payload Id value",
"itemType": "Item Type value",
"displayName": "Display Name value",
"status": "validating",
"errorCode": "unauthorized",
"guidedDeploymentTags": [
"Guided Deployment Tags value"
],
"intent": "required",
"settings": {
"@odata.type": "microsoft.graph.winGetAppAssignmentSettings",
"notifications": "showReboot",
"restartSettings": {
"@odata.type": "microsoft.graph.winGetAppRestartSettings",
"gracePeriodInMinutes": 4,
"countdownDisplayBeforeRestartInMinutes": 6,
"restartNotificationSnoozeDurationInMinutes": 10
},
"installTimeSettings": {
"@odata.type": "microsoft.graph.winGetAppInstallTimeSettings",
"useLocalTime": true,
"deadlineDateTime": "2017-01-01T00:00:21.0378955-08:00"
}
}
}
Antwort
Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1068
{
"@odata.type": "#microsoft.graph.mobileAppPolicySetItem",
"id": "b6ffe6cf-e6cf-b6ff-cfe6-ffb6cfe6ffb6",
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"payloadId": "Payload Id value",
"itemType": "Item Type value",
"displayName": "Display Name value",
"status": "validating",
"errorCode": "unauthorized",
"guidedDeploymentTags": [
"Guided Deployment Tags value"
],
"intent": "required",
"settings": {
"@odata.type": "microsoft.graph.winGetAppAssignmentSettings",
"notifications": "showReboot",
"restartSettings": {
"@odata.type": "microsoft.graph.winGetAppRestartSettings",
"gracePeriodInMinutes": 4,
"countdownDisplayBeforeRestartInMinutes": 6,
"restartNotificationSnoozeDurationInMinutes": 10
},
"installTimeSettings": {
"@odata.type": "microsoft.graph.winGetAppInstallTimeSettings",
"useLocalTime": true,
"deadlineDateTime": "2017-01-01T00:00:21.0378955-08:00"
}
}
}