Créer windowsUpdateStateCreate windowsUpdateState

Espace de noms: microsoft.graphNamespace: microsoft.graph

Important : Les API Microsoft Graph sous la version/beta peuvent faire l’objet de modifications ; l’utilisation de la production n’est pas prise en charge.Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Crée un objet windowsUpdateState .Create a new windowsUpdateState object.

Conditions préalablesPrerequisites

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (par ordre décroissant du niveau de privilège)Permissions (from most to least privileged)
Déléguée (compte professionnel ou scolaire)Delegated (work or school account)
    Configuration des appareils    Device configuration DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All
   Mise à jour logicielle    Software Update DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) Non prise en charge.Not supported.
ApplicationApplication
    Configuration des appareils    Device configuration DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All
   Mise à jour logicielle    Software Update DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All

Requête HTTPHTTP Request

POST /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsUpdateForBusinessConfiguration/deviceUpdateStates

En-têtes de demandeRequest headers

En-têteHeader ValeurValue
AutorisationAuthorization Porteur <token> obligatoire.Bearer <token> Required.
AccepterAccept application/jsonapplication/json

Corps de la demandeRequest body

Dans le corps de la demande, fournissez une représentation JSON de l’objet windowsUpdateState.In the request body, supply a JSON representation for the windowsUpdateState object.

Le tableau suivant indique les propriétés qui sont requises lorsque vous créez le windowsUpdateState.The following table shows the properties that are required when you create the windowsUpdateState.

PropriétéProperty TypeType DescriptionDescription
idid StringString Il s’agit de l’ID de l’entité.This is Id of the entity.
deviceIddeviceId StringString ID de l’appareil.The id of the device.
userIduserId StringString ID de l’utilisateur.The id of the user.
deviceDisplayNamedeviceDisplayName StringString Nom complet de l’appareil.Device display name.
userPrincipalNameuserPrincipalName StringString Nom d’utilisateur principal.User principal name.
statusstatus windowsUpdateStatuswindowsUpdateStatus État de la réudpate Windows.Windows udpate status. Les valeurs possibles sont les suivantes : upToDate, pendingInstallation, pendingReboot, failed.Possible values are: upToDate, pendingInstallation, pendingReboot, failed.
qualityUpdateVersionqualityUpdateVersion StringString Version de la mise à jour de la qualité de l’appareil.The Quality Update Version of the device.
featureUpdateVersionfeatureUpdateVersion StringString Version actuelle de la fonctionnalité de mise à jour de l’appareil.The current feature update version of the device.
lastScanDateTimelastScanDateTime DateTimeOffsetDateTimeOffset Date et heure auxquelles l’agent de mise à jour automatique Windows Update a effectué une analyse.The date time that the Windows Update Agent did a successful scan.
lastSyncDateTimelastSyncDateTime DateTimeOffsetDateTimeOffset Date et heure de la dernière synchronisation de l’appareil avec Microsoft Intune.Last date time that the device sync with with Microsoft Intune.

RéponseResponse

Si elle réussit, cette méthode renvoie un 201 Created Code de réponse et un objet windowsUpdateState dans le corps de la réponse.If successful, this method returns a 201 Created response code and a windowsUpdateState object in the response body.

ExempleExample

DemandeRequest

Voici un exemple de demande.Here is an example of the request.

POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsUpdateForBusinessConfiguration/deviceUpdateStates
Content-type: application/json
Content-length: 504

{
  "@odata.type": "#microsoft.graph.windowsUpdateState",
  "deviceId": "Device Id value",
  "userId": "User Id value",
  "deviceDisplayName": "Device Display Name value",
  "userPrincipalName": "User Principal Name value",
  "status": "pendingInstallation",
  "qualityUpdateVersion": "Quality Update Version value",
  "featureUpdateVersion": "Feature Update Version value",
  "lastScanDateTime": "2016-12-31T23:59:18.0955018-08:00",
  "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00"
}

RéponseResponse

Voici un exemple de la réponse. Remarque : L’objet de réponse illustré ici peut être tronqué à des fins de concision. Toutes les propriétés sont renvoyées à partir d’un appel réel.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 553

{
  "@odata.type": "#microsoft.graph.windowsUpdateState",
  "id": "3d92af00-af00-3d92-00af-923d00af923d",
  "deviceId": "Device Id value",
  "userId": "User Id value",
  "deviceDisplayName": "Device Display Name value",
  "userPrincipalName": "User Principal Name value",
  "status": "pendingInstallation",
  "qualityUpdateVersion": "Quality Update Version value",
  "featureUpdateVersion": "Feature Update Version value",
  "lastScanDateTime": "2016-12-31T23:59:18.0955018-08:00",
  "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00"
}