@pnp/cli-microsoft365 7.3.0 → 7.4.0-beta.2324d53

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "7.3.0",
+  "version": "7.4.0-beta.2324d53",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",
@@ -256,19 +256,19 @@
     "adaptivecards-templating": "^2.3.1",
     "adm-zip": "^0.5.10",
     "applicationinsights": "^2.9.1",
-    "axios": "^1.6.2",
+    "axios": "^1.6.3",
     "chalk": "^5.3.0",
     "clipboardy": "^4.0.0",
     "configstore": "^6.0.0",
-    "csv-stringify": "^6.4.4",
+    "csv-stringify": "^6.4.5",
     "easy-table": "^1.2.0",
     "jmespath": "^0.16.0",
     "json-to-ast": "^2.1.0",
     "minimist": "^1.2.8",
     "node-forge": "^1.3.1",
     "omelette": "^0.4.17",
-    "open": "^9.1.0",
-    "ora": "^7.0.1",
+    "open": "^10.0.2",
+    "ora": "^8.0.1",
     "semver": "^7.5.4",
     "strip-json-comments": "^5.0.1",
     "typescript": "^5.3.3",
@@ -283,17 +283,17 @@
     "@types/json-to-ast": "^2.1.4",
     "@types/minimist": "^1.2.5",
     "@types/mocha": "^10.0.6",
-    "@types/node": "^18.19.3",
+    "@types/node": "^20.10.6",
     "@types/node-forge": "^1.3.10",
     "@types/omelette": "^0.4.4",
     "@types/semver": "^7.5.6",
     "@types/sinon": "^17.0.2",
     "@types/update-notifier": "^6.0.8",
     "@types/uuid": "^9.0.7",
-    "@typescript-eslint/eslint-plugin": "^6.13.2",
-    "@typescript-eslint/parser": "^6.13.2",
+    "@typescript-eslint/eslint-plugin": "^6.16.0",
+    "@typescript-eslint/parser": "^6.16.0",
     "c8": "^8.0.1",
-    "eslint": "^8.55.0",
+    "eslint": "^8.56.0",
     "eslint-plugin-cli-microsoft365": "file:eslint-rules",
     "eslint-plugin-mocha": "^10.2.0",
     "mocha": "^10.2.0",
@@ -301,4 +301,4 @@
     "sinon": "^17.0.0",
     "source-map-support": "^0.5.21"
   }
-}
+}

package/dist/m365/aad/commands/m365group/m365group-user-list.js

@@ -1,94 +0,0 @@
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _AadM365GroupUserListCommand_instances, _AadM365GroupUserListCommand_initTelemetry, _AadM365GroupUserListCommand_initOptions, _AadM365GroupUserListCommand_initValidators;
-import { odata } from '../../../../utils/odata.js';
-import { validation } from '../../../../utils/validation.js';
-import GraphCommand from '../../../base/GraphCommand.js';
-import commands from '../../commands.js';
-import { aadGroup } from '../../../../utils/aadGroup.js';
-class AadM365GroupUserListCommand extends GraphCommand {
-    get name() {
-        return commands.M365GROUP_USER_LIST;
-    }
-    get description() {
-        return "Lists users for the specified Microsoft 365 group";
-    }
-    constructor() {
-        super();
-        _AadM365GroupUserListCommand_instances.add(this);
-        __classPrivateFieldGet(this, _AadM365GroupUserListCommand_instances, "m", _AadM365GroupUserListCommand_initTelemetry).call(this);
-        __classPrivateFieldGet(this, _AadM365GroupUserListCommand_instances, "m", _AadM365GroupUserListCommand_initOptions).call(this);
-        __classPrivateFieldGet(this, _AadM365GroupUserListCommand_instances, "m", _AadM365GroupUserListCommand_initValidators).call(this);
-    }
-    async commandAction(logger, args) {
-        try {
-            const isUnifiedGroup = await aadGroup.isUnifiedGroup(args.options.groupId);
-            if (!isUnifiedGroup) {
-                throw Error(`Specified group with id '${args.options.groupId}' is not a Microsoft 365 group.`);
-            }
-            let users = await this.getOwners(args.options.groupId, logger);
-            if (args.options.role !== 'Owner') {
-                const membersAndGuests = await this.getMembersAndGuests(args.options.groupId, logger);
-                users = users.concat(membersAndGuests);
-            }
-            if (args.options.role) {
-                users = users.filter(i => i.userType === args.options.role);
-            }
-            await logger.log(users);
-        }
-        catch (err) {
-            this.handleRejectedODataJsonPromise(err);
-        }
-    }
-    async getOwners(groupId, logger) {
-        if (this.verbose) {
-            await logger.logToStderr(`Retrieving owners of the group with id ${groupId}`);
-        }
-        const endpoint = `${this.resource}/v1.0/groups/${groupId}/owners?$select=id,displayName,userPrincipalName,userType`;
-        const users = await odata.getAllItems(endpoint);
-        // Currently there is a bug in the Microsoft Graph that returns Owners as
-        // userType 'member'. We therefore update all returned user as owner
-        users.forEach(user => {
-            user.userType = 'Owner';
-        });
-        return users;
-    }
-    async getMembersAndGuests(groupId, logger) {
-        if (this.verbose) {
-            await logger.logToStderr(`Retrieving members of the group with id ${groupId}`);
-        }
-        const endpoint = `${this.resource}/v1.0/groups/${groupId}/members?$select=id,displayName,userPrincipalName,userType`;
-        return await odata.getAllItems(endpoint);
-    }
-}
-_AadM365GroupUserListCommand_instances = new WeakSet(), _AadM365GroupUserListCommand_initTelemetry = function _AadM365GroupUserListCommand_initTelemetry() {
-    this.telemetry.push((args) => {
-        Object.assign(this.telemetryProperties, {
-            role: args.options.role
-        });
-    });
-}, _AadM365GroupUserListCommand_initOptions = function _AadM365GroupUserListCommand_initOptions() {
-    this.options.unshift({
-        option: "-i, --groupId <groupId>"
-    }, {
-        option: "-r, --role [type]",
-        autocomplete: ["Owner", "Member", "Guest"]
-    });
-}, _AadM365GroupUserListCommand_initValidators = function _AadM365GroupUserListCommand_initValidators() {
-    this.validators.push(async (args) => {
-        if (!validation.isValidGuid(args.options.groupId)) {
-            return `${args.options.groupId} is not a valid GUID`;
-        }
-        if (args.options.role) {
-            if (['Owner', 'Member', 'Guest'].indexOf(args.options.role) === -1) {
-                return `${args.options.role} is not a valid role value. Allowed values Owner|Member|Guest`;
-            }
-        }
-        return true;
-    });
-};
-export default new AadM365GroupUserListCommand();
-//# sourceMappingURL=m365group-user-list.js.map

package/docs/docs/cmd/aad/app/app-permission-add.mdx

@@ -1,62 +0,0 @@
-import Global from '/docs/cmd/_global.mdx';
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
-
-# aad app permission add
-
-Adds the specified application and/or delegated permissions to a specified Entra ID (Azure AD) app
-
-## Usage
-
-```sh
-m365 aad app permission add [options]
-```
-
-## Options
-
-```md definition-list
-`-i, --appId [appId]`
-: Client ID of the Entra ID (Azure AD) app to add the API permissions to. Specify `appId` or `appObjectId` but not both.
-
-`--appObjectId [appObjectId]`
-: Object ID of the Entra ID (Azure AD) app to add the API permissions to. Specify `appId` or `appObjectId` but not both.
-
-`-a, --applicationPermissions [applicationPermissions]`
-: Space-separated list of application permissions to add. Specify at least `applicationPermissions` or `delegatedPermissions`.
-
-`-d, --delegatedPermissions [delegatedPermissions]`
-: Space-separated list of delegated permissions to add. Specify at least `applicationPermissions` or `delegatedPermissions`.
-
-`--grantAdminConsent`
-: When specified, grants application & delegated permissions through admin consent.
-```
-
-<Global />
-
-## Remarks
-
-Scopes/Roles to grant must be fully-qualified so that we can disambiguate them between the different resources.
-
-## Examples
-
-Grant multiple delegated API permissions to an Entra ID (Azure AD) app specified by client id
-
-```sh
-m365 aad app permission add --appId 'f1417aa3-bf0b-4cc5-a845-a0b2cf11f690' --delegatedPermissions 'https://management.azure.com/user_impersonation https://service.flow.microsoft.com/Flows.Read.All https://graph.microsoft.com/Agreement.Read.All'
-```
-
-Grant multiple delegated API permissions to an Entra ID (Azure AD) app specified by object id
-
-```sh
-m365 aad app permission add --appObjectId 'e0306bb2-bf0b-4cc5-a845-a0b2cf11f690' --delegatedPermissions 'https://management.azure.com/user_impersonation https://service.flow.microsoft.com/Flows.Read.All https://graph.microsoft.com/Agreement.Read.All'
-```
-
-Grant multiple app-only permissions to an Entra ID (Azure AD) app specified by client id and grant admin consent
-
-```sh
-m365 aad app permission add --appId 'f1417aa3-bf0b-4cc5-a845-a0b2cf11f690' --applicationPermissions 'https://graph.microsoft.com/Sites.FullControl.All https://microsoft.sharepoint-df.com/Sites.FullControl.All' --grandAdminConsent
-```
-
-## Response
-
-The command won't return a response on success.

package/docs/docs/cmd/aad/app/app-remove.mdx

@@ -1,59 +0,0 @@
-import Global from '/docs/cmd/_global.mdx';
-
-# aad app remove
-
-Removes an Azure AD app registration
-
-## Usage
-
-```sh
-m365 aad app remove [options]
-```
-
-## Options
-
-```md definition-list
-`--appId [appId]`
-: Application (client) ID of the Azure AD application registration to remove. Specify either `appId`, `objectId` or `name` but not multiple.
-
-`--objectId [objectId]`
-: Object ID of the Azure AD application registration to remove. Specify either `appId`, `objectId` or `name` but not multiple.
-
-`--name [name]`
-: Name of the Azure AD application registration to remove. Specify either `appId`, `objectId` or `name` but not multiple.
-
-`-f, --force`
-: Don't prompt for confirmation to remove the app.
-```
-
-<Global />
-
-## Remarks
-
-For best performance use the `objectId` option to reference the Azure AD application registration to remove. If you use `appId` or `name`, this command will first need to find the corresponding object ID for that application.
-
-If the command finds multiple Azure AD application registrations with the specified app name, it will prompt you to disambiguate which app it should use, listing the discovered object IDs.
-
-## Examples
-
-Remove the Azure AD application registration by its app (client) ID.
-
-```sh
-m365 aad app remove --appId d75be2e1-0204-4f95-857d-51a37cf40be8
-```
-
-Remove the Azure AD application registration by its object ID.
-
-```sh
-m365 aad app remove --objectId d75be2e1-0204-4f95-857d-51a37cf40be8
-```
-
-Remove the Azure AD application registration by its name. Will NOT prompt for confirmation before deleting.
-
-```sh
-m365 aad app remove --name "My app" --force
-```
-
-## Response
-
-The command won't return a response on success.

package/docs/docs/cmd/aad/app/app-role-add.mdx

@@ -1,68 +0,0 @@
-import Global from '/docs/cmd/_global.mdx';
-
-# aad app role add
-
-Adds role to the specified Azure AD app registration
-
-## Usage
-
-```sh
-m365 aad app role add [options]
-```
-
-## Options
-
-```md definition-list
-`--appId [appId]`
-: Application (client) ID of the Azure AD application registration to which to add the role. Specify either `appId`, `appObjectId` or `appName`
-
-`--appObjectId [appObjectId]`
-: Object ID of the Azure AD application registration to which to add the role. Specify either `appId`, `appObjectId` or `appName`
-
-`--appName [appName]`
-: Name of the Azure AD application registration to which to add the role. Specify either `appId`, `appObjectId` or `appName`
-
-`-n, --name <name>`
-: Name of the role to add
-
-`-d, --description <description>`
-: Description of the role to add
-
-`-m, --allowedMembers <allowedMembers>`
-: Types of members that can be added to the group. Allowed values: `usersGroups`, `applications`, `both`
-
-`-c, --claim <claim>`
-: Claim value
-```
-
-<Global />
-
-## Remarks
-
-For best performance use the `appObjectId` option to reference the Azure AD application registration for which to add the role. If you use `appId` or `appName`, this command will first need to find the corresponding object ID for that application.
-
-If the command finds multiple Azure AD application registrations with the specified app name, it will prompt you to disambiguate which app it should use, listing the discovered object IDs.
-
-## Examples
-
-Add role to the Azure AD application registration specified by its object ID
-
-```sh
-m365 aad app role add --appObjectId d75be2e1-0204-4f95-857d-51a37cf40be8 --name Managers --description "Managers" --allowedMembers usersGroups --claim managers
-```
-
-Add role to the Azure AD application registration specified by its app (client) ID
-
-```sh
-m365 aad app role add --appId e75be2e1-0204-4f95-857d-51a37cf40be8 --name Managers --description "Managers" --allowedMembers usersGroups --claim managers
-```
-
-Add role to the Azure AD application registration specified by its name
-
-```sh
-m365 aad app role add --appName "My app" --name Managers --description "Managers" --allowedMembers usersGroups --claim managers
-```
-
-## Response
-
-The command won't return a response on success.

package/docs/docs/cmd/aad/app/app-role-remove.mdx

@@ -1,78 +0,0 @@
-import Global from '/docs/cmd/_global.mdx';
-
-# aad app role remove
-
-Removes role from the specified Azure AD app registration
-
-## Usage
-
-```sh
-m365 aad app role remove [options]
-```
-
-## Options
-
-```md definition-list
-`--appId [appId]`
-: Application (client) ID of the Azure AD application registration from which role should be removed. Specify either `appId`, `appObjectId` or `appName`
-
-`--appObjectId [appObjectId]`
-: Object ID of the Azure AD application registration from which role should be removed. Specify either `appId`, `appObjectId` or `appName`
-
-`--appName [appName]`
-: Name of the Azure AD application registration from which role should be removed. Specify either `appId`, `appObjectId` or `appName`
-
-`-n, --name [name]`
-: Name of the role to remove. Specify either `name`, `id` or `claim`
-
-`-i, --id [id]`
-: Id of the role to remove. Specify either `name`, `id` or `claim`
-
-`-c, --claim [claim]`
-: Claim value of the role to remove. Specify either `name`, `id` or `claim`
-
-`-f, --force`
-: Don't prompt for confirmation to remove the role.
-```
-
-<Global />
-
-## Remarks
-
-For best performance use the `appObjectId` option to reference the Azure AD application registration from which to remove the role. If you use `appId` or `appName`, this command will first need to find the corresponding object ID for that application.
-
-If the command finds multiple Azure AD application registrations with the specified app name, it will prompt you to disambiguate which app it should use, listing the discovered object IDs.
-
-If the command finds multiple roles with the specified role name, it will prompt you to disambiguate which role it should use, listing the claim values.
-
-If the role to be removed is 'Enabled', this command will disable the role first and then remove.
-
-## Examples
-
-Remove role from a Azure AD application registration using object ID and role name options. Will prompt for confirmation before deleting the role.
-
-```sh
-m365 aad app role remove --appObjectId d75be2e1-0204-4f95-857d-51a37cf40be8 --name "Get Product"
-```
-
-Remove role from a Azure AD application registration using app (client) ID and role claim options. Will prompt for confirmation before deleting the role.
-
-```sh
-m365 aad app role remove --appId e75be2e1-0204-4f95-857d-51a37cf40be8 --claim "Product.Get"
-```
-
-Remove role from a Azure AD application registration using app name and role claim options. Will prompt for confirmation before deleting the role.
-
-```sh
-m365 aad app role remove --appName "My app" --claim "Product.Get"
-```
-
-Remove role from a Azure AD application registration using object ID and role id options. Will NOT prompt for confirmation before deleting the role.
-
-```sh
-m365 aad app role remove --appObjectId d75be2e1-0204-4f95-857d-51a37cf40be8 --id 15927ce6-1933-4b2f-b029-4dee3d53f4dd --force
-```
-
-## Response
-
-The command won't return a response on success.

package/docs/docs/cmd/aad/app/app-set.mdx

@@ -1,97 +0,0 @@
-import Global from '/docs/cmd/_global.mdx';
-
-# aad app set
-
-Updates Azure AD app registration
-
-## Usage
-
-```sh
-m365 aad app set [options]
-```
-
-## Options
-
-```md definition-list
-`--appId [appId]`
-: Application (client) ID of the Azure AD application registration to update. Specify either `appId`, `objectId` or `name`.
-
-`--objectId [objectId]`
-: Object ID of the Azure AD application registration to update. Specify either `appId`, `objectId` or `name`.
-
-`--name [name]`
-: Name of the Azure AD application registration to update. Specify either `appId`, `objectId` or `name`.
-
-`-u, --uris [uris]`
-: Comma-separated list of Application ID URIs to update.
-
-`-r, --redirectUris [redirectUris]`
-: Comma-separated list of redirect URIs to add to the app registration. Requires `platform` to be specified.
-
-`-p, --platform [platform]`
-: Platform for which the `redirectUri` should be configured. Allowed values `spa`, `web`, `publicClient`.
-
-`--redirectUrisToRemove [redirectUrisToRemove]`
-: Comma-separated list of existing redirect URIs to remove. Specify, when you want to replace existing redirect URIs with another.
-
-`--certificateFile [certificateFile]`
-: Path to the file with certificate public key. Specify either `certificateFile` or `certificateBase64Encoded`.
-
-`--certificateBase64Encoded [certificateBase64Encoded]`
-: Base64-encoded string with certificate public key. Specify either `certificateFile` or `certificateBase64Encoded`.
-
-`--certificateDisplayName [certificateDisplayName]`
-: Display name for the certificate. If not given, the displayName will be set to the certificate subject. When specified, also specify either `certificateFile` or `certificateBase64Encoded`.
-```
-
-<Global />
-
-## Remarks
-
-For best performance use the `objectId` option to reference the Azure AD application registration to update. If you use `appId` or `name`, this command will first need to find the corresponding object ID for that application.
-
-If the command finds multiple Azure AD application registrations with the specified app name, it will prompt you to disambiguate which app it should use, listing the discovered object IDs.
-
-When a certificate is specified it will be added to the list of certificates of the app without changing existing certificates.
-
-## Examples
-
-Update the app URI of the Azure AD application registration specified by its object ID
-
-```sh
-m365 aad app set --objectId d75be2e1-0204-4f95-857d-51a37cf40be8 --uris https://contoso.com/e75be2e1-0204-4f95-857d-51a37cf40be8
-```
-
-Update the app URI of the Azure AD application registration specified by its app (client) ID
-
-```sh
-m365 aad app set --appId e75be2e1-0204-4f95-857d-51a37cf40be8 --uris https://contoso.com/e75be2e1-0204-4f95-857d-51a37cf40be8
-```
-
-Update the app URI of the Azure AD application registration specified by its name
-
-```sh
-m365 aad app set --name "My app" --uris https://contoso.com/e75be2e1-0204-4f95-857d-51a37cf40be8
-```
-
-Add a new redirect URI for SPA authentication
-
-```sh
-m365 aad app set --objectId 95cfe30d-ed44-4f9d-b73d-c66560f72e83 --redirectUris https://contoso.com/auth --platform spa
-```
-
-Replace one redirect URI with another for SPA authentication
-
-```sh
-m365 aad app set --objectId 95cfe30d-ed44-4f9d-b73d-c66560f72e83 --redirectUris https://contoso.com/auth --platform spa --redirectUrisToRemove https://contoso.com/old-auth
-```
-
-Add a certificate to the app
-
-```sh
-m365 aad app set --appId e75be2e1-0204-4f95-857d-51a37cf40be8 --certificateDisplayName "Some certificate name" --certificateFile "c:\temp\some-certificate.cer"
-```
-
-## Response
-
-The command won't return a response on success.

package/docs/docs/cmd/aad/group/group-remove.mdx

@@ -1,44 +0,0 @@
-import Global from '/docs/cmd/_global.mdx';
-
-# aad group remove
-
-Removes an Azure AD group
-
-## Usage
-
-```sh
-m365 aad group remove [options]
-```
-
-## Options
-
-```md definition-list
-`-i, --id [id]`
-: The ID of the Azure AD group. Specify either `id` or `displayName` but not both.
-
-`-n, --displayName [displayName]`
-: The display name of the Azure AD group. Specify either `id` or `displayName` but not both.
-
-`-f, --force`
-: Don't prompt for confirmation.
-```
-
-<Global />
-
-## Examples
-
-Remove an Azure AD group by display name
-
-```sh
-m365 aad group remove --displayName Developers
-```
-
-Remove an Azure AD group by ID
-
-```sh
-m365 aad group remove --id 016bf125-195b-43c5-a1a0-28ccd3192c6d
-```
-
-## Response
-
-The command won't return a response on success.

package/docs/docs/cmd/aad/m365group/m365group-user-list.mdx

@@ -1,99 +0,0 @@
-import Global from '/docs/cmd/_global.mdx';
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
-
-# aad m365group user list
-
-Lists users for the specified Microsoft 365 group
-
-## Usage
-
-```sh
-m365 aad m365group user list [options]
-```
-
-## Options
-
-```md definition-list
-`-i, --groupId <groupId>`
-: The ID of the Microsoft 365 group for which to list users
-
-`-r, --role [role]`
-: Filter the results to only users with the given role: `Owner`, `Member`, `Guest`
-```
-
-<Global />
-
-## Examples
-
-List all users and their role in the specified Microsoft 365 group
-
-```sh
-m365 aad m365group user list --groupId '00000000-0000-0000-0000-000000000000'
-```
-
-List all owners and their role in the specified Microsoft 365 group
-
-```sh
-m365 aad m365group user list --groupId '00000000-0000-0000-0000-000000000000' --role Owner
-```
-
- List all guests and their role in the specified Microsoft 365 group
-
-```sh
-m365 aad m365group user list --groupId '00000000-0000-0000-0000-000000000000' --role Guest
-```
-
-## Response
-
-<Tabs>
-  <TabItem value="JSON">
-
-  ```json
-  [
-    {
-      "id": "da52218e-4822-4ac6-b41d-255e2059655e",
-      "displayName": "Adele Vance",
-      "userPrincipalName": "AdeleV@contoso.OnMicrosoft.com",
-      "userType": "Member"
-    }
-  ]
-  ```
-
-  </TabItem>
-  <TabItem value="Text">
-
-  ```text
-  id                                    displayName           userPrincipalName                     userType
-  ------------------------------------  --------------------  ------------------------------------  --------
-  da52218e-4822-4ac6-b41d-255e2059655e  Adele Vance           AdeleV@contoso.OnMicrosoft.com  Member
-  ```
-
-  </TabItem>
-  <TabItem value="CSV">
-
-  ```csv
-  id,displayName,userPrincipalName,userType
-  da52218e-4822-4ac6-b41d-255e2059655e,Adele Vance,AdeleV@contoso.OnMicrosoft.com,Member
-  ```
-
-  </TabItem>
-  <TabItem value="Markdown">
-
-  ```md
-  # aad m365group user list --groupId "1deaa428-8dde-4043-b028-5492226d6114"
-
-  Date: 2023-06-02
-
-  ## Adele Vance (da52218e-4822-4ac6-b41d-255e2059655e)
-
-  Property | Value
-  ---------|-------
-  id | da52218e-4822-4ac6-b41d-255e2059655e
-  displayName | Adele Vance
-  userPrincipalName | AdeleV@contoso.OnMicrosoft.com
-  userType | Member
-  ```
-
-  </TabItem>
-</Tabs>