windowsWifiEnterpriseEAPConfiguration を作成する

[アーティクル]
12/03/2023

名前空間: 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 要求

POST /deviceManagement/deviceConfigurations
POST /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations

要求ヘッダー

ヘッダー	値
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` です。

応答

成功した場合、このメソッドは応答コードと windowsWifiEnterpriseEAPConfiguration オブジェクトを応答本文に返201 Createdします。

例

要求

以下は、要求の例です。

POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations
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 201 Created
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"
}