WindowsWifiEnterpriseEAPConfiguration を更新する
名前空間: microsoft.graph
大事な: /beta バージョンの Microsoft Graph API は変更される可能性があります。運用環境での使用はサポートされていません。
注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。
windowsWifiEnterpriseEAPConfiguration オブジェクトのプロパティを更新します。
この API は、次の国内クラウド展開で使用できます。
グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
---|---|
委任 (職場または学校のアカウント) | DeviceManagementConfiguration.ReadWrite.All |
委任 (個人用 Microsoft アカウント) | サポートされていません。 |
アプリケーション | DeviceManagementConfiguration.ReadWrite.All |
HTTP 要求
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/groupAssignments/{deviceConfigurationGroupAssignmentId}/deviceConfiguration
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations/{deviceConfigurationId}
要求ヘッダー
ヘッダー | 値 |
---|---|
Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
承諾 | application/json |
要求本文
要求本文で、 windowsWifiEnterpriseEAPConfiguration オブジェクトの JSON 表現を指定します。
次の表は、 windowsWifiEnterpriseEAPConfiguration を作成するときに必要なプロパティを示しています。
プロパティ | 型 | 説明 |
---|---|---|
id | String | エンティティのキー。 deviceConfiguration から継承します |
lastModifiedDateTime | DateTimeOffset | オブジェクトの最終更新の DateTime。 deviceConfiguration から継承します |
roleScopeTagIds | String collection | このエンティティ インスタンスのスコープ タグの一覧。 deviceConfiguration から継承します |
supportsScopeTags | ブール型 | 基になるデバイス構成がスコープ タグの割り当てをサポートするかどうかを示します。 ScopeTags プロパティへの割り当ては、この値が false であり、スコープ付きユーザーにエンティティが表示されない場合は許可されません。 これは Silverlight で作成されたレガシ ポリシーに対して発生し、Azure Portal でポリシーを削除して再作成することで解決できます。 このプロパティは読み取り専用です。 deviceConfiguration から継承します |
deviceManagementApplicabilityRuleOsEdition | deviceManagementApplicabilityRuleOsEdition | このポリシーの OS エディションの適用性。 deviceConfiguration から継承します |
deviceManagementApplicabilityRuleOsVersion | deviceManagementApplicabilityRuleOsVersion | このポリシーの OS バージョンの適用規則。 deviceConfiguration から継承します |
deviceManagementApplicabilityRuleDeviceMode | deviceManagementApplicabilityRuleDeviceMode | このポリシーのデバイス モードの適用規則。 deviceConfiguration から継承します |
createdDateTime | DateTimeOffset | オブジェクトが作成された DateTime。 deviceConfiguration から継承します |
description | String | 管理者が指定した、デバイス構成についての説明。 deviceConfiguration から継承します |
displayName | String | 管理者が指定した、デバイス構成の名前。 deviceConfiguration から継承します |
version | Int32 | デバイス構成のバージョン。 deviceConfiguration から継承します |
preSharedKey | String | これは、WPA Personal Wi-Fi ネットワークの事前共有キーです。 windowsWifiConfiguration から継承 |
wifiSecurityType | wiFiSecurityType | Wifi セキュリティの種類を指定します。
windowsWifiConfiguration から継承されます。 使用可能な値: open 、wpaPersonal 、wpaEnterprise 、wep 、wpa2Personal 、wpa2Enterprise 。 |
meteredConnectionLimit | meteredConnectionLimitType | Wifi 接続の従量制課金接続制限の種類を指定します。
windowsWifiConfiguration から継承されます。 可能な値は unrestricted 、fixed 、variable です。 |
ssid | String | 無線LAN接続のSSIDを指定します。 windowsWifiConfiguration から継承 |
networkName | String | ネットワーク構成名を指定します。 windowsWifiConfiguration から継承 |
connectAutomatically | ブール型 | 範囲内で Wifi 接続を自動的に接続するかどうかを指定します。 windowsWifiConfiguration から継承 |
connectToPreferredNetwork | ブール型 | このネットワークに既に接続されている場合に、Wifi 接続をより優先するネットワークに接続するかどうかを指定します。 ConnectAutomatically を true にする必要があります。 windowsWifiConfiguration から継承 |
connectWhenNetworkNameIsHidden | ブール型 | SSID がブロードキャストされていない場合でも、Wifi 接続を自動的に接続するかどうかを指定します。 windowsWifiConfiguration から継承 |
proxySetting | wiFiProxySetting |
windowsWifiConfiguration から継承 Wi-Fi 構成のプロキシ設定を指定します。 使用可能な値: none 、manual 、automatic 、unknownFutureValue 。 |
proxyManualAddress | String | プロキシ サーバーの IP アドレスを指定します。 windowsWifiConfiguration から継承 |
proxyManualPort | Int32 | プロキシ サーバーのポートを指定します。 windowsWifiConfiguration から継承 |
proxyAutomaticConfigurationUrl | String | プロキシ サーバー構成スクリプトの URL を指定します。 windowsWifiConfiguration から継承 |
forceFIPSCompliance | ブール型 | FIPS コンプライアンスを強制するかどうかを指定します。 windowsWifiConfiguration から継承 |
networkSingleSignOn | networkSingleSignOnType | ネットワーク シングル サインオンの種類を指定します。 可能な値は disabled 、prelogon 、postlogon です。 |
maximumAuthenticationTimeoutInSeconds | Int32 | 最大認証タイムアウト (秒単位) を指定します。 有効な範囲: 1 から 120 |
userBasedVirtualLan | ブール型 | ユーザーの資格情報に基づいてデバイスで使用される仮想 LAN を変更するかどうかを指定します。 NetworkSingleSignOnType が [無効] に設定されている場合は使用できません。 |
promptForAdditionalAuthenticationCredentials | ブール型 | Wifi 接続で追加の認証資格情報の入力を求めるかどうかを指定します。 |
enablePairwiseMasterKeyCaching | ブール型 | Wifi 接続でペアごとのマスター キー キャッシュを有効にするかどうかを指定します。 |
maximumPairwiseMasterKeyCacheTimeInMinutes | Int32 | ペアごとのマスター キーキャッシュの最大時間 (分単位) を指定します。 有効な範囲: 5 から 1440 |
maximumNumberOfPairwiseMasterKeysInCache | Int32 | キャッシュ内のペアごとのマスター キーの最大数を指定します。 有効な範囲: 1 から 255 |
enablePreAuthentication | ブール型 | 事前認証を有効にするかどうかを指定します。 |
maximumPreAuthenticationAttempts | Int32 | 認証前の最大試行回数を指定します。 有効な範囲: 1 から 16 |
eapType | eapType | 拡張認証プロトコル (EAP)。 Wi-Fi エンドポイント (ルーター) に設定されている EAP プロトコルの種類を示します。 可能な値は、eapTls 、leap 、eapSim 、eapTtls 、peap 、eapFast 、teap です。 |
trustedServerCertificateNames | String collection | 信頼されたサーバー証明書名を指定します。 |
authenticationMethod | wiFiAuthenticationMethod | 認証方法を指定します。 可能な値は certificate 、usernameAndPassword 、derivedCredential です。 |
innerAuthenticationProtocolForEAPTTLS | nonEapAuthenticationMethodForEapTtlsType | EAP TTLS の内部認証プロトコルを指定します。 使用可能な値: unencryptedPassword 、challengeHandshakeAuthenticationProtocol 、microsoftChap 、microsoftChapVersionTwo 。 |
outerIdentityPrivacyTemporaryValue | String | EAP TTLS または PEAP を使用する場合は、プライバシーのためにユーザー名を置き換える文字列を指定します。 |
requireCryptographicBinding | ブール型 | EAP の種類が PEAP として選択されている場合に暗号化バインドを有効にするかどうかを指定します。 |
performServerValidation | ブール型 | EAP の種類が PEAP として選択されている場合に証明書を検証して、サーバーの ID の検証を有効にするかどうかを指定します。 |
disableUserPromptForServerValidation | ブール型 | EAP の種類が PEAP として選択されている場合に、信頼された証明機関の新しいサーバーの承認を求めるメッセージがユーザーに表示されないようにするかどうかを指定します。 |
authenticationPeriodInSeconds | Int32 | クライアントが認証試行後に待機してから失敗するまでの秒数を指定します。 有効な範囲は 1 から 3600 です。 |
authenticationRetryDelayPeriodInSeconds | Int32 | 認証の失敗から次の認証試行までの秒数を指定します。 有効な範囲は 1 から 3600 です。 |
eapolStartPeriodInSeconds | Int32 | EAPOL (LAN 経由の拡張認証プロトコル) 開始メッセージを送信するまでに待機する秒数を指定します。 有効な範囲は 1 から 3600 です。 |
maximumEAPOLStartMessages | Int32 | EAPOL (LAN 経由の拡張認証プロトコル) の最大数を指定する エラーを返す前に送信するメッセージを開始します。 有効な範囲は 1 から 100 です。 |
maximumAuthenticationFailures | Int32 | 資格情報のセットで許可される最大認証エラー数を指定します。 有効な範囲は 1 から 100 です。 |
cacheCredentials | ブール型 | ユーザーが接続するたびにユーザーの資格情報を入力し続ける必要がないように、デバイスにユーザー資格情報をキャッシュするかどうかを指定します。 |
authenticationType | wifiAuthenticationType | ユーザー、デバイスを認証するか、ゲスト認証 (なし) を使用するかを指定します。 証明書認証を使用している場合は、証明書の種類が認証の種類と一致していることを確認します。 可能な値は、none 、user 、machine 、machineOrUser 、guest です。 |
応答
成功した場合、このメソッドは 200 OK
応答コードと更新された windowsWifiEnterpriseEAPConfiguration オブジェクトを応答本文に返します。
例
要求
以下は、要求の例です。
PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId}
Content-type: application/json
Content-length: 2695
{
"@odata.type": "#microsoft.graph.windowsWifiEnterpriseEAPConfiguration",
"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,
"preSharedKey": "Pre Shared Key value",
"wifiSecurityType": "wpaPersonal",
"meteredConnectionLimit": "fixed",
"ssid": "Ssid value",
"networkName": "Network Name value",
"connectAutomatically": true,
"connectToPreferredNetwork": true,
"connectWhenNetworkNameIsHidden": true,
"proxySetting": "manual",
"proxyManualAddress": "Proxy Manual Address value",
"proxyManualPort": 15,
"proxyAutomaticConfigurationUrl": "https://example.com/proxyAutomaticConfigurationUrl/",
"forceFIPSCompliance": true,
"networkSingleSignOn": "prelogon",
"maximumAuthenticationTimeoutInSeconds": 5,
"userBasedVirtualLan": true,
"promptForAdditionalAuthenticationCredentials": true,
"enablePairwiseMasterKeyCaching": true,
"maximumPairwiseMasterKeyCacheTimeInMinutes": 10,
"maximumNumberOfPairwiseMasterKeysInCache": 8,
"enablePreAuthentication": true,
"maximumPreAuthenticationAttempts": 0,
"eapType": "leap",
"trustedServerCertificateNames": [
"Trusted Server Certificate Names value"
],
"authenticationMethod": "usernameAndPassword",
"innerAuthenticationProtocolForEAPTTLS": "challengeHandshakeAuthenticationProtocol",
"outerIdentityPrivacyTemporaryValue": "Outer Identity Privacy Temporary Value value",
"requireCryptographicBinding": true,
"performServerValidation": true,
"disableUserPromptForServerValidation": true,
"authenticationPeriodInSeconds": 13,
"authenticationRetryDelayPeriodInSeconds": 7,
"eapolStartPeriodInSeconds": 9,
"maximumEAPOLStartMessages": 9,
"maximumAuthenticationFailures": 13,
"cacheCredentials": true,
"authenticationType": "user"
}
応答
以下は、応答の例です。 注: 簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。 実際の呼び出しではすべてのプロパティが返されます。
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 2867
{
"@odata.type": "#microsoft.graph.windowsWifiEnterpriseEAPConfiguration",
"id": "7e7183ac-83ac-7e71-ac83-717eac83717e",
"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,
"preSharedKey": "Pre Shared Key value",
"wifiSecurityType": "wpaPersonal",
"meteredConnectionLimit": "fixed",
"ssid": "Ssid value",
"networkName": "Network Name value",
"connectAutomatically": true,
"connectToPreferredNetwork": true,
"connectWhenNetworkNameIsHidden": true,
"proxySetting": "manual",
"proxyManualAddress": "Proxy Manual Address value",
"proxyManualPort": 15,
"proxyAutomaticConfigurationUrl": "https://example.com/proxyAutomaticConfigurationUrl/",
"forceFIPSCompliance": true,
"networkSingleSignOn": "prelogon",
"maximumAuthenticationTimeoutInSeconds": 5,
"userBasedVirtualLan": true,
"promptForAdditionalAuthenticationCredentials": true,
"enablePairwiseMasterKeyCaching": true,
"maximumPairwiseMasterKeyCacheTimeInMinutes": 10,
"maximumNumberOfPairwiseMasterKeysInCache": 8,
"enablePreAuthentication": true,
"maximumPreAuthenticationAttempts": 0,
"eapType": "leap",
"trustedServerCertificateNames": [
"Trusted Server Certificate Names value"
],
"authenticationMethod": "usernameAndPassword",
"innerAuthenticationProtocolForEAPTTLS": "challengeHandshakeAuthenticationProtocol",
"outerIdentityPrivacyTemporaryValue": "Outer Identity Privacy Temporary Value value",
"requireCryptographicBinding": true,
"performServerValidation": true,
"disableUserPromptForServerValidation": true,
"authenticationPeriodInSeconds": 13,
"authenticationRetryDelayPeriodInSeconds": 7,
"eapolStartPeriodInSeconds": 9,
"maximumEAPOLStartMessages": 9,
"maximumAuthenticationFailures": 13,
"cacheCredentials": true,
"authenticationType": "user"
}