pnp / pnp/cli-microsoft365

New command: m365 spe container permission add

Open
#6,159 6 comments 0 reactions 1 assignee View on GitHub

@MartinM85 is already working on this.

Since May 3, 2026.

keep-open new feature work in progress
Dominant language
TypeScript
Stars
1.5k
Forks
413
Avg merge
5d 6h
Merged PRs (30d)
21

Description

Usage

m365 spe container permission add [options]

Description

Adds permission to SharePoint Embedded Container for a specified user

Options
Option Description
-i, --containerId [containerId] ID of a SharePoint Embedded container. Specify either containerId or containerName but not both.
-n, --containerName [containerName] Display name of the Container. Specify either containerId or containerName but not both.
--containerTypeId [containerTypeId] The ID of the container type. Specify either containerTypeId or containerTypeName when using containerName but not both.
--containerTypeName [containerTypeName] The name of the container type. Specify either containerTypeId or containerTypeName when using containerName but not both.
-r, --roles <roles> Comma separated list of permissions. Possible values are reader, writer, manager, owner.
--userName [userName] The upn/email of user to assign role to. Use either userName or userId but not both.
--userId [userId] The id of user to assign role to. Use either userName or userId but not both.
Examples

Adds a reader role for the specified user to the container

m365 spe container permission add --containerId "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z"  --roles "reader" --userName "jacob@fabrikam.com"

Adds a multiple roles for the specified user to the container

m365 spe container permission add --containerId "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z"  --roles "reader,writer" --userName "jacob@fabrikam.com"
Default properties

No response

Additional Info

we may use the following API for that:
https://learn.microsoft.com/en-us/graph/api/filestoragecontainer-post-permissions?view=graph-rest-1.0&tabs=http

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.