Créer un objet sharedPCConfiguration
Espace de noms: microsoft.graph
Important: Les API Microsoft Graph sous la version /beta sont susceptibles d’être modifiées ; l’utilisation de production n’est pas prise en charge.
Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.
Crée 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
POST /deviceManagement/deviceConfigurations
POST /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations
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 pour l’objet sharedPCConfiguration.
Le tableau suivant illustre les propriétés 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. |
roleScopeTagIds | String collection | Liste des balises d’étendue pour cette instance d’entité. Hérité de deviceConfiguration. |
supportsScopeTags | Valeur booléenne | Indique si la configuration d’appareil sous-jacente prend en charge l’attribution des balises d’étendue. L’attribution à la propriété ScopeTags n’est pas autorisée lorsque cette valeur est false et que les entités ne sont pas visibles par les utilisateurs délimités. Cela se produit pour les stratégies héritées créées dans Silverlight et peut être résolu en supprimant et en recréant la stratégie dans le portail Azure. Cette propriété est en lecture seule. Hérité de deviceConfiguration. |
deviceManagementApplicabilityRuleOsEdition | deviceManagementApplicabilityRuleOsEdition | Applicabilité de l’édition du système d’exploitation pour cette stratégie. Hérité de deviceConfiguration. |
deviceManagementApplicabilityRuleOsVersion | deviceManagementApplicabilityRuleOsVersion | Règle d’applicabilité de la version du système d’exploitation pour cette stratégie. Hérité de deviceConfiguration. |
deviceManagementApplicabilityRuleDeviceMode | deviceManagementApplicabilityRuleDeviceMode | Règle d’applicabilité du mode appareil pour cette stratégie. 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 notConfigured , guest et domain . |
Localstorage | Enablement | Spécifie si le stockage local est autorisé sur un PC partagé. Les valeurs possibles sont notConfigured , enabled et disabled . |
allowLocalStorage | Booléen | Spécifie si le stockage local est autorisé sur un PC partagé. |
setAccountManager | Enablement | Désactive le gestionnaire de comptes pour le mode de PC partagé. Les valeurs possibles sont notConfigured , enabled et disabled . |
disableAccountManager | Booléen | Désactive le gestionnaire de comptes pour le mode de PC partagé. |
setEduPolicies | Enablement | Spécifie si les stratégies d’environnement d’éducation de PC partagé par défaut doivent être activées/désactivées/non configuré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. Les valeurs possibles sont notConfigured , enabled et disabled . |
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. |
setPowerPolicies | Enablement | Spécifie si les stratégies d’alimentation des PC partagés par défaut doivent être activées/désactivées. Les valeurs possibles sont notConfigured , enabled et disabled . |
disablePowerPolicies | Booléen | Spécifie si les stratégies d’alimentation de PC partagé doivent être désactivées. |
signInOnResume | Enablement | Spécifie la nécessité de se connecter chaque fois que l’appareil sort du mode veille. Les valeurs possibles sont notConfigured , enabled et disabled . |
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. |
fastFirstSignIn | Enablement | Spécifie si les nouveaux comptes Azure AD non administrateurs doivent être automatiquement connectés à des comptes locaux candidats préconfigurés. Les valeurs possibles sont notConfigured , enabled et disabled . |
Réponse
En cas de réussite, cette méthode renvoie un code de réponse 201 Created
et un objet sharedPCConfiguration dans le corps de la réponse.
Exemple
Demande
Voici un exemple de demande.
POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations
Content-type: application/json
Content-length: 1920
{
"@odata.type": "#microsoft.graph.sharedPCConfiguration",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"supportsScopeTags": true,
"deviceManagementApplicabilityRuleOsEdition": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
"osEditionTypes": [
"windows10EnterpriseN"
],
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleOsVersion": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
"minOSVersion": "Min OSVersion value",
"maxOSVersion": "Max OSVersion value",
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleDeviceMode": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
"deviceMode": "sModeConfiguration",
"name": "Name value",
"ruleType": "exclude"
},
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"accountManagerPolicy": {
"@odata.type": "microsoft.graph.sharedPCAccountManagerPolicy",
"accountDeletionPolicy": "diskSpaceThreshold",
"cacheAccountsAboveDiskFreePercentage": 4,
"inactiveThresholdDays": 5,
"removeAccountsBelowDiskFreePercentage": 5
},
"allowedAccounts": "guest",
"localStorage": "enabled",
"allowLocalStorage": true,
"setAccountManager": "enabled",
"disableAccountManager": true,
"setEduPolicies": "enabled",
"disableEduPolicies": true,
"setPowerPolicies": "enabled",
"disablePowerPolicies": true,
"signInOnResume": "enabled",
"disableSignInOnResume": true,
"enabled": true,
"idleTimeBeforeSleepInSeconds": 12,
"kioskAppDisplayName": "Kiosk App Display Name value",
"kioskAppUserModelId": "Kiosk App User Model Id value",
"maintenanceStartTime": "11:59:24.7240000",
"fastFirstSignIn": "enabled"
}
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 201 Created
Content-Type: application/json
Content-Length: 2092
{
"@odata.type": "#microsoft.graph.sharedPCConfiguration",
"id": "5206be3b-be3b-5206-3bbe-06523bbe0652",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"supportsScopeTags": true,
"deviceManagementApplicabilityRuleOsEdition": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
"osEditionTypes": [
"windows10EnterpriseN"
],
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleOsVersion": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
"minOSVersion": "Min OSVersion value",
"maxOSVersion": "Max OSVersion value",
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleDeviceMode": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
"deviceMode": "sModeConfiguration",
"name": "Name value",
"ruleType": "exclude"
},
"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": "guest",
"localStorage": "enabled",
"allowLocalStorage": true,
"setAccountManager": "enabled",
"disableAccountManager": true,
"setEduPolicies": "enabled",
"disableEduPolicies": true,
"setPowerPolicies": "enabled",
"disablePowerPolicies": true,
"signInOnResume": "enabled",
"disableSignInOnResume": true,
"enabled": true,
"idleTimeBeforeSleepInSeconds": 12,
"kioskAppDisplayName": "Kiosk App Display Name value",
"kioskAppUserModelId": "Kiosk App User Model Id value",
"maintenanceStartTime": "11:59:24.7240000",
"fastFirstSignIn": "enabled"
}
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour