macOSWiFiConfiguration resource type

Note: Using the Microsoft Graph APIs to configure Intune controls and policies still requires that the Intune service is correctly licensed by the customer.

By providing the configurations in this profile you can instruct the macOS device to connect to desired Wi-Fi endpoint. By specifying the authentication method and security types expected by Wi-Fi endpoint you can make the Wi-Fi connection seamless for end user.

Inherits from deviceConfiguration


Method Return Type Description
List macOSWiFiConfigurations macOSWiFiConfiguration collection List properties and relationships of the macOSWiFiConfiguration objects.
Get macOSWiFiConfiguration macOSWiFiConfiguration Read properties and relationships of the macOSWiFiConfiguration object.
Create macOSWiFiConfiguration macOSWiFiConfiguration Create a new macOSWiFiConfiguration object.
Delete macOSWiFiConfiguration None Deletes a macOSWiFiConfiguration.
Update macOSWiFiConfiguration macOSWiFiConfiguration Update the properties of a macOSWiFiConfiguration object.
List deviceConfigurationGroupAssignments deviceConfigurationGroupAssignment collection Get the deviceConfigurationGroupAssignments from the groupAssignments navigation property.
List deviceConfigurationDeviceStatuses deviceConfigurationDeviceStatus collection Get the deviceConfigurationDeviceStatuses from the deviceStatuses navigation property.
List deviceConfigurationUserStatuses deviceConfigurationUserStatus collection Get the deviceConfigurationUserStatuses from the userStatuses navigation property.
Get deviceConfigurationDeviceOverview deviceConfigurationDeviceOverview Get the deviceConfigurationDeviceOverview from the deviceStatusOverview navigation property.
Get deviceConfigurationUserOverview deviceConfigurationUserOverview Get the deviceConfigurationUserOverview from the userStatusOverview navigation property.
List settingStateDeviceSummaries settingStateDeviceSummary collection Get the settingStateDeviceSummaries from the deviceSettingStateSummaries navigation property.


Property Type Description
id String Key of the entity. Inherited from deviceConfiguration
lastModifiedDateTime DateTimeOffset DateTime the object was last modified. Inherited from deviceConfiguration
createdDateTime DateTimeOffset DateTime the object was created. Inherited from deviceConfiguration
description String Admin provided description of the Device Configuration. Inherited from deviceConfiguration
displayName String Admin provided name of the device configuration. Inherited from deviceConfiguration
version Int32 Version of the device configuration. Inherited from deviceConfiguration
networkName String Network Name
ssid String This is the name of the Wi-Fi network that is broadcast to all devices.
connectAutomatically Boolean Connect automatically when this network is in range. Setting this to true will skip the user prompt and automatically connect the device to Wi-Fi network.
connectWhenNetworkNameIsHidden Boolean Connect when the network is not broadcasting its name (SSID). When set to true, this profile forces the device to connect to a network that doesn't broadcast its SSID to all devices.
wiFiSecurityType String Indicates whether Wi-Fi endpoint uses an EAP based security type. Possible values are: open, wpaPersonal, wpaEnterprise, wep.
proxySettings String Proxy Type for this Wi-Fi connection Possible values are: none, manual, automatic.
proxyManualAddress String IP Address or DNS hostname of the proxy server when manual configuration is selected.
proxyManualPort Int32 Port of the proxy server when manual configuration is selected.
proxyAutomaticConfigurationUrl String URL of the proxy server automatic configuration script when automatic configuration is selected. This URL is typically the location of PAC (Proxy Auto Configuration) file.


Relationship Type Description
groupAssignments deviceConfigurationGroupAssignment collection The list of group assignments for the device configuration profile. Inherited from deviceConfiguration
deviceStatuses deviceConfigurationDeviceStatus collection Device configuration installation stauts by device. Inherited from deviceConfiguration
userStatuses deviceConfigurationUserStatus collection Device configuration installation stauts by user. Inherited from deviceConfiguration
deviceStatusOverview deviceConfigurationDeviceOverview Device Configuration devices status overview Inherited from deviceConfiguration
userStatusOverview deviceConfigurationUserOverview Device Configuration users status overview Inherited from deviceConfiguration
deviceSettingStateSummaries settingStateDeviceSummary collection Device Configuration Setting State Device Summary Inherited from deviceConfiguration

JSON Representation

Here is a JSON representation of the resource.

  "@odata.type": "#microsoft.graph.macOSWiFiConfiguration",
  "id": "String (identifier)",
  "lastModifiedDateTime": "String (timestamp)",
  "createdDateTime": "String (timestamp)",
  "description": "String",
  "displayName": "String",
  "version": 1024,
  "networkName": "String",
  "ssid": "String",
  "connectAutomatically": true,
  "connectWhenNetworkNameIsHidden": true,
  "wiFiSecurityType": "String",
  "proxySettings": "String",
  "proxyManualAddress": "String",
  "proxyManualPort": 1024,
  "proxyAutomaticConfigurationUrl": "String"