Microsoft.Graph.Users

Microsoft Graph PowerShell Cmdlets

Microsoft.Graph.Users

Get-MgUser

Retrieve the properties and relationships of user object. This operation returns by default only a subset of the more commonly used properties for each user. These default properties are noted in the Properties section. To get properties that are not returned by default, do a GET operation for the user and specify the properties in a $select OData query option. Because the user resource supports extensions, you can also use the GET operation to get custom properties and extension data in a user instance.

Get-MgUserCreatedObject

Directory objects that were created by the user. Read-only. Nullable.

Get-MgUserDirectReport

The users and contacts that report to the user. (The users and contacts that have their manager property set to this user.) Read-only. Nullable. Supports $expand.

Get-MgUserExtension

The collection of open extensions defined for the user. Supports $expand. Nullable.

Get-MgUserLicenseDetail

Get licenseDetails from users

Get-MgUserManager

Returns the user or organizational contact assigned as the user's manager. Optionally, you can expand the manager's chain up to the root node.

Get-MgUserManagerByRef

Returns the user or organizational contact assigned as the user's manager. Optionally, you can expand the manager's chain up to the root node.

Get-MgUserMemberOf

The groups, directory roles and administrative units that the user is a member of. Read-only. Nullable. Supports $expand.

Get-MgUserMemberOfByRef

The user or contact that is this user's manager. Read-only. (HTTP Methods: GET, PUT, DELETE.). Supports $expand.

Get-MgUserNotification

Get notifications from users

Get-MgUserOauth2PermissionGrant

Get oauth2PermissionGrants from users

Get-MgUserOutlookMasterCategory

A list of categories defined for the user.

Get-MgUserOutlookTask

Get tasks from users

Get-MgUserOutlookTaskAttachment

The collection of fileAttachment, itemAttachment, and referenceAttachment attachments for the task. Read-only. Nullable.

Get-MgUserOutlookTaskFolder

Get taskFolders from users

Get-MgUserOutlookTaskFolderMultiValueExtendedProperty

The collection of multi-value extended properties defined for the task folder. Read-only. Nullable.

Get-MgUserOutlookTaskFolderSingleValueExtendedProperty

The collection of single-value extended properties defined for the task folder. Read-only. Nullable.

Get-MgUserOutlookTaskFolderTask

The tasks in this task folder. Read-only. Nullable.

Get-MgUserOutlookTaskFolderTaskAttachment

The collection of fileAttachment, itemAttachment, and referenceAttachment attachments for the task. Read-only. Nullable.

Get-MgUserOutlookTaskFolderTaskMultiValueExtendedProperty

The collection of multi-value extended properties defined for the task. Read-only. Nullable.

Get-MgUserOutlookTaskFolderTaskSingleValueExtendedProperty

The collection of single-value extended properties defined for the task. Read-only. Nullable.

Get-MgUserOutlookTaskGroup

Get taskGroups from users

Get-MgUserOutlookTaskGroupTaskFolder

The collection of task folders in the task group. Read-only. Nullable.

Get-MgUserOutlookTaskGroupTaskFolderMultiValueExtendedProperty

The collection of multi-value extended properties defined for the task folder. Read-only. Nullable.

Get-MgUserOutlookTaskGroupTaskFolderSingleValueExtendedProperty

The collection of single-value extended properties defined for the task folder. Read-only. Nullable.

Get-MgUserOutlookTaskGroupTaskFolderTask

The tasks in this task folder. Read-only. Nullable.

Get-MgUserOutlookTaskGroupTaskFolderTaskAttachment

The collection of fileAttachment, itemAttachment, and referenceAttachment attachments for the task. Read-only. Nullable.

Get-MgUserOutlookTaskGroupTaskFolderTaskMultiValueExtendedProperty

The collection of multi-value extended properties defined for the task. Read-only. Nullable.

Get-MgUserOutlookTaskGroupTaskFolderTaskSingleValueExtendedProperty

The collection of single-value extended properties defined for the task. Read-only. Nullable.

Get-MgUserOutlookTaskMultiValueExtendedProperty

The collection of multi-value extended properties defined for the task. Read-only. Nullable.

Get-MgUserOutlookTaskSingleValueExtendedProperty

The collection of single-value extended properties defined for the task. Read-only. Nullable.

Get-MgUserOwnedDevice

Devices that are owned by the user. Read-only. Nullable. Supports $expand.

Get-MgUserOwnedObject

Directory objects that are owned by the user. Read-only. Nullable. Supports $expand.

Get-MgUserPhoto

The user's profile photo. Read-only.

Get-MgUserPhotoContent

Get media content for the navigation property photo from users

Get-MgUserRegisteredDevice

Devices that are registered for the user. Read-only. Nullable. Supports $expand.

Get-MgUserSetting

Get settings from users

Get-MgUserSettingContactMergeSuggestion

Read the properties and relationships of a contactMergeSuggestions object.

Get-MgUserSettingItemInsight

Get the user-customizable privacy settings for itemInsights and meeting hours insights.

Get-MgUserSettingRegionalAndLanguageSetting

Get the properties of a regionalAndLanguageSettings object.

Get-MgUserSettingShiftPreference

Retrieve the properties and relationships of a shiftPreferences object by ID.

Get-MgUserTodoList

The task lists in the users mailbox.

Get-MgUserTodoListExtension

The collection of open extensions defined for the task list. Nullable.

Get-MgUserTodoListTask

The tasks in this task list. Read-only. Nullable.

Get-MgUserTodoListTaskAttachment

A collection of file attachments for the task.

Get-MgUserTodoListTaskAttachmentContent

Get media content for the navigation property attachments from users

Get-MgUserTodoListTaskAttachmentSession

Get attachmentSessions from users

Get-MgUserTodoListTaskAttachmentSessionContent

The content streams that are uploaded.

Get-MgUserTodoListTaskChecklistItem

A collection of smaller subtasks linked to the more complex parent task.

Get-MgUserTodoListTaskExtension

The collection of open extensions defined for the task. Nullable.

Get-MgUserTodoListTaskLinkedResource

A collection of resources linked to the task.

Get-MgUserTransitiveMemberOf

The groups, including nested groups, and directory roles that a user is a member of. Nullable.

Get-MgUserTransitiveMemberOfByRef

A collection of resources linked to the task.

Get-MgUserTransitiveReport

The transitive reports for a user. Read-only.

New-MgUser

Create a new user.\nThe request body contains the user to create. At a minimum, you must specify the required properties for the user. You can optionally specify any other writable properties. This operation returns by default only a subset of the properties for each user. These default properties are noted in the Properties section. To get properties that are not returned by default, do a GET operation and specify the properties in a $select OData query option.

New-MgUserExtension

Create new navigation property to extensions for users

New-MgUserMemberOfByRef

The collection of open extensions defined for the user. Read-only. Nullable.

New-MgUserNotification

Create new navigation property to notifications for users

New-MgUserOutlookMasterCategory

Create an outlookCategory object in the user's master list of categories.

New-MgUserOutlookTask

Create an Outlook task in the specified task folder. The POST method always ignores the time portion of startDateTime and dueDateTime in the request body, and assumes the time \nto be always midnight in the specified time zone.

New-MgUserOutlookTaskAttachment

Use this API to add an attachment to an outlookTask. The attachment can be a file (of fileAttachment type) or Outlook item (itemAttachment type).

New-MgUserOutlookTaskFolder

Create new navigation property to taskFolders for users

New-MgUserOutlookTaskFolderMultiValueExtendedProperty

Create new navigation property to multiValueExtendedProperties for users

New-MgUserOutlookTaskFolderSingleValueExtendedProperty

Create new navigation property to singleValueExtendedProperties for users

New-MgUserOutlookTaskFolderTask

Create new navigation property to tasks for users

New-MgUserOutlookTaskFolderTaskAttachment

Use this API to add an attachment to an outlookTask. The attachment can be a file (of fileAttachment type) or Outlook item (itemAttachment type).

New-MgUserOutlookTaskFolderTaskMultiValueExtendedProperty

Create new navigation property to multiValueExtendedProperties for users

New-MgUserOutlookTaskFolderTaskSingleValueExtendedProperty

Create new navigation property to singleValueExtendedProperties for users

New-MgUserOutlookTaskGroup

Create an Outlook task group in the user's mailbox.

New-MgUserOutlookTaskGroupTaskFolder

Create new navigation property to taskFolders for users

New-MgUserOutlookTaskGroupTaskFolderMultiValueExtendedProperty

Create new navigation property to multiValueExtendedProperties for users

New-MgUserOutlookTaskGroupTaskFolderSingleValueExtendedProperty

Create new navigation property to singleValueExtendedProperties for users

New-MgUserOutlookTaskGroupTaskFolderTask

Create new navigation property to tasks for users

New-MgUserOutlookTaskGroupTaskFolderTaskAttachment

Use this API to add an attachment to an outlookTask. The attachment can be a file (of fileAttachment type) or Outlook item (itemAttachment type).

New-MgUserOutlookTaskGroupTaskFolderTaskMultiValueExtendedProperty

Create new navigation property to multiValueExtendedProperties for users

New-MgUserOutlookTaskGroupTaskFolderTaskSingleValueExtendedProperty

Create new navigation property to singleValueExtendedProperties for users

New-MgUserOutlookTaskMultiValueExtendedProperty

Create new navigation property to multiValueExtendedProperties for users

New-MgUserOutlookTaskSingleValueExtendedProperty

Create new navigation property to singleValueExtendedProperties for users

New-MgUserTodoList

Create a new lists object.

New-MgUserTodoListExtension

Create new navigation property to extensions for users

New-MgUserTodoListTask

Create a new task object in a specified todoTaskList.

New-MgUserTodoListTaskAttachment

Add a new taskFileAttachment object to a todoTask. This operation limits the size of the attachment you can add to under 3 MB. If the size of the file attachments is more than 3 MB, create an upload session to upload the attachments.

New-MgUserTodoListTaskChecklistItem

Create new navigation property to checklistItems for users

New-MgUserTodoListTaskExtension

Create new navigation property to extensions for users

New-MgUserTodoListTaskLinkedResource

Create a linkedResource object to associate a specified task with an item in a partner application. For example, you can associate a task with an email item in Outlook that spurred the task, and you can create a linkedResource object to track its association. You can also create a linkedResource object while creating a todoTask.

New-MgUserTransitiveMemberOfByRef

A collection of resources linked to the task.

Remove-MgUser

Delete user. When deleted, user resources are moved to a temporary container and can be restored within 30 days. After that time, they are permanently deleted. To learn more, see deletedItems.

Remove-MgUserExtension

Delete navigation property extensions for users

Remove-MgUserLicenseDetail

Delete navigation property licenseDetails for users

Remove-MgUserManagerByRef

Delete ref of navigation property manager for users

Remove-MgUserNotification

Delete navigation property notifications for users

Remove-MgUserOutlookMasterCategory

Delete navigation property masterCategories for users

Remove-MgUserOutlookTask

Delete navigation property tasks for users

Remove-MgUserOutlookTaskAttachment

Delete navigation property attachments for users

Remove-MgUserOutlookTaskFolder

Delete navigation property taskFolders for users

Remove-MgUserOutlookTaskFolderMultiValueExtendedProperty

Delete navigation property multiValueExtendedProperties for users

Remove-MgUserOutlookTaskFolderSingleValueExtendedProperty

Delete navigation property singleValueExtendedProperties for users

Remove-MgUserOutlookTaskFolderTask

Delete navigation property tasks for users

Remove-MgUserOutlookTaskFolderTaskAttachment

Delete navigation property attachments for users

Remove-MgUserOutlookTaskFolderTaskMultiValueExtendedProperty

Delete navigation property multiValueExtendedProperties for users

Remove-MgUserOutlookTaskFolderTaskSingleValueExtendedProperty

Delete navigation property singleValueExtendedProperties for users

Remove-MgUserOutlookTaskGroup

Delete navigation property taskGroups for users

Remove-MgUserOutlookTaskGroupTaskFolder

Delete navigation property taskFolders for users

Remove-MgUserOutlookTaskGroupTaskFolderMultiValueExtendedProperty

Delete navigation property multiValueExtendedProperties for users

Remove-MgUserOutlookTaskGroupTaskFolderSingleValueExtendedProperty

Delete navigation property singleValueExtendedProperties for users

Remove-MgUserOutlookTaskGroupTaskFolderTask

Delete navigation property tasks for users

Remove-MgUserOutlookTaskGroupTaskFolderTaskAttachment

Delete navigation property attachments for users

Remove-MgUserOutlookTaskGroupTaskFolderTaskMultiValueExtendedProperty

Delete navigation property multiValueExtendedProperties for users

Remove-MgUserOutlookTaskGroupTaskFolderTaskSingleValueExtendedProperty

Delete navigation property singleValueExtendedProperties for users

Remove-MgUserOutlookTaskMultiValueExtendedProperty

Delete navigation property multiValueExtendedProperties for users

Remove-MgUserOutlookTaskSingleValueExtendedProperty

Delete navigation property singleValueExtendedProperties for users

Remove-MgUserSetting

Delete navigation property settings for users

Remove-MgUserSettingContactMergeSuggestion

Delete navigation property contactMergeSuggestions for users

Remove-MgUserSettingItemInsight

Delete navigation property itemInsights for users

Remove-MgUserSettingRegionalAndLanguageSetting

Delete navigation property regionalAndLanguageSettings for users

Remove-MgUserSettingShiftPreference

Delete navigation property shiftPreferences for users

Remove-MgUserTodoList

Delete navigation property lists for users

Remove-MgUserTodoListExtension

Delete navigation property extensions for users

Remove-MgUserTodoListTask

Delete navigation property tasks for users

Remove-MgUserTodoListTaskAttachment

Delete navigation property attachments for users

Remove-MgUserTodoListTaskAttachmentSession

Delete navigation property attachmentSessions for users

Remove-MgUserTodoListTaskChecklistItem

Delete navigation property checklistItems for users

Remove-MgUserTodoListTaskExtension

Delete navigation property extensions for users

Remove-MgUserTodoListTaskLinkedResource

Delete navigation property linkedResources for users

Set-MgUserManagerByRef

Update the ref of navigation property manager in users

Set-MgUserPhotoContent

Update media content for the navigation property photo in users

Set-MgUserTodoListTaskAttachmentContent

Update media content for the navigation property attachments in users

Set-MgUserTodoListTaskAttachmentSessionContent

The content streams that are uploaded.

Update-MgUser

Update the properties of a user object. Not all properties can be updated by Member or Guest users with their default permissions without Administrator roles. Compare member and guest default permissions to see properties they can manage.

Update-MgUserExtension

Update the navigation property extensions in users

Update-MgUserLicenseDetail

Update the navigation property licenseDetails in users

Update-MgUserNotification

Update the navigation property notifications in users

Update-MgUserOutlookMasterCategory

Update the navigation property masterCategories in users

Update-MgUserOutlookTask

Update the navigation property tasks in users

Update-MgUserOutlookTaskFolder

Update the navigation property taskFolders in users

Update-MgUserOutlookTaskFolderMultiValueExtendedProperty

Update the navigation property multiValueExtendedProperties in users

Update-MgUserOutlookTaskFolderSingleValueExtendedProperty

Update the navigation property singleValueExtendedProperties in users

Update-MgUserOutlookTaskFolderTask

Update the navigation property tasks in users

Update-MgUserOutlookTaskFolderTaskMultiValueExtendedProperty

Update the navigation property multiValueExtendedProperties in users

Update-MgUserOutlookTaskFolderTaskSingleValueExtendedProperty

Update the navigation property singleValueExtendedProperties in users

Update-MgUserOutlookTaskGroup

Update the navigation property taskGroups in users

Update-MgUserOutlookTaskGroupTaskFolder

Update the navigation property taskFolders in users

Update-MgUserOutlookTaskGroupTaskFolderMultiValueExtendedProperty

Update the navigation property multiValueExtendedProperties in users

Update-MgUserOutlookTaskGroupTaskFolderSingleValueExtendedProperty

Update the navigation property singleValueExtendedProperties in users

Update-MgUserOutlookTaskGroupTaskFolderTask

Update the navigation property tasks in users

Update-MgUserOutlookTaskGroupTaskFolderTaskMultiValueExtendedProperty

Update the navigation property multiValueExtendedProperties in users

Update-MgUserOutlookTaskGroupTaskFolderTaskSingleValueExtendedProperty

Update the navigation property singleValueExtendedProperties in users

Update-MgUserOutlookTaskMultiValueExtendedProperty

Update the navigation property multiValueExtendedProperties in users

Update-MgUserOutlookTaskSingleValueExtendedProperty

Update the navigation property singleValueExtendedProperties in users

Update-MgUserPhoto

Update the navigation property photo in users

Update-MgUserSetting

Update the navigation property settings in users

Update-MgUserSettingContactMergeSuggestion

Update the properties of a contactMergeSuggestions object.

Update-MgUserSettingItemInsight

Update the privacy settings for itemInsights and meeting hours insights of a user.

Update-MgUserSettingRegionalAndLanguageSetting

Update the navigation property regionalAndLanguageSettings in users

Update-MgUserSettingShiftPreference

Update the properties and relationships of a shiftPreferences object.

Update-MgUserTodoList

Update the navigation property lists in users

Update-MgUserTodoListExtension

Update the navigation property extensions in users

Update-MgUserTodoListTask

Update the navigation property tasks in users

Update-MgUserTodoListTaskAttachmentSession

Update the navigation property attachmentSessions in users

Update-MgUserTodoListTaskChecklistItem

Update the navigation property checklistItems in users

Update-MgUserTodoListTaskExtension

Update the navigation property extensions in users

Update-MgUserTodoListTaskLinkedResource

Update the navigation property linkedResources in users