androidDeviceOwnerEnterpriseWiFiConfiguration aktualisieren
Namespace: microsoft.graph
Wichtig: Microsoft Graph-APIs unter der /beta-Version können geändert werden. Die Produktionsverwendung wird nicht unterstützt.
Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.
Aktualisieren Sie die Eigenschaften eines androidDeviceOwnerEnterpriseWiFiConfiguration-Objekts .
Voraussetzungen
Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema 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
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/groupAssignments/{deviceConfigurationGroupAssignmentId}/deviceConfiguration
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations/{deviceConfigurationId}
Anforderungsheader
| Kopfzeile | Wert |
|---|---|
| Authorization | Bearer<token> erforderlich |
| Annehmen | application/json |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung des Objekts des Typs "androidDeviceOwnerEnterpriseWiFiConfiguration" an .
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die zum Erstellen der androidDeviceOwnerEnterpriseWiFiConfiguration erforderlich sind.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| id | String | Schlüssel der Entität Geerbt von deviceConfiguration. |
| lastModifiedDateTime | DateTimeOffset | Datum und Uhrzeit der letzten Änderung des Objekts. Geerbt von deviceConfiguration. |
| roleScopeTagIds | String collection | Liste der Bereichstags für diese Entitätsinstanz. Geerbt von deviceConfiguration. |
| supportsScopeTags | Boolean | Gibt an, ob die zugrunde liegende Gerätekonfiguration die Zuweisung von Bereichstags unterstützt. Das Zuweisen der ScopeTags-Eigenschaft ist nicht zulässig, wenn dieser Wert falsch ist und Entitäten für Benutzer mit Bereich nicht sichtbar sind. Dies gilt für Legacyrichtlinien, die in Silverlight erstellt wurden, und kann durch Löschen und Erneutes Erstellen der Richtlinie im Azure-Portal behoben werden. Diese Eigenschaft ist schreibgeschützt. Geerbt von deviceConfiguration. |
| deviceManagementApplicabilityRuleOsEdition | deviceManagementApplicabilityRuleOsEdition | Die Anwendbarkeit der Betriebssystemedition für diese Richtlinie. Geerbt von deviceConfiguration. |
| deviceManagementApplicabilityRuleOsVersion | deviceManagementApplicabilityRuleOsVersion | Die Anwendbarkeitsregel für die Betriebssystemversion für diese Richtlinie. Geerbt von deviceConfiguration. |
| deviceManagementApplicabilityRuleDeviceMode | deviceManagementApplicabilityRuleDeviceMode | Die Gerätemodus-Anwendbarkeitsregel für diese Richtlinie. Geerbt von deviceConfiguration. |
| createdDateTime | DateTimeOffset | Datum und Uhrzeit der Erstellung des Objekts. Geerbt von deviceConfiguration. |
| description | String | Beschreibung der Gerätekonfiguration (vom Administrator festgelegt). Geerbt von deviceConfiguration. |
| displayName | String | Name der Gerätekonfiguration (vom Administrator festgelegt). Geerbt von deviceConfiguration. |
| Version | Int32 | Version der Gerätekonfiguration. Geerbt von deviceConfiguration. |
| networkName | String | Netzwerkname geerbt von androidDeviceOwnerWiFiConfiguration |
| Ssid | String | Dies ist der Name des Wi-Fi Netzwerks, das auf allen Geräten übertragen wird. Geerbt von "androidDeviceOwnerWiFiConfiguration" |
| connectAutomatically | Boolean | Verbinden automatisch, wenn sich dieses Netzwerk im Bereich befindet. Wenn Sie diesen Wert auf "true" festlegen, wird die Benutzeraufforderung übersprungen und das Gerät automatisch mit Wi-Fi Netzwerk verbunden. Geerbt von "androidDeviceOwnerWiFiConfiguration" |
| connectWhenNetworkNameIsHidden | Boolesch | Bei Festlegung auf "true" erzwingt dieses Profil, dass das Gerät eine Verbindung mit einem Netzwerk herstellt, das seine SSID nicht an alle Geräte überträgt. Geerbt von "androidDeviceOwnerWiFiConfiguration" |
| wiFiSecurityType | androidDeviceOwnerWiFiSecurityType | Gibt an, ob Wi-Fi Endpunkt einen EAP-basierten Sicherheitstyp verwendet. Geerbt von "androidDeviceOwnerWiFiConfiguration". Mögliche Werte: open, wep, wpaPersonal, wpaEnterprise |
| preSharedKey | String | Dies ist der vorab freigegebene Schlüssel für WPA Personal Wi-Fi Netzwerk. Geerbt von "androidDeviceOwnerWiFiConfiguration" |
| preSharedKeyIsSet | Boolean | Dies ist der vorab freigegebene Schlüssel für WPA Personal Wi-Fi Netzwerk. Geerbt von "androidDeviceOwnerWiFiConfiguration" |
| proxySettings | wiFiProxySetting | Geben Sie die Proxyeinstellung für Wi-Fi Konfiguration an. Mögliche Werte sind keine, manuelle und automatische. Geerbt von "androidDeviceOwnerWiFiConfiguration". Mögliche Werte sind: none, manual und automatic. |
| proxyManualAddress | String | Geben Sie die IP-Adresse des Proxyservers an. Android Dokumentation gibt weder IPv4 noch IPv6 an. Beispiel: 192.168.1.1. Geerbt von "androidDeviceOwnerWiFiConfiguration" |
| proxyManualPort | Int32 | Geben Sie den Proxyserverport an. Geerbt von "androidDeviceOwnerWiFiConfiguration" |
| proxyAutomaticConfigurationUrl | String | Geben Sie die Proxyserver-Konfigurationsskript-URL an. Geerbt von "androidDeviceOwnerWiFiConfiguration" |
| proxyExclusionList | String | Liste der auszuschließenden Hosts mithilfe des Proxys für Verbindungen. Diese Hosts können Platzhalter wie *.example.com verwenden. Geerbt von "androidDeviceOwnerWiFiConfiguration" |
| eapType | androidEapType | Gibt den Typ des EAP-Protokollsatzes auf dem Wi-Fi Endpunkt (Router) an. Mögliche Werte sind: eapTls, eapTtls und peap. |
| trustedServerCertificateNames | Zeichenfolgensammlung | Vertrauenswürdige Serverzertifikatnamen, wenn der EAP-Typ in EAP-TLS/TTLS/FAST oder PEAP konfiguriert ist. Dies ist der allgemeine Name, der in den von Ihrer vertrauenswürdigen Zertifizierungsstelle ausgestellten Zertifikaten verwendet wird. Wenn Sie diese Informationen angeben, können Sie das Dialogfeld "Dynamische Vertrauensstellung" umgehen, das auf den Geräten der Endbenutzer angezeigt wird, wenn sie eine Verbindung mit diesem Wi-Fi Netzwerk herstellen. |
| authenticationMethod | wiFiAuthenticationMethod | Gibt die Authentifizierungsmethode an, die der Client (Gerät) verwenden muss, wenn der EAP-Typ für PEAP oder EAP-TTLS konfiguriert ist. Mögliche Werte sind: certificate, usernameAndPassword und derivedCredential. |
| innerAuthenticationProtocolForEapTtls | nonEapAuthenticationMethodForEapTtlsType | Nicht-EAP-Methode für die Authentifizierung (innere Identität), wenn EAP-Typ EAP-TTLS und Authenticationmethod Benutzername und Kennwort ist. Mögliche Werte: unencryptedPassword, challengeHandshakeAuthenticationProtocol, microsoftChap, microsoftChapVersionTwo |
| innerAuthenticationProtocolForPeap | nonEapAuthenticationMethodForPeap | Nicht-EAP-Methode für die Authentifizierung (innere Identität), wenn EAP-Typ PEAP und Authenticationmethod Benutzername und Kennwort ist. Mögliche Werte sind: none und microsoftChapVersionTwo. |
| outerIdentityPrivacyTemporaryValue | String | Aktivieren Sie den Identitätsschutz (Outer Identity), wenn der EAP-Typ für EAP-TTLS oder PEAP konfiguriert ist. Die hier bereitgestellte Zeichenfolge wird verwendet, um den Benutzernamen einzelner Benutzer zu maskieren, wenn sie versuchen, eine Verbindung mit Wi-Fi Netzwerk herzustellen. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den 200 OK Antwortcode und ein aktualisiertes Objekt des Typs "androidDeviceOwnerEnterpriseWiFiConfiguration " im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId}
Content-type: application/json
Content-length: 1960
{
"@odata.type": "#microsoft.graph.androidDeviceOwnerEnterpriseWiFiConfiguration",
"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": "wep",
"preSharedKey": "Pre Shared Key value",
"preSharedKeyIsSet": true,
"proxySettings": "manual",
"proxyManualAddress": "Proxy Manual Address value",
"proxyManualPort": 15,
"proxyAutomaticConfigurationUrl": "https://example.com/proxyAutomaticConfigurationUrl/",
"proxyExclusionList": "Proxy Exclusion List value",
"eapType": "eapTtls",
"trustedServerCertificateNames": [
"Trusted Server Certificate Names value"
],
"authenticationMethod": "usernameAndPassword",
"innerAuthenticationProtocolForEapTtls": "challengeHandshakeAuthenticationProtocol",
"innerAuthenticationProtocolForPeap": "microsoftChapVersionTwo",
"outerIdentityPrivacyTemporaryValue": "Outer Identity Privacy Temporary Value value"
}
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 200 OK
Content-Type: application/json
Content-Length: 2132
{
"@odata.type": "#microsoft.graph.androidDeviceOwnerEnterpriseWiFiConfiguration",
"id": "7ef0d9c3-d9c3-7ef0-c3d9-f07ec3d9f07e",
"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": "wep",
"preSharedKey": "Pre Shared Key value",
"preSharedKeyIsSet": true,
"proxySettings": "manual",
"proxyManualAddress": "Proxy Manual Address value",
"proxyManualPort": 15,
"proxyAutomaticConfigurationUrl": "https://example.com/proxyAutomaticConfigurationUrl/",
"proxyExclusionList": "Proxy Exclusion List value",
"eapType": "eapTtls",
"trustedServerCertificateNames": [
"Trusted Server Certificate Names value"
],
"authenticationMethod": "usernameAndPassword",
"innerAuthenticationProtocolForEapTtls": "challengeHandshakeAuthenticationProtocol",
"innerAuthenticationProtocolForPeap": "microsoftChapVersionTwo",
"outerIdentityPrivacyTemporaryValue": "Outer Identity Privacy Temporary Value value"
}
Feedback
Feedback senden und anzeigen für