macOSWiFiConfiguration resource type

Important: APIs under the / beta version in Microsoft Graph are in preview and are subject to change. Use of these APIs in production applications is not supported. 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

Methods

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 List properties and relationships of the deviceConfigurationGroupAssignment objects.
List deviceConfigurationDeviceStatuses deviceConfigurationDeviceStatus collection List properties and relationships of the deviceConfigurationDeviceStatus objects.
List deviceConfigurationUserStatuses deviceConfigurationUserStatus collection List properties and relationships of the deviceConfigurationUserStatus objects.
Get deviceConfigurationDeviceOverview deviceConfigurationDeviceOverview Read properties and relationships of the deviceConfigurationDeviceOverview object.
Get deviceConfigurationUserOverview deviceConfigurationUserOverview Read properties and relationships of the deviceConfigurationUserOverview object.
List settingStateDeviceSummaries settingStateDeviceSummary collection List properties and relationships of the settingStateDeviceSummary objects.

Properties

Property Type Description
id String Key of the entity. Inherited from deviceConfiguration
lastModifiedDateTime DateTimeOffset DateTime the object was last modified. Inherited from deviceConfiguration
assignmentStatus String Read-only. DateTime the object was last modified. Inherited from deviceConfiguration
assignmentProgress String Read-only. DateTime the object was last modified. Inherited from deviceConfiguration
assignmentErrorMessage String Read-only. 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.
preSharedKey String This is the pre-shared key for WPA Personal Wi-Fi network.

Relationships

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)",
  "assignmentStatus": "String",
  "assignmentProgress": "String",
  "assignmentErrorMessage": "String",
  "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",
  "preSharedKey": "String"
}