Skip to content

imabdk/Intune-Remote-Help-RBAC-Roles-Groups-Automation

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Intune Remote Help RBAC Roles Groups Automation

Automate the creation of custom RBAC roles and security groups for Microsoft Intune Remote Help permissions.

Overview

This PowerShell script creates four custom RBAC roles in Microsoft Intune, each with specific Remote Help permissions, along with corresponding Entra ID security groups for role assignment. It eliminates the manual, time-consuming process of setting up Remote Help RBAC roles through the Intune portal.

Created Roles

Role Name Permissions Use Case
Remote Help - View Screen Only View sharer's screen Level 1 support, read-only assistance
Remote Help - Full Control Take full control of device Level 2/3 support, active troubleshooting
Remote Help - Elevation Interact with UAC prompts (Windows) Elevated administrative tasks
Remote Help - Unattended (Android) Connect without user acceptance Managed Android device support

All roles include base permissions:

  • Remote Tasks - Offer remote assistance
  • Remote Assistance Connector - Read

Prerequisites

Required Modules

Install-Module Microsoft.Graph.DeviceManagement.Administration
Install-Module Microsoft.Graph.Groups
Install-Module Microsoft.Graph.Authentication

Required Permissions

  • DeviceManagementRBAC.ReadWrite.All
  • Group.ReadWrite.All

Account Requirements

  • Global Administrator or Intune Administrator role

Usage

Create Roles and Groups

.\Create-Intune-Remote-Help-RBAC-Roles-Groups.ps1

Preview Changes (WhatIf Mode)

.\Create-Intune-Remote-Help-RBAC-Roles-Groups.ps1 -WhatIf

Remove All Roles and Groups

.\Create-Intune-Remote-Help-RBAC-Roles-Groups.ps1 -Remove

Remove with Preview

.\Create-Intune-Remote-Help-RBAC-Roles-Groups.ps1 -Remove -WhatIf

Output Example

Connecting to Microsoft Graph...

Creating Remote Help RBAC roles and groups...
=========================================

Processing: Remote Help - View Screen Only
  [SUCCESS] Role created!
    Role ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890
  Checking for Entra ID group: Intune-RemoteHelp-ViewScreenOnly
  [SUCCESS] Group created!
    Group ID: f9e8d7c6-b5a4-3210-fedc-ba0987654321
    Group Name: Intune-RemoteHelp-ViewScreenOnly

Processing: Remote Help - Full Control
  [SUCCESS] Role created!
    Role ID: b2c3d4e5-f6a7-8901-bcde-f12345678901
  Checking for Entra ID group: Intune-RemoteHelp-FullControl
  [SUCCESS] Group created!
    Group ID: e8d7c6b5-a4f3-2109-edcb-a09876543210
    Group Name: Intune-RemoteHelp-FullControl

Processing: Remote Help - Elevation
  [SUCCESS] Role created!
    Role ID: c3d4e5f6-a7b8-9012-cdef-123456789012
  Checking for Entra ID group: Intune-RemoteHelp-Elevation
  [SUCCESS] Group created!
    Group ID: d7c6b5a4-f321-0fed-cba0-987654321098
    Group Name: Intune-RemoteHelp-Elevation

Processing: Remote Help - Unattended (Android)
  [SUCCESS] Role created!
    Role ID: d4e5f6a7-b890-1234-def1-234567890123
  Checking for Entra ID group: Intune-RemoteHelp-Unattended
  [SUCCESS] Group created!
    Group ID: c6b5a4f3-210f-edcb-a098-765432109876
    Group Name: Intune-RemoteHelp-Unattended

=========================================

Summary:
  Roles created: 4
  Roles already existing: 0
  Roles failed: 0
  Groups created: 4
  Groups already existing: 0
  Groups failed: 0

Note: To assign these roles to groups, go to:
  Intune portal > Tenant administration > Roles > Select role > Assignments

Post-Installation

After running the script:

  1. Add Users to Groups: Add support staff to the appropriate security groups:

    • Intune-RemoteHelp-ViewScreenOnly
    • Intune-RemoteHelp-FullControl
    • Intune-RemoteHelp-Elevation
    • Intune-RemoteHelp-Unattended
  2. Assign Roles to Groups: In the Intune admin center:

    • Go to Tenant administration > Roles
    • Select each created role
    • Click Assignments > Assign
    • Add the corresponding group as Admin Group
    • Set the scope (all devices, specific groups, etc.)

Documentation

For more information about Remote Help RBAC permissions, see:

Author

Martin Bengtsson - imab.dk

About

Automate creation of custom RBAC roles and security groups for Microsoft Intune Remote Help

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors