windowsFeatureUpdateProfile erstellen

Namespace: microsoft.graph

Wichtig: Microsoft unterstützt Intune /beta-APIs, sie unterliegen jedoch häufigeren Änderungen. Microsoft empfiehlt, wenn möglich Version v1.0 zu verwenden. Überprüfen Sie die Verfügbarkeit einer API in Version v1.0 mithilfe der Versionsauswahl.

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

Erstellen Sie ein neues windowsFeatureUpdateProfile-Objekt .

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service 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
Application DeviceManagementConfiguration.ReadWrite.All

HTTP-Anforderung

POST /deviceManagement/windowsFeatureUpdateProfiles

Anforderungsheader

Kopfzeile Wert
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Annehmen application/json

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung für das windowsFeatureUpdateProfile-Objekt an.

Die folgende Tabelle zeigt die Eigenschaften, die beim Erstellen des windowsFeatureUpdateProfile erforderlich sind.

Eigenschaft Typ Beschreibung
id Zeichenfolge Der Bezeichner des Objekts.
displayName Zeichenfolge Der Anzeigename des Profils.
description Zeichenfolge Die Beschreibung des Profils, die vom Benutzer angegeben wird.
featureUpdateVersion Zeichenfolge Die Featureupdateversion, die auf den Zielgeräten dieses Profils bereitgestellt wird. Die Version kann jede unterstützte Version sein, beispielsweise 1709, 1803 oder 1809 usw.
rolloutSettings windowsUpdateRolloutSettings Die Windows Update-Rollouteinstellungen, einschließlich Startdatum des Angebots, Uhrzeit, Enddatum des Angebots und Tage zwischen den einzelnen Angebotssätzen.
createdDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der das Profil erstellt wurde.
lastModifiedDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der das Profil zuletzt geändert wurde.
roleScopeTagIds String collection Liste der Bereichstags für diese Featureupdateentität.
deployableContentDisplayName Zeichenfolge Anzeigename des Profils für Qualitätsupdates bereitstellbarer Inhalt
endOfSupportDate DateTimeOffset Das letzte unterstützte Datum für ein Funktionsupdate
installLatestWindows10OnWindows11IneligibleDevice Boolean Bei TRUE wird das neueste Microsoft Windows 10-Update auf Geräten installiert, die nicht für Microsoft Windows 11 berechtigt sind
installFeatureUpdatesOptional Boolean Bei "true" wird das Windows 11-Update optional

Antwort

Bei erfolgreicher Ausführung gibt diese Methode einen 201 Created Antwortcode und ein windowsFeatureUpdateProfile-Objekt im Antworttext zurück.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

POST https://graph.microsoft.com/beta/deviceManagement/windowsFeatureUpdateProfiles
Content-type: application/json
Content-length: 773

{
  "@odata.type": "#microsoft.graph.windowsFeatureUpdateProfile",
  "displayName": "Display Name value",
  "description": "Description value",
  "featureUpdateVersion": "Feature Update Version value",
  "rolloutSettings": {
    "@odata.type": "microsoft.graph.windowsUpdateRolloutSettings",
    "offerStartDateTimeInUTC": "2017-01-01T00:01:16.3697768-08:00",
    "offerEndDateTimeInUTC": "2016-12-31T23:58:15.1925199-08:00",
    "offerIntervalInDays": 3
  },
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "deployableContentDisplayName": "Deployable Content Display Name value",
  "endOfSupportDate": "2017-01-01T00:02:08.3437725-08:00",
  "installLatestWindows10OnWindows11IneligibleDevice": true,
  "installFeatureUpdatesOptional": true
}

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 201 Created
Content-Type: application/json
Content-Length: 945

{
  "@odata.type": "#microsoft.graph.windowsFeatureUpdateProfile",
  "id": "885bd4ee-d4ee-885b-eed4-5b88eed45b88",
  "displayName": "Display Name value",
  "description": "Description value",
  "featureUpdateVersion": "Feature Update Version value",
  "rolloutSettings": {
    "@odata.type": "microsoft.graph.windowsUpdateRolloutSettings",
    "offerStartDateTimeInUTC": "2017-01-01T00:01:16.3697768-08:00",
    "offerEndDateTimeInUTC": "2016-12-31T23:58:15.1925199-08:00",
    "offerIntervalInDays": 3
  },
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "deployableContentDisplayName": "Deployable Content Display Name value",
  "endOfSupportDate": "2017-01-01T00:02:08.3437725-08:00",
  "installLatestWindows10OnWindows11IneligibleDevice": true,
  "installFeatureUpdatesOptional": true
}
  • Last updated on