@pnp/cli-microsoft365 4.0.0-beta.f87506e → 4.1.0-beta.6c0929c

package/dist/m365/spo/commands/term/term-group-add.js

@@ -51,7 +51,7 @@ class SpoTermGroupAddCommand extends SpoCommand_1.default {
                 return Promise.reject(response.ErrorInfo.ErrorMessage);
             }
             const termStore = json[json.length - 1];
-            const termGroupId = args.options.id || uuid_1.v4();
+            const termGroupId = args.options.id || (0, uuid_1.v4)();
             if (this.verbose) {
                 logger.logToStderr(`Adding taxonomy term group...`);
             }

package/dist/m365/spo/commands/term/term-set-add.js

@@ -41,7 +41,7 @@ class SpoTermSetAddCommand extends SpoCommand_1.default {
             const termGroupQuery = args.options.termGroupName ?
                 `<Method Id="42" ParentId="40" Name="GetByName"><Parameters><Parameter Type="String">${Utils_1.default.escapeXml(args.options.termGroupName)}</Parameter></Parameters></Method>` :
                 `<Method Id="42" ParentId="40" Name="GetById"><Parameters><Parameter Type="Guid">{${args.options.termGroupId}}</Parameter></Parameters></Method>`;
-            const termSetId = args.options.id || uuid_1.v4();
+            const termSetId = args.options.id || (0, uuid_1.v4)();
             const requestOptions = {
                 url: `${spoAdminUrl}/_vti_bin/client.svc/ProcessQuery`,
                 headers: {

package/dist/m365/spo/commands/theme/theme-list.js

@@ -11,7 +11,7 @@ class SpoThemeListCommand extends SpoCommand_1.default {
         return 'Retrieves the list of custom themes';
     }
     defaultProperties() {
-        return ['Name'];
+        return ['name'];
     }
     commandAction(logger, args, cb) {
         this

package/dist/m365/spo/commands.js

@@ -6,6 +6,7 @@ exports.default = {
     APP_DEPLOY: `${prefix} app deploy`,
     APP_GET: `${prefix} app get`,
     APP_INSTALL: `${prefix} app install`,
+    APP_INSTANCE_LIST: `${prefix} app instance list`,
     APP_LIST: `${prefix} app list`,
     APP_REMOVE: `${prefix} app remove`,
     APP_RETRACT: `${prefix} app retract`,
@@ -61,6 +62,7 @@ exports.default = {
     GROUP_LIST: `${prefix} group list`,
     GROUP_REMOVE: `${prefix} group remove`,
     GROUP_USER_ADD: `${prefix} group user add`,
+    GROUP_USER_LIST: `${prefix} group user list`,
     HIDEDEFAULTTHEMES_GET: `${prefix} hidedefaultthemes get`,
     HIDEDEFAULTTHEMES_SET: `${prefix} hidedefaultthemes set`,
     HOMESITE_GET: `${prefix} homesite get`,
@@ -168,6 +170,7 @@ exports.default = {
     SITE_APPPERMISSION_ADD: `${prefix} site apppermission add`,
     SITE_APPPERMISSION_GET: `${prefix} site apppermission get`,
     SITE_APPPERMISSION_LIST: `${prefix} site apppermission list`,
+    SITE_APPPERMISSION_REMOVE: `${prefix} site apppermission remove`,
     SITE_APPPERMISSION_SET: `${prefix} site apppermission set`,
     SITE_CLASSIC_ADD: `${prefix} site classic add`,
     SITE_CLASSIC_LIST: `${prefix} site classic list`,

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

@@ -25,7 +25,7 @@ class TeamsChannelListCommand extends GraphItemsListCommand_1.GraphItemsListComm
             return Promise.resolve(args.options.teamId);
         }
         const requestOptions = {
-            url: `${this.resource}/beta/groups?$filter=resourceProvisioningOptions/Any(x:x eq 'Team') and displayName eq '${encodeURIComponent(args.options.teamName)}'`,
+            url: `${this.resource}/v1.0/groups?$filter=displayName eq '${encodeURIComponent(args.options.teamName)}'`,
             headers: {
                 accept: 'application/json;odata.metadata=none'
             },
@@ -34,12 +34,13 @@ class TeamsChannelListCommand extends GraphItemsListCommand_1.GraphItemsListComm
         return request_1.default
             .get(requestOptions)
             .then(response => {
-            const groupItem = response.value[0];
+            const filteredResponseByTeam = response.value.filter(t => t.resourceProvisioningOptions.includes('Team'));
+            const groupItem = filteredResponseByTeam[0];
             if (!groupItem) {
                 return Promise.reject(`The specified team does not exist in the Microsoft Teams`);
             }
-            if (response.value.length > 1) {
-                return Promise.reject(`Multiple Microsoft Teams teams with name ${args.options.teamName} found: ${response.value.map(x => x.id)}`);
+            if (filteredResponseByTeam.length > 1) {
+                return Promise.reject(`Multiple Microsoft Teams teams with name ${args.options.teamName} found: ${filteredResponseByTeam.map(x => x.id)}`);
             }
             return Promise.resolve(groupItem.id);
         });

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

@@ -121,25 +121,26 @@ class TeamsConversationMemberAddCommand extends GraphCommand_1.default {
         if (args.options.teamId) {
             return Promise.resolve(args.options.teamId);
         }
-        const teamRequestOptions = {
-            url: `${this.resource}/beta/groups?$filter=resourceProvisioningOptions/Any(x:x eq 'Team') and displayName eq '${encodeURIComponent(args.options.teamName)}'`,
+        const requestOptions = {
+            url: `${this.resource}/v1.0/groups?$filter=displayName eq '${encodeURIComponent(args.options.teamName)}'`,
             headers: {
                 accept: 'application/json;odata.metadata=none'
             },
             responseType: 'json'
         };
         return request_1.default
-            .get(teamRequestOptions)
+            .get(requestOptions)
             .then(response => {
-            const teamItem = response.value[0];
-            if (!teamItem) {
+            const filteredResponseByTeam = response.value.filter(t => t.resourceProvisioningOptions.includes('Team'));
+            const groupItem = filteredResponseByTeam[0];
+            if (!groupItem) {
                 return Promise.reject(`The specified team '${args.options.teamName}' does not exist in Microsoft Teams`);
             }
-            if (response.value.length > 1) {
+            if (filteredResponseByTeam.length > 1) {
                 return Promise.reject(`Multiple Microsoft Teams with name '${args.options.teamName}' found. Please disambiguate:${os.EOL}${response.value.map(x => `- ${x.id}`).join(os.EOL)}`);
             }
-            return Promise.resolve(teamItem.id);
-        }, err => { return Promise.reject(err); });
+            return Promise.resolve(groupItem.id);
+        });
     }
     getChannelId(teamId, args) {
         if (args.options.channelId) {

package/dist/m365/teams/commands/conversationmember/conversationmember-list.js

@@ -1,10 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const request_1 = require("../../../../request");
+const Utils_1 = require("../../../../Utils");
 const GraphItemsListCommand_1 = require("../../../base/GraphItemsListCommand");
 const commands_1 = require("../../commands");
-const Utils_1 = require("../../../../Utils");
-const os = require("os");
 class TeamsConversationMemberListCommand extends GraphItemsListCommand_1.GraphItemsListCommand {
     constructor() {
         super(...arguments);
@@ -93,26 +92,25 @@ class TeamsConversationMemberListCommand extends GraphItemsListCommand_1.GraphIt
         if (args.options.teamId) {
             return Promise.resolve(args.options.teamId);
         }
-        return new Promise((resolve, reject) => {
-            const teamRequestOptions = {
-                url: `${this.resource}/beta/groups?$filter=resourceProvisioningOptions/Any(x:x eq 'Team') and displayName eq '${encodeURIComponent(args.options.teamName)}'`,
-                headers: {
-                    accept: 'application/json;odata.metadata=none'
-                },
-                responseType: 'json'
-            };
-            request_1.default
-                .get(teamRequestOptions)
-                .then(response => {
-                const teamItem = response.value[0];
-                if (!teamItem) {
-                    return reject(`The specified team '${args.options.teamName}' does not exist in Microsoft Teams`);
-                }
-                if (response.value.length > 1) {
-                    return reject(`Multiple Microsoft Teams with name '${args.options.teamName}' found. Please disambiguate:${os.EOL}${response.value.map(x => `- ${x.id}`).join(os.EOL)}`);
-                }
-                return resolve(teamItem.id);
-            }, err => { reject(err); });
+        const requestOptions = {
+            url: `${this.resource}/v1.0/groups?$filter=displayName eq '${encodeURIComponent(args.options.teamName)}'`,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json'
+        };
+        return request_1.default
+            .get(requestOptions)
+            .then(response => {
+            const filteredResponseByTeam = response.value.filter(t => t.resourceProvisioningOptions.includes('Team'));
+            const groupItem = filteredResponseByTeam[0];
+            if (!groupItem) {
+                return Promise.reject(`The specified team '${args.options.teamName}' does not exist in the Microsoft Teams`);
+            }
+            if (filteredResponseByTeam.length > 1) {
+                return Promise.reject(`Multiple Microsoft Teams teams with name '${args.options.teamName}' found: ${filteredResponseByTeam.map(x => x.id)}`);
+            }
+            return Promise.resolve(groupItem.id);
         });
     }
     getChannelId(teamId, args) {

package/dist/m365/teams/commands/team/team-get.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const request_1 = require("../../../../request");
+const Utils_1 = require("../../../../Utils");
+const GraphCommand_1 = require("../../../base/GraphCommand");
+const commands_1 = require("../../commands");
+class TeamsTeamGetCommand extends GraphCommand_1.default {
+    get name() {
+        return commands_1.default.TEAM_GET;
+    }
+    get description() {
+        return 'Retrieve information about the specified Microsoft Team';
+    }
+    getTelemetryProperties(args) {
+        const telemetryProps = super.getTelemetryProperties(args);
+        telemetryProps.id = typeof args.options.id !== 'undefined';
+        telemetryProps.name = typeof args.options.name !== 'undefined';
+        return telemetryProps;
+    }
+    getTeamId(args) {
+        if (args.options.id) {
+            return Promise.resolve(args.options.id);
+        }
+        const requestOptions = {
+            url: `${this.resource}/v1.0/groups?$filter=displayName eq '${encodeURIComponent(args.options.name)}'&$select=id,resourceProvisioningOptions`,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json'
+        };
+        return request_1.default
+            .get(requestOptions)
+            .then(response => {
+            const groupItem = response.value[0];
+            if (!groupItem) {
+                return Promise.reject(`The specified team does not exist in the Microsoft Teams`);
+            }
+            if (groupItem.resourceProvisioningOptions.indexOf('Team') === -1) {
+                return Promise.reject(`The specified team does not exist in the Microsoft Teams`);
+            }
+            if (response.value.length >= 2) {
+                return Promise.reject(`Multiple Microsoft Teams teams with name ${args.options.name} found: ${response.value.map(x => x.id)}`);
+            }
+            return Promise.resolve(groupItem.id);
+        });
+    }
+    commandAction(logger, args, cb) {
+        this
+            .getTeamId(args)
+            .then((teamId) => {
+            const requestOptions = {
+                url: `${this.resource}/v1.0/teams/${encodeURIComponent(teamId)}`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none'
+                },
+                responseType: 'json'
+            };
+            return request_1.default.get(requestOptions);
+        })
+            .then((res) => {
+            logger.log(res);
+            cb();
+        }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
+    }
+    options() {
+        const options = [
+            {
+                option: '-i, --id [id]'
+            },
+            {
+                option: '-n, --name [name]'
+            }
+        ];
+        const parentOptions = super.options();
+        return options.concat(parentOptions);
+    }
+    validate(args) {
+        if (args.options.id && args.options.name) {
+            return 'Specify either teamId or teamName, but not both.';
+        }
+        if (!args.options.id && !args.options.name) {
+            return 'Specify teamId or teamName, one is required';
+        }
+        if (args.options.id && !Utils_1.default.isValidGuid(args.options.id)) {
+            return `${args.options.id} is not a valid GUID`;
+        }
+        return true;
+    }
+}
+module.exports = new TeamsTeamGetCommand();
+//# sourceMappingURL=team-get.js.map

package/dist/m365/teams/commands/team/team-list.js

@@ -16,9 +16,9 @@ class TeamsTeamListCommand extends GraphItemsListCommand_1.GraphItemsListCommand
         return telemetryProps;
     }
     commandAction(logger, args, cb) {
-        let endpoint = `${this.resource}/beta/groups?$filter=resourceProvisioningOptions/Any(x:x eq 'Team')&$select=id,displayName,description`;
+        let endpoint = `${this.resource}/v1.0/groups?$select=id,displayName,description,resourceProvisioningOptions`;
         if (args.options.joined) {
-            endpoint = `${this.resource}/beta/me/joinedTeams`;
+            endpoint = `${this.resource}/v1.0/me/joinedTeams`;
         }
         this
             .getAllItems(endpoint, logger, true)
@@ -27,7 +27,9 @@ class TeamsTeamListCommand extends GraphItemsListCommand_1.GraphItemsListCommand
                 return Promise.resolve();
             }
             else {
-                return Promise.all(this.items.map(g => this.getTeamFromGroup(g)));
+                return Promise.all(this.items.filter((e) => {
+                    return e.resourceProvisioningOptions.indexOf('Team') > -1;
+                }).map(g => this.getTeamFromGroup(g)));
             }
         })
             .then((res) => {
@@ -41,7 +43,7 @@ class TeamsTeamListCommand extends GraphItemsListCommand_1.GraphItemsListCommand
     getTeamFromGroup(group) {
         return new Promise((resolve, reject) => {
             const requestOptions = {
-                url: `${this.resource}/beta/teams/${group.id}`,
+                url: `${this.resource}/v1.0/teams/${group.id}`,
                 headers: {
                     accept: 'application/json;odata.metadata=none'
                 },

package/dist/m365/teams/commands/user/user-list.js

@@ -1,6 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const chalk = require("chalk");
 const Utils_1 = require("../../../../Utils");
 const GraphItemsListCommand_1 = require("../../../base/GraphItemsListCommand");
 const commands_1 = require("../../commands");
@@ -9,24 +8,21 @@ class TeamsUserListCommand extends GraphItemsListCommand_1.GraphItemsListCommand
         return commands_1.default.USER_LIST;
     }
     get description() {
-        return "Lists users for the specified Microsoft 365 group or Microsoft Teams team";
+        return "Lists users for the specified Microsoft Teams team";
     }
     getTelemetryProperties(args) {
         const telemetryProps = super.getTelemetryProperties(args);
         telemetryProps.role = args.options.role;
-        telemetryProps.teamId = typeof args.options.teamId !== 'undefined';
-        telemetryProps.groupId = typeof args.options.groupId !== 'undefined';
         return telemetryProps;
     }
     commandAction(logger, args, cb) {
-        const providedGroupId = (typeof args.options.groupId !== 'undefined') ? args.options.groupId : args.options.teamId;
         this
-            .getOwners(logger, providedGroupId)
+            .getOwners(logger, args.options.teamId)
             .then(() => {
             if (args.options.role === "Owner") {
                 return Promise.resolve();
             }
-            return this.getMembersAndGuests(logger, providedGroupId);
+            return this.getMembersAndGuests(logger, args.options.teamId);
         })
             .then(() => {
             // Filter out duplicate added values for owners (as they are returned as members as well)
@@ -36,9 +32,6 @@ class TeamsUserListCommand extends GraphItemsListCommand_1.GraphItemsListCommand
                 this.items = this.items.filter(i => i.userType === args.options.role);
             }
             logger.log(this.items);
-            if (this.verbose) {
-                logger.logToStderr(chalk.green("DONE"));
-            }
             cb();
         }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
     }
@@ -59,10 +52,7 @@ class TeamsUserListCommand extends GraphItemsListCommand_1.GraphItemsListCommand
     options() {
         const options = [
             {
-                option: "-i, --groupId [groupId]"
-            },
-            {
-                option: "--teamId [teamId]"
+                option: "-i, --teamId <teamId>"
             },
             {
                 option: "-r, --role [type]",
@@ -73,18 +63,9 @@ class TeamsUserListCommand extends GraphItemsListCommand_1.GraphItemsListCommand
         return options.concat(parentOptions);
     }
     validate(args) {
-        if (!args.options.groupId && !args.options.teamId) {
-            return 'Please provide one of the following parameters: groupId or teamId';
-        }
-        if (args.options.groupId && args.options.teamId) {
-            return 'You cannot provide both a groupId and teamId parameter, please provide only one';
-        }
-        if (args.options.teamId && !Utils_1.default.isValidGuid(args.options.teamId)) {
+        if (!Utils_1.default.isValidGuid(args.options.teamId)) {
             return `${args.options.teamId} is not a valid GUID`;
         }
-        if (args.options.groupId && !Utils_1.default.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`;

package/dist/m365/viva/commands/connections/connections-app-create.js

@@ -47,7 +47,7 @@ class VivaConnectionsAppCreateCommand extends AnonymousCommand_1.default {
             const outlineIconPath = path.resolve(args.options.outlineIconPath);
             const outlineIconFileName = path.basename(outlineIconPath);
             const domain = portalUrl.hostname;
-            const appId = uuid_1.v4();
+            const appId = (0, uuid_1.v4)();
             const manifest = {
                 "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.9/MicrosoftTeams.schema.json",
                 "manifestVersion": "1.9",

package/docs/docs/cmd/aad/o365group/o365group-teamify.md

@@ -15,11 +15,6 @@ m365 aad o365group teamify [options]
 
 --8<-- "docs/cmd/_global.md"
 
-## Remarks
-
-!!! attention
-    This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
-
 ## Examples
 
 Creates a new Microsoft Teams team under existing Microsoft 365 group

package/docs/docs/cmd/aad/o365group/o365group-user-list.md

@@ -1,6 +1,6 @@
 # aad o365group user list
 
-Lists users for the specified Microsoft 365 group or Microsoft Teams team
+Lists users for the specified Microsoft 365 group
 
 ## Usage
 
@@ -10,12 +10,9 @@ m365 aad o365group user list [options]
 
 ## Options
 
-`-i, --groupId [groupId]`
+`-i, --groupId <groupId>`
 : The ID of the Microsoft 365 group for which to list users
 
-`--teamId [teamId]`
-: The ID of the Microsoft Teams team for which to list users
-
 `-r, --role [role]`
 : Filter the results to only users with the given role: `Owner,Member,Guest`
 
@@ -40,15 +37,3 @@ m365 aad o365group user list --groupId '00000000-0000-0000-0000-000000000000' --
 ```sh
 m365 aad o365group user list --groupId '00000000-0000-0000-0000-000000000000' --role Guest
 ```
-
-List all users and their role in the specified Microsoft teams team
-
-```sh
-m365 teams user list --teamId '00000000-0000-0000-0000-000000000000'
-```
-
-List all owners and their role in the specified Microsoft teams team
-
-```sh
-m365 teams user list --teamId '00000000-0000-0000-0000-000000000000' --role Owner
-```

package/docs/docs/cmd/aad/siteclassification/siteclassification-disable.md

@@ -15,11 +15,6 @@ m365 aad siteclassification disable [options]
 
 --8<-- "docs/cmd/_global.md"
 
-## Remarks
-
-!!! attention
-    This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
-
 ## Examples
 
 Disable site classification

package/docs/docs/cmd/aad/user/user-set.md

@@ -0,0 +1,60 @@
+# aad user set
+
+Updates information of the specified user
+
+## Usage
+
+```sh
+m365 aad user set [options]
+```
+
+## Options
+
+`-i, --objectId [objectId]`
+: The object ID of the user to update. Specify `objectId` or `userPrincipalName` but not both
+
+`-n, --userPrincipalName [userPrincipalName]`
+: User principal name of the user to update. Specify `objectId` or `userPrincipalName` but not both
+
+`--accountEnabled [accountEnabled]`
+: Boolean value specifying whether the account is enabled. Valid values are `true,false`
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+You can update information of a user, either by specifying that user's id (`objectId`) or user name (`userPrincipalName`), but not both.
+
+If the user with the specified id or user name doesn't exist, you will get a `Resource 'xyz' does not exist or one of its queried reference-property objects are not present.` error.
+
+## Examples
+
+Update specific property _department_ of user with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_
+
+```sh
+m365 aad user set --objectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --Department IT
+```
+
+Update multiple properties of user with name _steve@contoso.onmicrosoft.com_
+
+```sh
+m365 aad user set --userPrincipalName steve@contoso.onmicrosoft.com --Department "Sales & Marketing" --CompanyName Contoso
+```
+
+Enable user with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_
+
+```sh
+m365 aad user set --objectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --accountEnabled true
+```
+
+Disable user with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_
+
+```sh
+m365 aad user set --objectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --accountEnabled false
+```
+
+Enable user with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_
+
+```sh
+m365 aad user set --objectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --accountEnabled true
+```

package/docs/docs/cmd/login.md

@@ -11,7 +11,7 @@ m365 login [options]
 ## Options
 
 `-t, --authType [authType]`
-: The type of authentication to use. Allowed values `certificate,deviceCode,password,identity,browser`. Default `deviceCode`
+: The type of authentication to use. Allowed values `certificate,deviceCode,password,identity,browser,secret`. Default `deviceCode`
 
 `-u, --userName [userName]`
 : Name of the user to authenticate. Required when `authType` is set to `password`
@@ -28,6 +28,9 @@ m365 login [options]
 `--thumbprint [thumbprint]`
 : Certificate thumbprint. If not specified, and `authType` is set to `certificate`, it will be automatically calculated based on the specified certificate
 
+`-s, --secret [secret]`
+: Client Secret of the Azure AD application to use for authentication. Required when `authType` is set to `secret`.
+
 `--appId [appId]`
 : App ID of the Azure AD application to use for authentication. If not specified, use the app specified in the `CLIMICROSOFT365_AADAPPID` environment variable. If the environment variable is not defined, use the multitenant PnP Management Shell app
 
@@ -48,7 +51,7 @@ When logging in to Microsoft 365 using the user name and password, next to the a
 
 When logging in to Microsoft 365 using a certificate, the CLI for Microsoft 365 will store the contents of the certificate so that it can automatically re-authenticate if necessary. The contents of the certificate are removed by re-authenticating using the device code or by calling the [logout](logout.md) command.  
 
-To log in to Microsoft 365 using a certificate, you will typically [create a custom Azure AD application](../user-guide/using-own-identity.md). To use this application with the CLI for Microsoft 365, you will set the `CLIMICROSOFT365_AADAPPID` environment variable to the application's ID and the `CLIMICROSOFT365_TENANT` environment variable to the ID of the Azure AD tenant, where you created the Azure AD application. Also, please make sure to read about [the caveats when using the certificate login option](../user-guide/cli-certificate-caveats.md).
+To log in to Microsoft 365 using a certificate or secret, you will typically [create a custom Azure AD application](../user-guide/using-own-identity.md). To use this application with the CLI for Microsoft 365, you will set the `CLIMICROSOFT365_AADAPPID` environment variable to the application's ID and the `CLIMICROSOFT365_TENANT` environment variable to the ID of the Azure AD tenant, where you created the Azure AD application. Also, please make sure to read about [the caveats when using the certificate login option](../user-guide/cli-certificate-caveats.md).
 
 Managed identity in Azure Cloud Shell is the identity of the user. It is neither system- nor user-assigned and it can't be configured. To log in to Microsoft 365 using managed identity in Azure Cloud Shell, set `authType` to `identity` and don't specify the `userName` option.
 
@@ -150,3 +153,9 @@ Log in to Microsoft 365 using the interactive browser authentication. Uses the i
 ```sh
 m365 login --authType browser
 ```
+
+Log in to Microsoft 365 using a client secret.
+
+```sh
+m365 login --authType secret --secret topSeCr3t@007
+```

package/docs/docs/cmd/planner/plan/plan-get.md

@@ -0,0 +1,45 @@
+# planner plan get
+
+Retrieve information about the specified plan
+
+## Usage
+
+```sh
+m365 planner plan get [options]
+```
+
+## Options
+
+`-i,--id [id]`
+: ID of the plan. Specify either `id` or `title` but not both.
+
+`-t,--title [title]`
+: Title of the plan. Specify either `id` or `title` but not both.
+
+`--ownerGroupId [ownerGroupId]`
+: ID of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` but not both.
+
+`--ownerGroupName [ownerGroupName]`
+: Name of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` but not both.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Returns the Microsoft Planner plan with id _gndWOTSK60GfPQfiDDj43JgACDCb_
+
+```sh
+m365 planner plan get --id "gndWOTSK60GfPQfiDDj43JgACDCb"
+```
+
+Returns the Microsoft Planner plan with title _MyPlan_ for Group _233e43d0-dc6a-482e-9b4e-0de7a7bce9b4_
+
+```sh
+m365 planner plan get --title "MyPlan" --ownerGroupId "233e43d0-dc6a-482e-9b4e-0de7a7bce9b4"
+```
+
+Returns the Microsoft Planner plan with title _MyPlan_ for Group _My Planner Group_
+
+```sh
+m365 planner plan get --title "MyPlan" --ownerGroupName "My Planner Group"
+```

package/docs/docs/cmd/planner/task/task-list.md

@@ -1,6 +1,6 @@
 # planner task list
 
-Lists Planner tasks for the currently logged in user
+Lists planner tasks in a bucket, plan, or tasks for the currently logged in user
 
 ## Usage
 
@@ -10,6 +10,24 @@ m365 planner task list [options]
 
 ## Options
 
+`--bucketId [bucketId]`
+: ID of the bucket to list the tasks of. To retrieve tasks from a bucket, specify `bucketId` or `bucketName`, but not both.
+
+`--bucketName [bucketName]`
+: Name of the bucket to list the tasks of. To retrieve tasks from a bucket, specify `bucketId` or `bucketName`, but not both.
+
+`--planId [planId]`
+: ID of the plan to list the tasks of. Specify `planId` or `planName` when using `bucketName`.
+
+`--planName [planName]`
+: Name of the plan to list the tasks of. Specify `planId` or `planName` when using `bucketName`.
+
+`--ownerGroupId [ownerGroupId]`
+: ID of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.
+
+`--ownerGroupName [ownerGroupName]`
+: Name of the group to which the plan belongs. Specify `ownerGroupId` or `ownerGroupName` when using `planName`.
+
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
@@ -19,3 +37,33 @@ List tasks for the currently logged in user
 ```sh
 m365 planner task list
 ```
+
+List the Microsoft Planner tasks in the plan _iVPMIgdku0uFlou-KLNg6MkAE1O2_
+
+```sh
+m365 planner task list --planId "iVPMIgdku0uFlou-KLNg6MkAE1O2"`
+```
+
+List the Microsoft Planner tasks in the plan _My Plan_ in group _My Group_
+
+```sh
+m365 planner task list --planName "My Plan" --ownerGroupName "My Group"
+```
+
+List the Microsoft Planner tasks in the bucket _FtzysDykv0-9s9toWiZhdskAD67z_
+
+```sh
+m365 planner task list --bucketId "FtzysDykv0-9s9toWiZhdskAD67z"
+```
+
+List the Microsoft Planner tasks in the bucket _My Bucket_ belonging to plan _iVPMIgdku0uFlou-KLNg6MkAE1O2_
+
+```sh
+m365 planner task list --bucketName "My Bucket" --planId "iVPMIgdku0uFlou-KLNg6MkAE1O2"
+```
+
+List the Microsoft Planner tasks in the bucket _My Bucket_ belonging to plan _My Plan_ in group _My Group_
+
+```sh
+m365 planner bucket tasks list --bucketName "My Bucket" --planName "My Plan" --ownerGroupName "My Group"
+```