@pnp/cli-microsoft365 11.2.0-beta.e0616e6 → 11.3.0-beta.ad8e99a

package/dist/m365/teams/commands/channel/channel-add.js

@@ -8,8 +8,7 @@ import request from '../../../../request.js';
 import { validation } from '../../../../utils/validation.js';
 import GraphCommand from "../../../base/GraphCommand.js";
 import commands from '../../commands.js';
-import { cli } from '../../../../cli/cli.js';
-import { formatting } from '../../../../utils/formatting.js';
+import { teams } from '../../../../utils/teams.js';
 class TeamsChannelAddCommand extends GraphCommand {
     get name() {
         return commands.CHANNEL_ADD;
@@ -25,30 +24,21 @@ class TeamsChannelAddCommand extends GraphCommand {
         __classPrivateFieldGet(this, _TeamsChannelAddCommand_instances, "m", _TeamsChannelAddCommand_initValidators).call(this);
         __classPrivateFieldGet(this, _TeamsChannelAddCommand_instances, "m", _TeamsChannelAddCommand_initOptionSets).call(this);
     }
+    async commandAction(logger, args) {
+        try {
+            const teamId = await this.getTeamId(args);
+            const res = await this.createChannel(args, teamId);
+            await logger.log(res);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
     async getTeamId(args) {
         if (args.options.teamId) {
             return args.options.teamId;
         }
-        const teamRequestOptions = {
-            url: `${this.resource}/v1.0/me/joinedTeams`,
-            headers: {
-                accept: 'application/json;odata.metadata=none'
-            },
-            responseType: 'json'
-        };
-        const response = await request.get(teamRequestOptions);
-        const matchingTeams = response.value
-            .filter(team => team.displayName === args.options.teamName)
-            .map(team => team.id);
-        if (matchingTeams.length < 1) {
-            throw `The specified team does not exist in the Microsoft Teams`;
-        }
-        if (matchingTeams.length > 1) {
-            const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', response.value);
-            const result = await cli.handleMultipleResultsFound(`Multiple Microsoft Teams teams with name ${args.options.teamName} found.`, resultAsKeyValuePair);
-            return result.id;
-        }
-        return matchingTeams[0];
+        return await teams.getTeamIdByDisplayName(args.options.teamName);
     }
     async createChannel(args, teamId) {
         const requestOptions = {
@@ -68,23 +58,13 @@ class TeamsChannelAddCommand extends GraphCommand {
             requestOptions.data.members = [
                 {
                     '@odata.type': '#microsoft.graph.aadUserConversationMember',
-                    'user@odata.bind': `https://graph.microsoft.com/v1.0/users('${args.options.owner}')`,
+                    'user@odata.bind': `${this.resource}/v1.0/users('${args.options.owner}')`,
                     roles: ['owner']
                 }
             ];
         }
         return request.post(requestOptions);
     }
-    async commandAction(logger, args) {
-        try {
-            const teamId = await this.getTeamId(args);
-            const res = await this.createChannel(args, teamId);
-            await logger.log(res);
-        }
-        catch (err) {
-            this.handleRejectedODataJsonPromise(err);
-        }
-    }
 }
 _TeamsChannelAddCommand_instances = new WeakSet(), _TeamsChannelAddCommand_initTelemetry = function _TeamsChannelAddCommand_initTelemetry() {
     this.telemetry.push((args) => {

package/dist/utils/stringUtil.js

@@ -0,0 +1,4 @@
+export const stringUtil = {
+    normalizeLineEndings: (str) => str?.replace(/\r\n/g, '\n')
+};
+//# sourceMappingURL=stringUtil.js.map

package/docs/docs/cmd/entra/groupsettingtemplate/groupsettingtemplate-get.mdx

@@ -24,6 +24,25 @@ m365 entra groupsettingtemplate get [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource         | Permissions            |
+  |------------------|------------------------|
+  | Microsoft Graph  | GroupSettings.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource         | Permissions            |
+  |------------------|------------------------|
+  | Microsoft Graph  | GroupSettings.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get information about the group setting template with id _62375ab9-6b52-47ed-826b-58e47e0e304b_
@@ -97,4 +116,4 @@ m365 entra groupsettingtemplate get --displayName Group.Unified
   ```
 
   </TabItem>
-</Tabs>
+</Tabs>

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

@@ -16,6 +16,27 @@ m365 entra groupsettingtemplate list [options]
 
 <Global />
 
+## Permissions
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource         | Permissions            |
+  |------------------|------------------------|
+  | Microsoft Graph  | GroupSettings.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource         | Permissions            |
+  |------------------|------------------------|
+  | Microsoft Graph  | GroupSettings.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 List all group setting templates in the tenant
@@ -83,4 +104,4 @@ m365 entra groupsettingtemplate list
   ```
 
   </TabItem>
-</Tabs>
+</Tabs>

package/docs/docs/cmd/login.mdx

@@ -118,54 +118,72 @@ Log in to Microsoft 365 using your own Microsoft Entra application and a persona
 m365 login --authType certificate --appId 31359c7f-bd7e-475c-86db-fdb8c937548c --tenant 31359c7f-bd7e-475c-86db-fdb8c937548a --certificateFile /Users/user/dev/localhost.pfx --password 'pass@word1'
 ```
 
-Log in to Microsoft 365 using a user name and password with `clientId` set in the configuration.
+Log in to Microsoft 365 using a user name and password by providing the application and tenant identifiers explicitly.
 
 ```sh
-m365 login --authType password --userName user@contoso.com --password pass@word1
+m365 login --authType password --appId 31359c7f-bd7e-475c-86db-fdb8c937548c --tenant 31359c7f-bd7e-475c-86db-fdb8c937548a --userName user@contoso.com --password pass@word1
 ```
 
-Log in to Microsoft 365 using a PEM certificate with `clientId` set in the configuration.
+Log in to Microsoft 365 using a PEM certificate with `CLIMICROSOFT365_ENTRAAPPID` and `CLIMICROSOFT365_TENANT` environment variables set.
 
 ```sh
 m365 login --authType certificate --certificateFile /Users/user/dev/localhost.pem
 ```
 
-Log in to Microsoft 365 using a PEM certificate with `clientId` set in the configuration. Use the specified thumbprint.
+Log in to Microsoft 365 using a PEM certificate and a specific thumbprint with `CLIMICROSOFT365_ENTRAAPPID` and `CLIMICROSOFT365_TENANT` environment variables set.
 
 ```sh
-m365 login --authType certificate --certificateFile /Users/user/dev/localhost.pem  --thumbprint 47C4885736C624E90491F32B98855AA8A7562AF1
+m365 login --authType certificate --certificateFile /Users/user/dev/localhost.pem --thumbprint 47C4885736C624E90491F32B98855AA8A7562AF1
 ```
 
-Log in to Microsoft 365 using a personal information exchange (.pfx) file with `CLIMICROSOFT365_ENTRAAPPID` environment variable set.
+Log in to Microsoft 365 using a PEM certificate by providing the application and tenant identifiers explicitly.
+
+```sh
+m365 login --authType certificate --appId 31359c7f-bd7e-475c-86db-fdb8c937548c --tenant 31359c7f-bd7e-475c-86db-fdb8c937548a --certificateFile /Users/user/dev/localhost.pem
+```
+
+Log in to Microsoft 365 using a personal information exchange (.pfx) file with `CLIMICROSOFT365_ENTRAAPPID` and `CLIMICROSOFT365_TENANT` environment variables set.
 
 ```sh
 m365 login --authType certificate --certificateFile /Users/user/dev/localhost.pfx --password 'pass@word1'
 ```
 
-Log in to Microsoft 365 using a personal information exchange (.pfx) file protected with an empty password and `CLIMICROSOFT365_ENTRAAPPID` environment variable set.
+Log in to Microsoft 365 using a personal information exchange (.pfx) file protected with an empty password with `CLIMICROSOFT365_ENTRAAPPID` and `CLIMICROSOFT365_TENANT` environment variables set.
 
 ```sh
 m365 login --authType certificate --certificateFile /Users/user/dev/localhost.pfx --password
 ```
 
-Log in to Microsoft 365 using a personal information exchange (.pfx) file not protected with a password and `CLIMICROSOFT365_ENTRAAPPID` environment variable set.
+Log in to Microsoft 365 using a personal information exchange (.pfx) file not protected with a password with `CLIMICROSOFT365_ENTRAAPPID` and `CLIMICROSOFT365_TENANT` environment variables set.
 
 ```sh
 m365 login --authType certificate --certificateFile /Users/user/dev/localhost.pfx
 ```
 
-Log in to Microsoft 365 using a personal information exchange (.pfx) file. Use the specified thumbprint and `CLIMICROSOFT365_ENTRAAPPID` environment variable set.
+Log in to Microsoft 365 using a personal information exchange (.pfx) file and a specific thumbprint with `CLIMICROSOFT365_ENTRAAPPID` and `CLIMICROSOFT365_TENANT` environment variables set.
 
 ```sh
 m365 login --authType certificate --certificateFile /Users/user/dev/localhost.pfx --thumbprint 47C4885736C624E90491F32B98855AA8A7562AF1 --password 'pass@word1'
 ```
 
-Log in to Microsoft 365 using a certificate from a base64-encoded string with `CLIMICROSOFT365_ENTRAAPPID` environment variable set.
+Log in to Microsoft 365 using a personal information exchange (.pfx) file by providing the application and tenant identifiers explicitly.
+
+```sh
+m365 login --authType certificate --appId 31359c7f-bd7e-475c-86db-fdb8c937548c --tenant 31359c7f-bd7e-475c-86db-fdb8c937548a --certificateFile /Users/user/dev/localhost.pfx --password 'pass@word1'
+```
+
+Log in to Microsoft 365 using a certificate from a base64-encoded string with `CLIMICROSOFT365_ENTRAAPPID` and `CLIMICROSOFT365_TENANT` environment variables set.
 
 ```sh
 m365 login --authType certificate --certificateBase64Encoded MIII2QIBAzCCCJ8GCSqGSIb3DQEHAaCCCJAEg...eX1N5AgIIAA== --thumbprint D0C9B442DE249F55D10CDA1A2418952DC7D407A3
 ```
 
+Log in to Microsoft 365 using a certificate from a base64-encoded string by providing the application and tenant identifiers explicitly.
+
+```sh
+m365 login --authType certificate --appId 31359c7f-bd7e-475c-86db-fdb8c937548c --tenant 31359c7f-bd7e-475c-86db-fdb8c937548a --certificateBase64Encoded MIII2QIBAzCCCJ8GCSqGSIb3DQEHAaCCCJAEg...eX1N5AgIIAA== --thumbprint D0C9B442DE249F55D10CDA1A2418952DC7D407A3
+```
+
 Log in to Microsoft 365 using a system assigned managed identity with `clientId` set in the configuration. Applies to Azure resources with managed identity enabled, such as Azure Virtual Machines, Azure App Service or Azure Functions.
 
 ```sh
@@ -196,12 +214,18 @@ Log in to Microsoft 365 using the interactive browser authentication with `clien
 m365 login --authType browser
 ```
 
-Log in to Microsoft 365 using a client secret with `clientId` set in the configuration.
+Log in to Microsoft 365 using a client secret with `CLIMICROSOFT365_ENTRAAPPID` and `CLIMICROSOFT365_TENANT` environment variables set.
 
 ```sh
 m365 login --authType secret --secret topSeCr3t@007
 ```
 
+Log in to Microsoft 365 using a client secret by providing the application and tenant identifiers explicitly.
+
+```sh
+m365 login --authType secret --appId 31359c7f-bd7e-475c-86db-fdb8c937548c --tenant 31359c7f-bd7e-475c-86db-fdb8c937548a --secret topSeCr3t@007
+```
+
 Ensures that the user is signed in, initiates the login flow if the user isn't signed in
 
 ```sh

package/docs/docs/cmd/onenote/notebook/notebook-add.mdx

@@ -36,6 +36,23 @@ m365 onenote notebook add [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                                                      |
+  |-----------------|------------------------------------------------------------------|
+  | Microsoft Graph | Notes.Create, Sites.Read.All, User.ReadBasic.All, Group.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  This command does not support application permissions.
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Create a Microsoft OneNote notebook for the currently logged in user

package/docs/docs/cmd/onenote/notebook/notebook-list.mdx

@@ -33,6 +33,23 @@ m365 onenote notebook list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                                                        |
+  |-----------------|--------------------------------------------------------------------|
+  | Microsoft Graph | Notes.Read.All, Sites.Read.All, User.ReadBasic.All, Group.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  This command does not support application permissions.
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 List Microsoft OneNote notebooks for the currently logged in user

package/docs/docs/cmd/onenote/page/page-list.mdx

@@ -35,7 +35,24 @@ m365 onenote page list [options]
 
 ## Remarks
 
-When we don't specify either `userId`, `userName`, `groupId`, `groupName` or `webUrl`, the OneNote pages will be retrieved of the currently logged in user.
+When you don't specify either `userId`, `userName`, `groupId`, `groupName` or `webUrl`, the OneNote pages will be retrieved of the currently logged in user.
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                                                        |
+  |-----------------|--------------------------------------------------------------------|
+  | Microsoft Graph | Notes.Read.All, Sites.Read.All, User.ReadBasic.All, Group.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  This command does not support application permissions.
+
+  </TabItem>
+</Tabs>
 
 ## Examples
 

package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-add.mdx

@@ -22,6 +22,9 @@ m365 spo applicationcustomizer add [options]
 `-i, --clientSideComponentId <clientSideComponentId>`
 : Client-side component ID of the application customizer (GUID).
 
+`--description [description]`
+: Description of the application customizer.
+
 `--clientSideComponentProperties [clientSideComponentProperties]`
 : JSON string with application customizer properties.
 

package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-set.mdx

@@ -28,6 +28,9 @@ m365 spo applicationcustomizer set [options]
 `--newTitle [newTitle]`
 : The new title of the Application Customizer.
 
+`--description [description]`
+: Description of the application customizer. Specify an empty string to clear.
+
 `-p, --clientSideComponentProperties  [clientSideComponentProperties]`
 : The Client Side Component properties of the Application Customizer.
 

package/docs/docs/cmd/spo/commandset/commandset-add.mdx

@@ -27,6 +27,9 @@ m365 spo commandset add [options]
 `-i, --clientSideComponentId <clientSideComponentId>`
 : The Client Side Component Id (GUID) of the ListView Command Set.
 
+`--description [description]`
+: Description of the ListView Command Set.
+
 `--clientSideComponentProperties [clientSideComponentProperties]`
 : The Client Side Component properties of the ListView Command Set.
 

package/docs/docs/cmd/spo/commandset/commandset-set.mdx

@@ -31,6 +31,9 @@ m365 spo commandset set [options]
 `--newTitle [newTitle]`
 : The new title of the ListView Command Set.
 
+`--description [description]`
+: Description of the ListView Command Set. Specify an empty string to clear.
+
 `-l, --listType [listType]`
 : The list or library type to register the Command Set on. Allowed values are: `List`, `Library` or `SitePages`.