@pnp/cli-microsoft365 10.5.0 → 10.6.0-beta.38233e7

package/dist/utils/spo.js

@@ -519,10 +519,11 @@ export const spo = {
     },
     /**
    * Retrieves the spo user by email.
+   * Returns a user object
    * @param webUrl Web url
    * @param email The email of the user
    * @param logger the Logger object
-   * @param verbose set for verbose logging
+   * @param verbose Set for verbose logging
    */
     async getUserByEmail(webUrl, email, logger, verbose) {
         if (verbose && logger) {
@@ -593,10 +594,11 @@ export const spo = {
     },
     /**
     * Retrieves the spo group by name.
+    * Returns a group object
     * @param webUrl Web url
     * @param name The name of the group
     * @param logger the Logger object
-    * @param verbose set for verbose logging
+    * @param verbose Set for verbose logging
     */
     async getGroupByName(webUrl, name, logger, verbose) {
         if (verbose && logger) {
@@ -615,10 +617,13 @@ export const spo = {
     },
     /**
     * Retrieves the role definition by name.
+    * Returns a RoleDefinition object
+    * Returns a RoleDefinition object
     * @param webUrl Web url
     * @param name the name of the role definition
     * @param logger the Logger object
-    * @param verbose set for verbose logging
+    * @param verbose Set for verbose logging
+    * @param verbose Set for verbose logging
     */
     async getRoleDefinitionByName(webUrl, name, logger, verbose) {
         if (verbose && logger) {
@@ -1753,6 +1758,30 @@ export const spo = {
             responseType: 'json'
         };
         return request.post(requestOptions);
+    },
+    /**
+    * Get a role definition by name
+    * Returns a RoleDefinition object
+    * @param webUrl The web url
+    * @param name  the name of the role definition
+    * @param logger The logger object
+    * @param verbose Set for verbose logging
+    */
+    async getRoleDefintionByName(webUrl, name, logger, verbose) {
+        if (verbose && logger) {
+            await logger.logToStderr(`Retrieving the role definition by name ${name}`);
+        }
+        const response = await odata.getAllItems(`${webUrl}/_api/web/roledefinitions`);
+        const roleDefinition = response.find((role) => role.Name === name);
+        if (!roleDefinition) {
+            throw new Error(`The specified role definition name '${name}' does not exist.`);
+        }
+        const permissions = new BasePermissions();
+        permissions.high = roleDefinition.BasePermissions.High;
+        permissions.low = roleDefinition.BasePermissions.Low;
+        roleDefinition.BasePermissionsValue = permissions.parse();
+        roleDefinition.RoleTypeKindValue = RoleType[roleDefinition.RoleTypeKind];
+        return roleDefinition;
     }
 };
 //# sourceMappingURL=spo.js.map

package/docs/docs/cmd/entra/policy/policy-list.mdx

@@ -16,7 +16,7 @@ m365 entra policy list [options]
 
 ```md definition-list
 `-t, --type [type]`
-: The type of policies to return. Allowed values `activityBasedTimeout`, `authorization`, `claimsMapping`, `homeRealmDiscovery`, `identitySecurityDefaultsEnforcement`, `tokenIssuance`, `tokenLifetime`. If omitted, all policies are returned.
+: The type of policies to return. Allowed values `activityBasedTimeout`, `adminConsentRequest`, `appManagement`, `authenticationFlows`, `authenticationMethods`, `authenticationStrength`, `authorization`, `claimsMapping`, `conditionalAccess`, `crossTenantAccess`, `defaultAppManagement`, `deviceRegistration`, `featureRolloutPolicy`, `homeRealmDiscovery`, `identitySecurityDefaultsEnforcement`, `permissionGrant`, `roleManagement`, `tokenIssuance`, `tokenLifetime`. If omitted, all policies are returned.
 ```
 
 <Global />

package/docs/docs/cmd/graph/directoryextension/directoryextension-get.mdx

@@ -38,16 +38,15 @@ m365 graph directoryextension get [options]
 Get directory extension by id registered for an application specified by app id.
 
 ```sh
-m365 directoryextension get --id 1f0f15e3-925d-40f0-8fc8-9d3ad135bce0 --appId fd918e4b-c821-4efb-b50a-5eddd23afc6f
+m365 graph directoryextension get --id 1f0f15e3-925d-40f0-8fc8-9d3ad135bce0 --appId fd918e4b-c821-4efb-b50a-5eddd23afc6f
 ```
 
 Get directory extension by name registered for an application specified by name.
 
 ```sh
-m365 directoryextension get --name extension_105be60b603845fea385e58772d9d630_GitHubWorkAccount --appName ContosoApp
+m365 graph directoryextension get --name extension_105be60b603845fea385e58772d9d630_GitHubWorkAccount --appName ContosoApp
 ```
 
-
 ## Response
 
 <Tabs>

package/docs/docs/cmd/graph/openextension/openextension-add.mdx

@@ -0,0 +1,120 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# graph openextension add
+
+Adds an open extension to a resource
+
+## Usage
+
+```sh
+m365 graph openextension add [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --name <name>`
+: The name of the open extension.
+
+`-i, --resourceId <resourceId>`
+: The Id of the resource for which the extension is created.
+
+`-t, --resourceType <resourceType>`
+: The resource type for which the extension is created. Allowed values are `user`, `group`, `device`, `organization`.
+```
+
+<Global />
+
+## Remarks
+
+This command allows using unknown options to add custom data to the open extension.
+
+When adding an open extension to a user, it's possible to use the UPN as the resourceId.
+
+:::warning[Escaping JSON in PowerShell]
+
+When creating open extensions it's possible to enter a JSON string. In PowerShell 5 to 7.2 [specific escaping rules](./../../../user-guide/using-cli.mdx#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../../user-guide/using-cli.mdx#passing-complex-content-into-cli-options) instead.
+
+:::
+
+## Examples
+
+Create a new open extension for a user specified by id. Extension properties are specified by unknown options.
+
+```sh
+m365 graph openextension add --resourceId eb77fbcf-6fe8-458b-985d-1747284793bc --resourceType user --name 'com.contoso.roamingSettings' --theme dark --color red --language English
+```
+
+Create a new open extension for a user specified by userName. Extension properties are specified by unknown options.
+
+```sh
+m365 graph openextension add --resourceId adelev@contoso.com --resourceType user --name 'com.contoso.roamingSettings' --theme dark --color red --language English
+```
+
+Create a new open extension for a group, one of the property represents a JSON object
+
+```sh
+m365 graph openextension add --resourceId eb77fbcf-6fe8-458b-985d-1747284793bc --resourceType group --name 'com.contoso.roamingSettings' --settings '{"theme": "dark", "color": "red", "language": "English"}' --supportedSystem 'Linux'
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "extensionName": "com.contoso.roamingSettings",
+    "settings": {
+      "theme": "dark",
+      "color": "red",
+      "language": "English"
+    },
+    "supportedSystem": "Linux",
+    "id": "com.contoso.roamingSettings"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  extensionName  : com.contoso.roamingSettings
+  id             : com.contoso.roamingSettings
+  settings       : {"theme":"dark","color":"red","language":"English"}
+  supportedSystem: Linux
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  extensionName,supportedSystem,id
+  com.contoso.roamingSettings,Linux,com.contoso.roamingSettings
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # graph openextension add --name "com.contoso.roamingSettings" --resourceId "01b62bc5-9701-4f93-9587-9d1ea58a086d" --resourceType "user" --settings "{"theme": "dark", "color": "red", "language": "English"}" --supportedSystem "Linux"
+
+  Date: 3/13/2025
+
+  ## com.contoso.roamingSettings
+
+  Property | Value
+  ---------|-------
+  extensionName | com.contoso.roamingSettings
+  supportedSystem | Linux
+  id | com.contoso.roamingSettings
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- Open extensions: https://learn.microsoft.com/graph/api/opentypeextension-post-opentypeextension

package/docs/docs/cmd/graph/openextension/openextension-get.mdx

@@ -0,0 +1,111 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# graph openextension get
+
+Retrieves a specific open extension for a resource
+
+## Usage
+
+```sh
+m365 graph openextension get [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --name <name>`
+: The name of the open extension to retrieve.
+
+`-i, --resourceId <resourceId>`
+: The Id of the resource for which to retrieve the open extension.
+
+`-t, --resourceType <resourceType>`
+: The type of resource. Allowed values are `user`, `group`, `device`, `organization`.
+```
+
+<Global />
+
+## Examples
+
+Retrieve a specified open extension for a user specified by id.
+
+```sh
+m365 graph openextension get --resourceId eb77fbcf-6fe8-458b-985d-1747284793bc --name 'com.contoso.roamingSettings' --resourceType user
+```
+
+Retrieve a specified open extension for a user specified by UPN.
+
+```sh
+m365 graph openextension get --resourceId john.doe@contoso.com --name 'com.contoso.roamingSettings' --resourceType user
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "extensionName": "com.contoso.roamingSettings",
+    "name": "com.contoso.roamingSettings",
+    "resourceId": "john.doe@contoso.com",
+    "resourceType": "user",
+    "theme": "dark",
+    "color": "red",
+    "language": "English",
+    "id": "com.contoso.roamingSettings"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  color        : red
+  extensionName: com.contoso.roamingSettings
+  id           : com.contoso.roamingSettings
+  language     : English
+  name         : com.contoso.roamingSettings
+  resourceId   : john.doe@contoso.com
+  resourceType : user
+  theme        : dark
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  extensionName,name,resourceId,resourceType,theme,color,language,id
+  com.contoso.roamingSettings,com.contoso.roamingSettings,john.doe@contoso.com,user,dark,red,English,com.contoso.roamingSettings
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # graph openextension get --debug "false" --verbose "false" --resourceId "john.doe@contoso.com" --resourceType "user" --name "com.contoso.roamingSettings"
+
+  Date: 2025-04-07
+
+  ## com.contoso.roamingSettings (com.contoso.roamingSettings)
+
+  Property | Value
+  ---------|-------
+  extensionName | com.contoso.roamingSettings
+  name | com.contoso.roamingSettings
+  resourceId | john.doe@contoso.com
+  resourceType | user
+  theme | dark
+  color | red
+  language | English
+  id | com.contoso.roamingSettings
+  ```
+  
+  </TabItem>
+</Tabs>
+
+## More information
+
+- Open extensions: https://learn.microsoft.com/graph/extensibility-overview?tabs=http#open-extensions

package/docs/docs/cmd/graph/openextension/openextension-list.mdx

@@ -0,0 +1,129 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# graph openextension list
+
+Retrieves all open extensions for a resource
+
+## Usage
+
+```sh
+m365 graph openextension list [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --resourceId <resourceId>`
+: The Id of the resource for which to retrieve open extensions.
+
+`-t, --resourceType <resourceType>`
+: The type of resource. Allowed values are `user`, `group`, `device`, `organization`.
+```
+
+<Global />
+
+## Examples
+
+Retrieve open extensions for a user specified by id
+
+```sh
+m365 graph openextension list --resourceId eb77fbcf-6fe8-458b-985d-1747284793bc --resourceType user
+```
+
+Retrieve open extensions for a user specified by UPN
+
+```sh
+m365 graph openextension list --resourceId john.doe@contoso.com --resourceType user
+```
+
+Retrieve open extensions for a group specified by id
+
+```sh
+m365 graph openextension list --resourceId 19588303-70bf-44a4-beb1-e2f0f1ed06b3 --resourceType group
+```
+
+Retrieve open extensions for an organization specified by id
+
+```sh
+m365 graph openextension list --resourceId c956e711-f074-40c3-8431-fbd69bb67d9c --resourceType organization
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "extensionName": "com.contoso.roamingSettings",
+      "theme": "dark",
+      "color": "purple",
+      "lang": "Japanese",
+      "id": "com.contoso.roamingSettings"
+    },
+    {
+      "extensionName": "com.test.m365",
+      "settings": {
+        "theme": "dark"
+      },
+      "supportedSystem": "Linux",
+      "id": "com.test.m365"
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  extensionName                id
+  ---------------------------  ---------------------------
+  com.contoso.roamingSettings  com.contoso.roamingSettings
+  com.test.m365                com.test.m365
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  extensionName,theme,color,lang,id
+  com.contoso.roamingSettings,dark,purple,Japanese,com.contoso.roamingSettings
+  com.test.m365,,,,com.test.m365
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # graph openextension list --resourceId "eb77fbcf-6fe8-458b-985d-1747284793bc" --resourceType "user"
+
+  Date: 3/29/2025
+
+  ## com.contoso.roamingSettings
+
+  Property | Value
+  ---------|-------
+  extensionName | com.contoso.roamingSettings
+  theme | dark
+  color | purple
+  lang | Japanese
+  id | com.contoso.roamingSettings
+
+  ## com.test.m365
+
+  Property | Value
+  ---------|-------
+  extensionName | com.test.m365
+  supportedSystem | Linux
+  id | com.test.m365
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- Open extensions: https://learn.microsoft.com/graph/extensibility-overview?tabs=http#open-extensions

package/docs/docs/cmd/graph/openextension/openextension-remove.mdx

@@ -0,0 +1,59 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# graph openextension remove
+
+Removes a specific open extension for a resource
+
+## Usage
+
+```sh
+m365 graph openextension remove [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --name <name>`
+: The name of the open extension to remove.
+
+`-i, --resourceId <resourceId>`
+: The Id of the resource for which to remove the open extension.
+
+`-t, --resourceType <resourceType>`
+: The type of resource. Allowed values are `user`, `group`, `device`, `organization`.
+
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Examples
+
+Remove a specified open extension for a user specified by id.
+
+```sh
+m365 graph openextension remove --resourceId eb77fbcf-6fe8-458b-985d-1747284793bc --name 'com.contoso.roamingSettings' --resourceType user
+```
+
+Remove a specified open extension for a user specified by UPN without confirmation prompt.
+
+```sh
+m365 graph openextension remove --resourceId john.doe@contoso.com --name 'com.contoso.roamingSettings' --resourceType user --force
+```
+
+Remove a specified open extension for a group specified by id.
+
+```sh
+m365 graph openextension remove --resourceId c956e711-f074-40c3-8431-fbd69bb67d9c --name 'com.contoso.groupSettings' --resourceType group
+```
+
+## Response
+
+The command won't return a response on success.
+
+## More information
+
+- Open extensions: https://learn.microsoft.com/graph/extensibility-overview?tabs=http#open-extensions

package/docs/docs/cmd/spfx/project/project-upgrade.mdx

@@ -26,9 +26,6 @@ m365 spfx project upgrade [options]
 
 `--preview`
 : Upgrade project to the latest SPFx preview version
-
-`--outputFile [outputFile]`
-: Path to the file where the upgrade report should be stored in. Ignored when `output` is `tour`
 ```
 
 <Global />

package/docs/docs/cmd/util/accesstoken/accesstoken-get.mdx

@@ -20,6 +20,9 @@ m365 util accesstoken get [options]
 
 `--new`
 : Retrieve a new access token to ensure that it's valid for as long as possible
+
+`--decoded`
+: Retrieve a decoded access token
 ```
 
 <Global />
@@ -60,8 +63,16 @@ Get a new access token for SharePoint Online
 m365 util accesstoken get --resource https://contoso.sharepoint.com --new
 ```
 
+Get a decoded access token for SharePoint Online
+
+```sh
+m365 util accesstoken get --resource https://contoso.sharepoint.com --decoded
+```
+
 ## Response
 
+### Standard response
+
 <Tabs>
   <TabItem value="JSON">
 
@@ -93,3 +104,64 @@ m365 util accesstoken get --resource https://contoso.sharepoint.com --new
   </TabItem>
 </Tabs>
 
+### `decoded` response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "alg": "HS256",
+    "typ": "JWT"
+  }.{
+    "sub": "1234567890",
+    "name": "John Doe",
+    "iat": 1516239022
+  }.[signature]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+    {
+    "alg": "HS256",
+    "typ": "JWT"
+  }.{
+    "sub": "1234567890",
+    "name": "John Doe",
+    "iat": 1516239022
+  }.[signature]
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  {
+    "alg": "HS256",
+    "typ": "JWT"
+  }.{
+    "sub": "1234567890",
+    "name": "John Doe",
+    "iat": 1516239022
+  }.[signature]
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  {
+    "alg": "HS256",
+    "typ": "JWT"
+  }.{
+    "sub": "1234567890",
+    "name": "John Doe",
+    "iat": 1516239022
+  }.[signature]
+  ```
+
+  </TabItem>
+</Tabs>
+