AdministrativeUnit.ReadWriteBasic.All
Allows the app to read and update basic administrative unit properties without a signed-in user. Does not include membership management.
In short
AdministrativeUnit.ReadWriteBasic.All is available as both an application permission and a delegated permission in the Microsoft Graph API, grouped under the AdministrativeUnit category. Allows the app to read and update basic administrative unit properties without a signed-in user. Does not include membership management. It grants read and write access to resources. Application permissions always require admin consent.
Permission Details
Read and update basic properties of all administrative units
Allows the app to read and update basic administrative unit properties without a signed-in user. Does not include membership management.
bfe74bc6-06ed-4349-9ba5-6596149bf69a
Read and update basic administrative unit properties
Allows the app to read and update basic administrative unit properties on behalf of the signed-in user. Does not include membership management.
b1c7bc90-edab-4b18-9a7d-441e74635223
Properties
Properties is shown from stable Microsoft Graph v1.0 metadata.
| Property | Type | Description |
|---|---|---|
description |
StringNullable |
An optional description for the administrative unit. Supports $filter (eq, ne, in, startsWith), $search. |
displayName |
StringNullable |
Display name for the administrative unit. Maximum length is 256 characters. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values), $search, and $orderby. |
id |
String |
Unique identifier for the administrative unit. Read-only. Supports $filter (eq). |
isMemberManagementRestricted |
BooleanNullable |
true if members of this administrative unit should be treated as sensitive, which requires specific permissions to manage. If not set, the default value is null and the default behavior is false. Use this property to define administrative units with roles that don't inherit from tenant-level administrators, and where the management of individual member objects is limited to administrators scoped to a restricted management administrative unit. This property is immutable and can't be changed later. , , For more information on how to work with restricted management administrative units, see Restricted management administrative units in Microsoft Entra ID. |
membershipRule |
StringNullable |
The dynamic membership rule for the administrative unit. For more information about the rules you can use for dynamic administrative units and dynamic groups, see Manage rules for dynamic membership groups in Microsoft Entra ID. |
membershipRuleProcessingState |
StringNullable |
Controls whether the dynamic membership rule is actively processed. Set to On to activate the dynamic membership rule, or Paused to stop updating membership dynamically. |
membershipType |
StringNullable |
Indicates the membership type for the administrative unit. The possible values are: dynamic, assigned. If not set, the default value is null and the default behavior is assigned. |
visibility |
StringNullable |
Controls whether the administrative unit and its members are hidden or public. Can be set to HiddenMembership. If not set, the default value is null and the default behavior is public. When set to HiddenMembership, only members of the administrative unit can list other members of the administrative unit. |
deletedDateTime |
date-timeNullable |
Date and time when this object was deleted. Always null when the object hasn't been deleted. |
extensions |
extension collection |
The collection of open extensions defined for this administrative unit. Nullable. |
members |
directoryObject collection |
Users and groups that are members of this administrative unit. Supports $expand. |
scopedRoleMembers |
scopedRoleMembership collection |
Scoped-role members of this administrative unit. |
JSON Representation
JSON representation is shown from stable Microsoft Graph v1.0 metadata.
{
"description": "String",
"displayName": "String",
"id": "String (identifier)",
"isMemberManagementRestricted": "Boolean",
"membershipRule": "String",
"membershipRuleProcessingState": "String",
"membershipType": "String",
"visibility": "String"
}
Relationships
Relationships is shown from stable Microsoft Graph v1.0 metadata.
| Relationship | Type | Description |
|---|---|---|
members |
directoryObject collection |
Users and groups that are members of this administrative unit. Supports $expand. |
extensions |
extension collection |
The collection of open extensions defined for this administrative unit. Nullable. |
scopedRoleMembers |
scopedRoleMembership collection |
Scoped-role members of this administrative unit. |
deletedMembers |
directoryObject collection |
Related deletedMembers data exposed by this resource. |
Graph Methods
Microsoft Graph v1.0 endpoints are not available from refreshed Microsoft Learn or Microsoft Graph OpenAPI metadata for this permission.
No API methods available for this version.
Microsoft Graph beta endpoints are not available from refreshed Microsoft Learn or Microsoft Graph OpenAPI metadata for this permission.
No API methods available for this version.
Microsoft Graph PowerShell v1.0 commands are not available from refreshed Microsoft Learn PowerShell snippets for this permission.
No deterministic PowerShell command map is available for this permission.
Browse PowerShell docsMicrosoft Graph PowerShell beta commands are not available from refreshed Microsoft Learn PowerShell snippets for this permission.
No deterministic PowerShell command map is available for this permission.
Browse PowerShell docsCode Examples
using Azure.Identity;
using Microsoft.Graph;
var scopes = new[] { "AdministrativeUnit.ReadWriteBasic.All" };
var credential = new InteractiveBrowserCredential(
new InteractiveBrowserCredentialOptions
{
ClientId = "YOUR_CLIENT_ID",
TenantId = "YOUR_TENANT_ID",
RedirectUri = new Uri("http://localhost")
});
var graphClient = new GraphServiceClient(credential, scopes);
var response = await graphClient
.WithUrl("https://graph.microsoft.com/v1.0/administrativeUnit")
.GetAsync();
import { Client } from "@microsoft/microsoft-graph-client";
import { InteractiveBrowserCredential } from "@azure/identity";
const credential = new InteractiveBrowserCredential({
clientId: "YOUR_CLIENT_ID",
tenantId: "YOUR_TENANT_ID",
redirectUri: "http://localhost"
});
const token = await credential.getToken(["AdministrativeUnit.ReadWriteBasic.All"]);
const client = Client.init({
authProvider: (done) => done(null, token.token)
});
const response = await client.api("/administrativeUnit").get();
Connect-MgGraph -Scopes "AdministrativeUnit.ReadWriteBasic.All"
Invoke-MgGraphRequest -Method GET -Uri "https://graph.microsoft.com/v1.0/administrativeUnit"
from azure.identity import InteractiveBrowserCredential
import requests
credential = InteractiveBrowserCredential(
client_id="YOUR_CLIENT_ID",
tenant_id="YOUR_TENANT_ID"
)
token = credential.get_token("AdministrativeUnit.ReadWriteBasic.All")
response = requests.get(
"https://graph.microsoft.com/v1.0/administrativeUnit",
headers={"Authorization": f"Bearer {token.token}"}
)
print(response.json())
App Registration
Navigate to Azure Portal
Go to App registrations in Microsoft Entra admin center
Add API Permission
Select your app → API permissions → Add a permission → Microsoft Graph
Select Permission Type
Choose Application permissions or delegated permissions and search for AdministrativeUnit.ReadWriteBasic.All
Grant Admin Consent
Application permissions always require admin consent.
Frequently asked questions
What is the AdministrativeUnit.ReadWriteBasic.All Microsoft Graph permission?
AdministrativeUnit.ReadWriteBasic.All is available as both an application permission and a delegated permission in the Microsoft Graph API, grouped under the AdministrativeUnit category. Allows the app to read and update basic administrative unit properties without a signed-in user. Does not include membership management. It grants read and write access to resources. Application permissions always require admin consent. It is mapped to the Microsoft Graph administrativeunit resource type.
Is AdministrativeUnit.ReadWriteBasic.All an application or a delegated permission?
AdministrativeUnit.ReadWriteBasic.All is available as both an application permission (app-only access, no signed-in user) and a delegated permission (access on behalf of a signed-in user).
Does AdministrativeUnit.ReadWriteBasic.All require admin consent?
Application permissions always require admin consent.
What is the permission ID (GUID) for AdministrativeUnit.ReadWriteBasic.All?
For AdministrativeUnit.ReadWriteBasic.All, the application (app role) ID is bfe74bc6-06ed-4349-9ba5-6596149bf69a, and the delegated (OAuth2 scope) ID is b1c7bc90-edab-4b18-9a7d-441e74635223. These are the real Microsoft Graph identifiers and can be used directly in an app registration manifest.