Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Espace de noms: microsoft.graph
Important : Microsoft prend en charge les API Intune /beta, mais elles sont sujettes à des modifications plus fréquentes. Microsoft recommande d’utiliser la version v1.0 lorsque cela est possible. Vérifiez la disponibilité d’une API dans la version v1.0 à l’aide du sélecteur de version.
Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.
Créez un objet androidWorkProfileWiFiConfiguration .
Cette API est disponible dans les déploiements cloud nationaux suivants.
| Service global | Gouvernement américain L4 | Gouvernement américain L5 (DOD) | Chine exploité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 les autorisations. |
| Accepter | application/json |
Corps de la demande
Dans le corps de la demande, fournissez une représentation JSON pour l’objet androidWorkProfileWiFiConfiguration.
Le tableau suivant indique les propriétés qui sont requises lorsque vous créez androidWorkProfileWiFiConfiguration.
| 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 | Booléen | Indique si la configuration de l’appareil sous-jacente prend en charge ou non l’attribution de balises d’étendue. L’affectation à la propriété ScopeTags n’est pas autorisée lorsque cette valeur est false et les entités ne seront pas visibles par les utilisateurs délimités. Ce problème 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 | La 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. |
| networkName | String | Nom du réseau Wi-Fi. |
| ID SSID | String | Il s’agit du nom du réseau Wi-Fi qui est diffusé sur tous les appareils. |
| connectAutomatically | Booléen | Lorsqu’il est défini sur true, l’appareil se connecte automatiquement au réseau Wi-Fi lorsqu’il se trouve dans sa portée, en ignorant l’invite de l’utilisateur. Lorsque la valeur est false, l’utilisateur doit se connecter manuellement via les Paramètres sur l’appareil Android. La valeur par défaut est false. |
| connectWhenNetworkNameIsHidden | Booléen | Lorsqu’il est défini sur true, ce profil force l’appareil à se connecter à un réseau qui ne diffuse pas son SSID à tous les appareils. Lorsque la valeur est false, l’appareil ne se connecte pas automatiquement aux réseaux cachés. La valeur par défaut est false. |
| wiFiSecurityType | androidWiFiSecurityType | Types de sécurité possibles pour les profils Wi-Fi Android. La valeur par défaut Ouvert indique qu’aucune authentification n’est requise pour le réseau. Les protocoles de sécurité pris en charge sont WEP, WPA et WPA2. Les options WpaEnterprise et WPA2Enterprise sont disponibles pour les profils Wi-Fi Entreprise. Les options Wep et WpaPersonal (prend en charge WPA et WPA2) sont disponibles pour les profils Wi-Fi de base. Les valeurs possibles sont open, wpaEnterprise, wpa2Enterprise, wep, wpaPersonal, unknownFutureValue. |
| preSharedKey | String | Spécifiez la clé pré-partagée pour un réseau de Wi-Fi personnel WEP ou WPA. Les restrictions dépendent de la valeur définie pour wiFiSecurityType. Si une sécurité de type WEP est utilisée, la préSharedKey doit être une phrase secrète valide (5 ou 13 caractères) ou une clé HEX valide (10 ou 26 caractères hexadécimaux). Si le type de sécurité WPA est utilisé, preSharedKey peut être une chaîne de caractères comprise entre 8 et 64 caractères. |
| preSharedKeyIsSet | Booléen | Lorsqu’elle est définie sur true, indique que la clé pré-partagée est configurée. Lorsque la valeur est false, indique que la clé pré-partagée n’est pas configurée (toutes les valeurs définies pour preSharedKey seront ignorées). La valeur par défaut est false. |
| proxySettings | wiFiProxySetting | Type de proxy pour cette connexion Wi-Fi. Les valeurs possibles sont les suivantes : none, manual, automatic, unknownFutureValue. |
| proxyAutomaticConfigurationUrl | String | URL du script de configuration automatique du serveur proxy lorsque la configuration automatique est sélectionnée. Cette URL est généralement l’emplacement du fichier PAC (Proxy Auto Configuration). |
Réponse
En cas de réussite, cette méthode renvoie un 201 Created code de réponse et un objet androidWorkProfileWiFiConfiguration 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: 1414
{
"@odata.type": "#microsoft.graph.androidWorkProfileWiFiConfiguration",
"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,
"networkName": "Network Name value",
"ssid": "Ssid value",
"connectAutomatically": true,
"connectWhenNetworkNameIsHidden": true,
"wiFiSecurityType": "wpaEnterprise",
"preSharedKey": "Pre Shared Key value",
"preSharedKeyIsSet": true,
"proxySettings": "manual",
"proxyAutomaticConfigurationUrl": "https://example.com/proxyAutomaticConfigurationUrl/"
}
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: 1586
{
"@odata.type": "#microsoft.graph.androidWorkProfileWiFiConfiguration",
"id": "8400d131-d131-8400-31d1-008431d10084",
"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,
"networkName": "Network Name value",
"ssid": "Ssid value",
"connectAutomatically": true,
"connectWhenNetworkNameIsHidden": true,
"wiFiSecurityType": "wpaEnterprise",
"preSharedKey": "Pre Shared Key value",
"preSharedKeyIsSet": true,
"proxySettings": "manual",
"proxyAutomaticConfigurationUrl": "https://example.com/proxyAutomaticConfigurationUrl/"
}