UserWindowsSettings.Read.All

Allows the app to read a user's windows settings which are stored in cloud and their values on behalf of the signed-in user.

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the UserWindowsSettings.Read.All permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category	Application	Delegated
Identifier	-	77e07bab-1b34-40a5-bb6c-4b197b3f6027
DisplayText	-	Read windows settings for all devices
Description	-	Allows the app to read a user's windows settings which are stored in cloud and their values on behalf of the signed-in user.
AdminConsentRequired	Yes	Yes

Graph Methods

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	GET /users/{user-id}@{tenant-id}/settings/windows
	GET /users/{user-id}@{tenant-id}/settings/windows/{windowsSettingId}
	GET /users/{user-id}@{tenant-id}/settings/windows/{windowsSettingId}/instances
	GET /users/{user-id}@{tenant-id}/settings/windows/{windowsSettingId}/instances/{windowsSettingInstanceId}

→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)

	Commands
	Get-MgBetaUserSettingWindows
	Get-MgBetaUserSettingWindowsInstance

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

Graph reference: enums

Graph reference: windowsSetting

Property	Type	Description
id	String	The unique identifier of the object.
payloadType	String	The type of setting payloads contained in the instances navigation property.
settingType	windowsSettingType	The type of setting. Possible values are: `roaming`, `backup`, `unknownFutureValue`.
windowsDeviceId	String	A unique identifier for the device the setting might belong to if it is of the **s

Graph reference: windowsSettingInstance

Property	Type	Description
createdDateTime	DateTimeOffset	Set by the server. Represents the dateTime in UTC when the object was created on the server.
expirationDateTime	DateTimeOffset	Set by the server. The object expires at the specified dateTime in UTC, making it unavailable after that time.
id	String	The unique identifier of the object. Inherited from entity.
lastModifiedDateTime	DateTimeOffset	Set by the server if not provided in the request from the Windows client device. Refers to the user's Windows device that modified the object at the specified dateTime in UTC.
payload	String	Base64-encoded JSON setting value.

Table of Contents

UserWindowsSettings.Read.All

Graph Methods

Resources