Búsqueda de sitios web

Cómo encontrar permisos de comando de Graph PowerShell

Con el SDK de Microsoft Graph PowerShell, debe conectarse a la API Graph con un alcance.

El alcance indica qué permisos necesitará para ejecutar sus comandos durante la sesión.

¿Pero qué permisos vas a necesitar?

La forma más sencilla de identificar esto es utilizando Find-MgGraphCommand CmdLet.

Como ejemplo, para identificar los permisos necesarios para ejecutar Get-MgUser, ejecute el siguiente comando:

Find-MgGraphCommand -Command Get-MgUser -ApiVersion v1.0

Los parámetros importantes son:

  • Comando (que es obligatorio)
  • ApiVersion (seleccione entre v1.0 y Beta)

El resultado será similar a este:

PS C:\> Find-MgGraphCommand -Command Get-MgUser -ApiVersion v1.0


   APIVersion: v1.0

Command    Module Method URI              OutputType           Permissions                                                                                                                                                   Variants
-------    ------ ------ ---              ----------           -----------                                                                                                                                                   --------
Get-MgUser Users  GET    /users/{user-id} IMicrosoftGraphUser1 {DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All...} {Get1, GetViaIdentity1}
Get-MgUser Users  GET    /users           IMicrosoftGraphUser1 {DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All...} {List1}

Las dos líneas indican una solicitud para un usuario específico y una solicitud general para usuarios.

Para ver los permisos necesarios para la solicitud general con más detalle, ejecute el siguiente comando:

(Find-MgGraphCommand -Command Get-MgUser -ApiVersion v1.0 | ? { $_.URI -eq '/users'}).Permissions | ft Name,Description

Esto generará una salida similar a la siguiente:

PS C:\> (Find-MgGraphCommand -Command Get-MgUser -ApiVersion v1.0 | ? { $_.URI -eq '/users'}).Permissions | ft Name,Description

Name                                         Description
----                                         -----------
DeviceManagementApps.Read.All                Read Microsoft Intune apps
DeviceManagementApps.ReadWrite.All           Read and write Microsoft Intune apps
DeviceManagementManagedDevices.Read.All      Read devices Microsoft Intune devices
DeviceManagementManagedDevices.ReadWrite.All Read and write Microsoft Intune devices
DeviceManagementServiceConfig.Read.All       Read Microsoft Intune configuration
DeviceManagementServiceConfig.ReadWrite.All  Read and write Microsoft Intune configuration
Directory.AccessAsUser.All                   Access the directory as you
Directory.Read.All                           Read directory data
Directory.ReadWrite.All                      Read and write directory data
User.Read.All                                Read all users' full profiles
User.ReadBasic.All                           Read all users' basic profiles
User.ReadWrite.All                           Read and write all users' full profiles

Como notará, los permisos incluyen varios permisos de Intune además de los permisos de Usuario y Directorio.

Es posible que no necesite esos permisos cuando consulte a un usuario estándar mediante el comando Get-MgUser.

Además, algunos de los permisos enumerados son subconjuntos que puede omitir (por ejemplo, Directory.ReadWrite.All incluye Directory.Read.All).

Gestión sencilla de Office 365

Si desea administrar su entorno de Office 365 con la API de Microsoft Graph PowerShell sin escribir una sola línea de código, consulte Easy365Manager.

Easy365Manager es un complemento para Usuarios y Computadoras de AD que le brinda una administración de Office 365 rápida y fácil de usar:

Artículos relacionados