WindowsWifiEnterpriseEAPConfiguration の更新

[アーティクル]
02/01/2022

名前空間: microsoft.graph

大事な： Microsoft Graph /beta バージョンの API は変更される可能性があります。実稼働環境での使用はサポートされていません。

注: Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。

windowsWifiEnterpriseEAPConfiguration オブジェクトのプロパティを更新します。

前提条件

この 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	ベアラー <トークン> が必要です。
承諾	application/json

要求本文

要求本文で、 windowsWifiEnterpriseEAPConfiguration オブジェクトの JSON 表記を指定します。

次の表に、 windowsWifiEnterpriseEAPConfiguration を作成するときに必要なプロパティを示します。

プロパティ	種類	説明
id	String	エンティティのキー。 deviceConfiguration から継承します
lastModifiedDateTime	DateTimeOffset	オブジェクトの最終更新の DateTime。 deviceConfiguration から継承します
roleScopeTagIds	String collection	この Entity インスタンスのスコープタグの一覧。 deviceConfiguration から継承します
supportsScopeTags	ブール型	基になるデバイス構成がスコープタグの割り当てをサポートするかどうかを示します。 ScopeTags プロパティへの割り当ては、この値が false で、エンティティがスコープ付きユーザーに表示されない場合は許可されません。これは Silverlight で作成された従来のポリシーで発生し、Azure Portal でポリシーを削除して再作成することで解決できます。このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 deviceConfiguration から継承します
deviceManagementApplicabilityRuleOsEdition	deviceManagementApplicabilityRuleOsEdition	このポリシーの OS エディションの適用性。 deviceConfiguration から継承します
deviceManagementApplicabilityRuleOsVersion	deviceManagementApplicabilityRuleOsVersion	このポリシーの OS バージョンの適用ルール。 deviceConfiguration から継承します
deviceManagementApplicabilityRuleDeviceMode	deviceManagementApplicabilityRuleDeviceMode	このポリシーのデバイスモードの適用ルール。 deviceConfiguration から継承します
createdDateTime	DateTimeOffset	オブジェクトが作成された DateTime。 deviceConfiguration から継承します
説明	String	管理者が指定した、デバイス構成についての説明。 deviceConfiguration から継承します
displayName	String	管理者が指定した、デバイス構成の名前。 deviceConfiguration から継承します
version	Int32	デバイス構成のバージョン。 deviceConfiguration から継承します
preSharedKey	String	これは、WPA 個人用ネットワークの事前共有Wi-Fiです。 windowsWifiConfiguration から継承
wifiSecurityType	wiFiSecurityType	Wifi セキュリティの種類を指定します。 windowsWifiConfiguration から継承されます。使用可能な値: `open`、`wpaPersonal`、`wpaEnterprise`、`wep`、`wpa2Personal`、`wpa2Enterprise`。
meteredConnectionLimit	meteredConnectionLimitType	Wifi 接続のメーター接続制限の種類を指定します。 windowsWifiConfiguration から継承されます。可能な値は `unrestricted`、`fixed`、`variable` です。
ssid	String	Wifi 接続の SSID を指定します。 windowsWifiConfiguration から継承
networkName	String	ネットワーク構成名を指定します。 windowsWifiConfiguration から継承
connectAutomatically	ブール型	無線LAN接続が範囲内にあるときに自動的に接続するかどうかを指定します。 windowsWifiConfiguration から継承
connectToPreferredNetwork	ブール型	このネットワークに既に接続されている場合に、Wifi 接続を優先ネットワークに接続するかどうかを指定します。 ConnectAutomatically が true である必要があります。 windowsWifiConfiguration から継承
connectWhenNetworkNameIsHidden	ブール型	SSID がブロードキャストされていない場合でも、Wifi 接続を自動的に接続するかどうかを指定します。 windowsWifiConfiguration から継承
proxySetting	wiFiProxySetting	windowsWifiConfiguration から継承Wi-Fi構成のプロキシ設定を指定します。可能な値は `none`、`manual`、`automatic` です。
proxyManualAddress	文字列	プロキシサーバーの 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	ブール型	Wi-Fi 接続でペアワイズマスターキーキャッシュを有効にするかどうかを指定します。
maximumPairwiseMasterKeyCacheTimeInMinutes	Int32	ペアワイズマスターキーキャッシュの最大時間 (分) を指定します。有効な範囲: 5 ~ 1440
maximumNumberOfPairwiseMasterKeysInCache	Int32	キャッシュ内のペアワイズマスターキーの最大数を指定します。有効な範囲: 1 ~ 255
enablePreAuthentication	ブール型	事前認証を有効にするかどうかを指定します。
maximumPreAuthenticationAttempts	Int32	事前認証の最大試行回数を指定します。有効な範囲: 1 ~ 16
eapType	eapType	拡張認証プロトコル (EAP)。エンドポイント (ルーター) の EAP プロトコルセットWi-Fi示します。可能な値は、`eapTls`、`leap`、`eapSim`、`eapTtls`、`peap`、`eapFast`、`teap` です。
trustedServerCertificateNames	String コレクション	信頼できるサーバー証明書名を指定します。
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	Specifiy 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"
}

WindowsWifiEnterpriseEAPConfiguration の更新

前提条件

HTTP 要求

要求ヘッダー

要求本文

応答

例

要求

応答

フィードバック