Partager via


Update sharedPCConfiguration

Espace de noms: microsoft.graph

Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.

Met à jour les propriétés d’un objet sharedPCConfiguration.

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet

Autorisations

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.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) DeviceManagementConfiguration.ReadWrite.All
Déléguée (compte Microsoft personnel) Non prise en charge.
Application DeviceManagementConfiguration.ReadWrite.All

Requête HTTP

PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}

En-têtes de demande

En-tête Valeur
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Accepter application/json

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON de l’objet sharedPCConfiguration.

Le tableau suivant indique les propriétés qui sont requises lorsque vous créez l’objet sharedPCConfiguration.

Propriété Type Description
id String Clé de l’entité. Hérité de deviceConfiguration.
lastModifiedDateTime DateTimeOffset Date et heure de dernière modification de l’objet. Hérité de deviceConfiguration.
createdDateTime DateTimeOffset Date et heure de création de l’objet. Hérité de deviceConfiguration.
description String Description de la configuration de l’appareil fournie par l’administrateur. Hérité de deviceConfiguration.
displayName String Nom de la configuration de l’appareil fourni par l’administrateur. Hérité de deviceConfiguration.
version Int32 Version de la configuration de l’appareil. Hérité de deviceConfiguration.
accountManagerPolicy sharedPCAccountManagerPolicy Spécifie la manière dont les comptes sont gérés sur un PC partagé. S’applique uniquement lorsque l’objet disableAccountManager est False.
allowedAccounts sharedPCAllowedAccountType Indique les types de compte qui sont autorisés sur un PC partagé. Les valeurs possibles sont les suivantes : guest et domain.
allowLocalStorage Booléen Spécifie si le stockage local est autorisé sur un PC partagé.
disableAccountManager Booléen Désactive le gestionnaire de comptes pour le mode de PC partagé.
disableEduPolicies Booléen Spécifie si les stratégies d’environnement d’éducation de PC partagé doivent être désactivées. Pour Windows 10 RS2 et versions ultérieures, cette stratégie est appliquée sans que la propriété enabled soit définie sur True.
disablePowerPolicies Booléen Spécifie si les stratégies d’alimentation de PC partagé doivent être désactivées.
disableSignInOnResume Booléen Désactive l’obligation de vous connecter chaque fois que l’appareil sort du mode veille.
enabled Booléen Active le mode de PC partagé et applique les stratégies de PC partagé.
idleTimeBeforeSleepInSeconds Int32 Spécifie la durée en secondes pendant laquelle un appareil doit être inactif avant que le PC se mette en veille. En définissant cette valeur sur 0, vous empêchez l’expiration du délai avant la veille de se produire.
kioskAppDisplayName String Spécifie le texte d’affichage pour le compte affiché sur l’écran de connexion qui lance l’application spécifiée par l’objet SetKioskAppUserModelId. S’applique uniquement lorsque la propriété KioskAppUserModelId est définie.
kioskAppUserModelId String Spécifie l’ID de modèle utilisateur d’application de l’application à utiliser avec l’accès affecté.
maintenanceStartTime TimeOfDay Spécifie l’heure de démarrage quotidienne de la maintenance.

Réponse

Si elle réussit, cette méthode renvoie un code de réponse 200 OK et un objet sharedPCConfiguration mis à jour dans le corps de la réponse.

Exemple

Demande

Voici un exemple de demande.

PATCH https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurations/{deviceConfigurationId}
Content-type: application/json
Content-length: 860

{
  "@odata.type": "#microsoft.graph.sharedPCConfiguration",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "accountManagerPolicy": {
    "@odata.type": "microsoft.graph.sharedPCAccountManagerPolicy",
    "accountDeletionPolicy": "diskSpaceThreshold",
    "cacheAccountsAboveDiskFreePercentage": 4,
    "inactiveThresholdDays": 5,
    "removeAccountsBelowDiskFreePercentage": 5
  },
  "allowedAccounts": "domain",
  "allowLocalStorage": true,
  "disableAccountManager": true,
  "disableEduPolicies": true,
  "disablePowerPolicies": true,
  "disableSignInOnResume": true,
  "enabled": true,
  "idleTimeBeforeSleepInSeconds": 12,
  "kioskAppDisplayName": "Kiosk App Display Name value",
  "kioskAppUserModelId": "Kiosk App User Model Id value",
  "maintenanceStartTime": "11:59:24.7240000"
}

Réponse

Voici un exemple de 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.

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1032

{
  "@odata.type": "#microsoft.graph.sharedPCConfiguration",
  "id": "5206be3b-be3b-5206-3bbe-06523bbe0652",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "accountManagerPolicy": {
    "@odata.type": "microsoft.graph.sharedPCAccountManagerPolicy",
    "accountDeletionPolicy": "diskSpaceThreshold",
    "cacheAccountsAboveDiskFreePercentage": 4,
    "inactiveThresholdDays": 5,
    "removeAccountsBelowDiskFreePercentage": 5
  },
  "allowedAccounts": "domain",
  "allowLocalStorage": true,
  "disableAccountManager": true,
  "disableEduPolicies": true,
  "disablePowerPolicies": true,
  "disableSignInOnResume": true,
  "enabled": true,
  "idleTimeBeforeSleepInSeconds": 12,
  "kioskAppDisplayName": "Kiosk App Display Name value",
  "kioskAppUserModelId": "Kiosk App User Model Id value",
  "maintenanceStartTime": "11:59:24.7240000"
}