@pnp/cli-microsoft365 5.0.0-beta.fe151d6 → 5.1.0-beta.6ab68db

package/dist/utils/urlUtil.js

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.urlUtil = void 0;
+const url = require("url");
+exports.urlUtil = {
+    /**
+       * Returns server relative path.
+       * @param webUrl web full or web relative url e.g. https://contoso.sharepoint.com/sites/team1
+       * @param folderRelativePath folder relative path e.g. /Shared Documents
+       * @example
+       * // returns "/sites/team1"
+       * urlUtil.getServerRelativePath("https://contoso.sharepoint.com/sites/team1", "");
+       * @example
+       * // returns "/sites/team1/Shared Documents"
+       * urlUtil.getServerRelativePath("https://contoso.sharepoint.com/sites/team1", "/Shared Documents");
+       * @example
+       * // returns "/sites/team1/Shared Documents"
+       * urlUtil.getServerRelativePath("/sites/team1/", "/Shared Documents");
+       */
+    getServerRelativePath(webUrl, folderRelativePath) {
+        const tenantUrl = `${url.parse(webUrl).protocol}//${url.parse(webUrl).hostname}`;
+        // if webUrl is a server-relative URL then tenantUrl will resolve to null//null
+        // in which case we should keep webUrl
+        let webRelativePath = tenantUrl !== 'null//null' ? webUrl.substr(tenantUrl.length) : webUrl;
+        // will be used to remove relative path from the folderRelativePath
+        // in case the web relative url is included
+        let relativePathToRemove = webRelativePath;
+        // add '/' at 0
+        if (webRelativePath[0] !== '/') {
+            webRelativePath = `/${webRelativePath}`;
+        }
+        else {
+            relativePathToRemove = webRelativePath.substring(1);
+        }
+        // remove last '/' of webRelativePath
+        const webPathLastCharPos = webRelativePath.length - 1;
+        if (webRelativePath.length > 1 &&
+            webRelativePath[webPathLastCharPos] === '/') {
+            webRelativePath = webRelativePath.substring(0, webPathLastCharPos);
+        }
+        // remove the web relative path if it is contained in the folder relative path
+        const relativePathToRemoveIdx = folderRelativePath.toLowerCase().indexOf(relativePathToRemove.toLowerCase());
+        if (relativePathToRemoveIdx > -1) {
+            const pos = relativePathToRemoveIdx + relativePathToRemove.length;
+            folderRelativePath = folderRelativePath.substring(pos, folderRelativePath.length);
+        }
+        if (folderRelativePath !== '') {
+            // add '/' at 0 for siteRelativePath
+            if (folderRelativePath[0] !== '/') {
+                folderRelativePath = `/${folderRelativePath}`;
+            }
+            // remove last '/' of siteRelativePath
+            const folderPathLastCharPos = folderRelativePath.length - 1;
+            if (folderRelativePath[folderPathLastCharPos] === '/') {
+                folderRelativePath = folderRelativePath.substring(0, folderPathLastCharPos);
+            }
+            if (webRelativePath === '/' && folderRelativePath !== '') {
+                webRelativePath = folderRelativePath;
+            }
+            else {
+                webRelativePath = `${webRelativePath}${folderRelativePath}`;
+            }
+        }
+        return webRelativePath.replace('//', '/');
+    },
+    /**
+     * Returns server relative site url.
+     * @param webUrl web full or web relative url e.g. https://contoso.sharepoint.com/sites/team1
+     * @example
+     * // returns "/sites/team1"
+     * urlUtil.getServerRelativeSiteUrl("https://contoso.sharepoint.com/sites/team1";
+     * @example
+     * // returns ""
+     * urlUtil.getServerRelativeSiteUrl("https://contoso.sharepoint.com");
+     * @example
+     * // returns "/sites/team1/Shared Documents"
+     * urlUtil.getServerRelativePath("/sites/team1/", "/Shared Documents");
+     */
+    getServerRelativeSiteUrl(webUrl) {
+        const serverRelativeSiteUrl = exports.urlUtil.getServerRelativePath(webUrl, '');
+        // return an empty string instead of / to prevent // replies
+        return serverRelativeSiteUrl === '/' ? "" : serverRelativeSiteUrl;
+    },
+    /**
+     * Returns web relative path from webUrl and folderUrl.
+     * @param webUrl web full or web relative url e.g. https://contoso.sharepoint.com/sites/team1/
+     * @param folderUrl folder server relative url e.g. /sites/team1/Lists/MyList
+     * @example
+     * // returns "/Lists/MyList"
+     * Utils.getWebRelativePath("https://contoso.sharepoint.com/sites/team1/", "/sites/team1/Lists/MyList");
+     * @example
+     * // returns "/Shared Documents"
+     * Utils.getWebRelativePath("/sites/team1/", "/sites/team1/Shared Documents");
+     */
+    getWebRelativePath(webUrl, folderUrl) {
+        let folderWebRelativePath = '';
+        const tenantUrl = `${url.parse(webUrl).protocol}//${url.parse(webUrl).hostname}`;
+        // if webUrl is a server-relative URL then tenantUrl will resolve to null//null
+        // in which case we should keep webUrl
+        let webRelativePath = tenantUrl !== 'null//null' ? webUrl.substr(tenantUrl.length) : webUrl;
+        // will be used to remove relative path from the folderRelativePath
+        // in case the web relative url is included
+        let relativePathToRemove = webRelativePath;
+        // add '/' at 0
+        if (webRelativePath[0] !== '/') {
+            webRelativePath = `/${webRelativePath}`;
+        }
+        else {
+            relativePathToRemove = webRelativePath.substring(1);
+        }
+        // remove last '/' of webRelativePath
+        const webPathLastCharPos = webRelativePath.length - 1;
+        if (webRelativePath.length > 1 &&
+            webRelativePath[webPathLastCharPos] === '/') {
+            webRelativePath = webRelativePath.substring(0, webPathLastCharPos);
+        }
+        // remove the web relative path if it is contained in the folder relative path
+        const relativePathToRemoveIdx = folderUrl.toLowerCase().indexOf(relativePathToRemove.toLowerCase());
+        if (relativePathToRemoveIdx > -1) {
+            const pos = relativePathToRemoveIdx + relativePathToRemove.length;
+            folderWebRelativePath = folderUrl.substring(pos, folderUrl.length);
+        }
+        else {
+            folderWebRelativePath = folderUrl;
+        }
+        // add '/' at 0 for folderWebRelativePath
+        if (folderWebRelativePath[0] !== '/') {
+            folderWebRelativePath = `/${folderWebRelativePath}`;
+        }
+        // remove last '/' of folderWebRelativePath
+        const folderPathLastCharPos = folderWebRelativePath.length - 1;
+        if (folderWebRelativePath.length > 1 && folderWebRelativePath[folderPathLastCharPos] === '/') {
+            folderWebRelativePath = folderWebRelativePath.substring(0, folderPathLastCharPos);
+        }
+        return folderWebRelativePath.replace('//', '/');
+    },
+    /**
+     * Returns the absolute URL according to a Web URL and the server relative URL of a folder
+     * @param webUrl The full URL of a web
+     * @param serverRelativeUrl The server relative URL of a folder
+     * @example
+     * // returns "https://contoso.sharepoint.com/sites/team1/Lists/MyList"
+     * urlUtil.getAbsoluteUrl("https://contoso.sharepoint.com/sites/team1/", "/sites/team1/Lists/MyList");
+     */
+    getAbsoluteUrl(webUrl, serverRelativeUrl) {
+        const uri = url.parse(webUrl);
+        const tenantUrl = `${uri.protocol}//${uri.hostname}`;
+        if (serverRelativeUrl[0] !== '/') {
+            serverRelativeUrl = `/${serverRelativeUrl}`;
+        }
+        return `${tenantUrl}${serverRelativeUrl}`;
+    },
+    /**
+     * Combines base and relative url considering any missing slashes
+     * @param baseUrl https://contoso.com
+     * @param relativeUrl sites/abc
+     */
+    urlCombine(baseUrl, relativeUrl) {
+        // remove last '/' of base if exists
+        if (baseUrl.lastIndexOf('/') === baseUrl.length - 1) {
+            baseUrl = baseUrl.substring(0, baseUrl.length - 1);
+        }
+        // remove '/' at 0
+        if (relativeUrl.charAt(0) === '/') {
+            relativeUrl = relativeUrl.substring(1, relativeUrl.length);
+        }
+        // remove last '/' of next if exists
+        if (relativeUrl.lastIndexOf('/') === relativeUrl.length - 1) {
+            relativeUrl = relativeUrl.substring(0, relativeUrl.length - 1);
+        }
+        return `${baseUrl}/${relativeUrl}`;
+    }
+};
+//# sourceMappingURL=urlUtil.js.map

package/dist/utils/validation.js

@@ -0,0 +1,310 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validation = void 0;
+exports.validation = {
+    isValidGuidArray(guids) {
+        return guids.every(guid => this.isValidGuid(guid));
+    },
+    isValidGuid(guid) {
+        const guidRegEx = new RegExp(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i);
+        return guidRegEx.test(guid);
+    },
+    isValidTeamsChannelId(guid) {
+        const guidRegEx = new RegExp(/^19:[0-9a-zA-Z-_]+@thread\.(skype|tacv2)$/i);
+        return guidRegEx.test(guid);
+    },
+    isValidTeamsChatId(guid) {
+        const guidRegEx = new RegExp(/^19:[0-9a-zA-Z-_]+(@thread\.v2|@unq\.gbl\.spaces)$/i);
+        return guidRegEx.test(guid);
+    },
+    isValidUserPrincipalName(upn) {
+        const upnRegEx = new RegExp(/^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*$/i);
+        return upnRegEx.test(upn);
+    },
+    isDateInRange(date, monthOffset) {
+        const d = new Date(date);
+        const cutoffDate = new Date();
+        cutoffDate.setMonth(cutoffDate.getMonth() - monthOffset);
+        return d > cutoffDate;
+    },
+    isValidISODate(date) {
+        const dateRegEx = new RegExp(/^(19|20)\d\d[- /.](0[1-9]|1[012])[- /.](0[1-9]|[12][0-9]|3[01])$/i);
+        return dateRegEx.test(date);
+    },
+    isValidISODateDashOnly(date) {
+        const dateTimeRegEx = new RegExp(/^(\d{4}-[01]\d-[0-3]\dT[0-2]\d:[0-5]\d:[0-5]\d\.\d+([+-][0-2]\d:[0-5]\d|Z))|(\d{4}-[01]\d-[0-3]\dT[0-2]\d:[0-5]\d:[0-5]\d([+-][0-2]\d:[0-5]\d|Z))|(\d{4}-[01]\d-[0-3]\dT[0-2]\d:[0-5]\d([+-][0-2]\d:[0-5]\d|Z))$/i);
+        const dateOnlyRegEx = new RegExp(/^(19|20)\d\d[-](0[1-9]|1[012])[-](0[1-9]|[12][0-9]|3[01])$/i);
+        return dateTimeRegEx.test(date) ? true : dateOnlyRegEx.test(date);
+    },
+    isValidISODateTime(dateTime) {
+        const withMilliSecsPattern = new RegExp(/^[0-9]{4}-((0[13578]|1[02])-(0[1-9]|[12][0-9]|3[01])|(0[469]|11)-(0[1-9]|[12][0-9]|30)|(02)-(0[1-9]|[12][0-9]))T(0[0-9]|1[0-9]|2[0-3]):(0[0-9]|[1-5][0-9]):(0[0-9]|[1-5][0-9])\.[0-9]{3}Z$/);
+        if (withMilliSecsPattern.test(dateTime)) {
+            return true;
+        }
+        const withSecsPattern = new RegExp(/^[0-9]{4}-((0[13578]|1[02])-(0[1-9]|[12][0-9]|3[01])|(0[469]|11)-(0[1-9]|[12][0-9]|30)|(02)-(0[1-9]|[12][0-9]))T(0[0-9]|1[0-9]|2[0-3]):(0[0-9]|[1-5][0-9]):(0[0-9]|[1-5][0-9])Z$/);
+        if (withSecsPattern.test(dateTime)) {
+            return true;
+        }
+        const withMinutesPattern = new RegExp(/^[0-9]{4}-((0[13578]|1[02])-(0[1-9]|[12][0-9]|3[01])|(0[469]|11)-(0[1-9]|[12][0-9]|30)|(02)-(0[1-9]|[12][0-9]))T(0[0-9]|1[0-9]|2[0-3]):(0[0-9]|[1-5][0-9])Z$/);
+        if (withMinutesPattern.test(dateTime)) {
+            return true;
+        }
+        const withHoursPattern = new RegExp(/^[0-9]{4}-((0[13578]|1[02])-(0[1-9]|[12][0-9]|3[01])|(0[469]|11)-(0[1-9]|[12][0-9]|30)|(02)-(0[1-9]|[12][0-9]))T(0[0-9]|1[0-9]|2[0-3])Z$/);
+        if (withHoursPattern.test(dateTime)) {
+            return true;
+        }
+        const withoutTimePattern = new RegExp(/^[0-9]{4}-((0[13578]|1[02])-(0[1-9]|[12][0-9]|3[01])|(0[469]|11)-(0[1-9]|[12][0-9]|30)|(02)-(0[1-9]|[12][0-9]))$/);
+        if (withoutTimePattern.test(dateTime)) {
+            return true;
+        }
+        return false;
+    },
+    isValidBoolean(value) {
+        return value.toLowerCase() === 'true' || value.toLowerCase() === 'false';
+    },
+    isJavaScriptReservedWord(input) {
+        const javascriptReservedWords = [
+            "arguments",
+            "await",
+            "break",
+            "case",
+            "catch",
+            "class",
+            "const",
+            "continue",
+            "debugger",
+            "default",
+            "delete",
+            "do",
+            "else",
+            "enum",
+            "eval",
+            "export",
+            "extends",
+            "false",
+            "finally",
+            "for",
+            "function",
+            "if",
+            "implements",
+            "import",
+            "in",
+            "instanceof",
+            "interface",
+            "let",
+            "new",
+            "null",
+            "package",
+            "private",
+            "protected",
+            "public",
+            "return",
+            "static",
+            "super",
+            "switch",
+            "this",
+            "throw",
+            "true",
+            "try",
+            "typeof",
+            "var",
+            "void",
+            "while",
+            "with",
+            "yield",
+            "Array",
+            "Date",
+            "eval",
+            "function",
+            "hasOwnProperty",
+            "Infinity",
+            "isFinite",
+            "isNaN",
+            "isPrototypeOf",
+            "length",
+            "Math",
+            "NaN",
+            "name",
+            "Number",
+            "Object",
+            "prototype",
+            "String",
+            "toString",
+            "undefined",
+            "valueOf",
+            "alert",
+            "all",
+            "anchor",
+            "anchors",
+            "area",
+            "assign",
+            "blur",
+            "button",
+            "checkbox",
+            "clearInterval",
+            "clearTimeout",
+            "clientInformation",
+            "close",
+            "closed",
+            "confirm",
+            "constructor",
+            "crypto",
+            "decodeURI",
+            "decodeURIComponent",
+            "defaultStatus",
+            "document",
+            "element",
+            "elements",
+            "embed",
+            "embeds",
+            "encodeURI",
+            "encodeURIComponent",
+            "escape",
+            "event",
+            "fileUpload",
+            "focus",
+            "form",
+            "forms",
+            "frame",
+            "innerHeight",
+            "innerWidth",
+            "layer",
+            "layers",
+            "link",
+            "location",
+            "mimeTypes",
+            "navigate",
+            "navigator",
+            "frames",
+            "frameRate",
+            "hidden",
+            "history",
+            "image",
+            "images",
+            "offscreenBuffering",
+            "open",
+            "opener",
+            "option",
+            "outerHeight",
+            "outerWidth",
+            "packages",
+            "pageXOffset",
+            "pageYOffset",
+            "parent",
+            "parseFloat",
+            "parseInt",
+            "password",
+            "pkcs11",
+            "plugin",
+            "prompt",
+            "propertyIsEnum",
+            "radio",
+            "reset",
+            "screenX",
+            "screenY",
+            "scroll",
+            "secure",
+            "select",
+            "self",
+            "setInterval",
+            "setTimeout",
+            "status",
+            "submit",
+            "taint",
+            "text",
+            "textarea",
+            "top",
+            "unescape",
+            "untaint",
+            "window",
+            "onblur",
+            "onclick",
+            "onerror",
+            "onfocus",
+            "onkeydown",
+            "onkeypress",
+            "onkeyup",
+            "onmouseover",
+            "onload",
+            "onmouseup",
+            "onmousedown",
+            "onsubmit"
+        ];
+        return !!input && !input.split('.').every(value => !~javascriptReservedWords.indexOf(value));
+    },
+    isValidFileName(input) {
+        return !!input && !/^((\..*)|COM\d|CLOCK\$|LPT\d|AUX|NUL|CON|PRN|(.*[\u{d800}-\u{dfff}]+.*))$/iu.test(input) && !/^(.*\.\..*)$/i.test(input);
+    },
+    isValidTheme(input) {
+        const validThemeProperties = [
+            "themePrimary",
+            "themeLighterAlt",
+            "themeLighter",
+            "themeLight",
+            "themeTertiary",
+            "themeSecondary",
+            "themeDarkAlt",
+            "themeDark",
+            "themeDarker",
+            "neutralLighterAlt",
+            "neutralLighter",
+            "neutralLight",
+            "neutralQuaternaryAlt",
+            "neutralQuaternary",
+            "neutralTertiaryAlt",
+            "neutralTertiary",
+            "neutralSecondary",
+            "neutralPrimaryAlt",
+            "neutralPrimary",
+            "neutralDark",
+            "black",
+            "white"
+        ];
+        let theme;
+        try {
+            theme = JSON.parse(input);
+        }
+        catch (_a) {
+            return false;
+        }
+        if (Array.isArray(theme)) {
+            return false;
+        }
+        const hasInvalidProperties = validThemeProperties.map((property) => {
+            return theme.hasOwnProperty(property);
+        }).includes(false);
+        if (hasInvalidProperties) {
+            return false;
+        }
+        const regex = new RegExp(/^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$/);
+        const hasInvalidValues = validThemeProperties.map((property) => {
+            return regex.test(theme[property]);
+        }).includes(false);
+        if (hasInvalidValues) {
+            return false;
+        }
+        return true;
+    },
+    isValidSharePointUrl(url) {
+        if (!url) {
+            return false;
+        }
+        if (url.indexOf('https://') !== 0) {
+            return `${url} is not a valid SharePoint Online site URL`;
+        }
+        else {
+            return true;
+        }
+    },
+    isValidFormDigest(contextInfo) {
+        if (!contextInfo) {
+            return false;
+        }
+        const now = new Date();
+        if (contextInfo.FormDigestValue && now < contextInfo.FormDigestExpiresAt) {
+            return true;
+        }
+        return false;
+    }
+};
+//# sourceMappingURL=validation.js.map

package/docs/docs/cmd/_global.md

@@ -5,10 +5,10 @@
 : JMESPath query string. See [http://jmespath.org/](http://jmespath.org/) for more information and examples
 
 `-o, --output [output]`
-: Output type. `json,text`. Default `text`
+: Output type. `json,text,csv`. Default `json`
 
 `--verbose`
 : Runs command with verbose logging
 
 `--debug`
-: Runs command with debug logging
+: Runs command with debug logging

package/docs/docs/cmd/aad/app/app-delete.md

@@ -0,0 +1,51 @@
+# aad app delete
+
+Removes an Azure AD app registration
+
+## Usage
+
+```sh
+m365 aad app delete [options]
+```
+
+## Options
+
+`--appId [appId]`
+: Application (client) ID of the Azure AD application registration to remove. Specify either `appId`, `objectId` or `name`
+
+`--objectId [objectId]`
+: Object ID of the Azure AD application registration to remove. Specify either `appId`, `objectId` or `name`
+
+`--name [name]`
+: Name of the Azure AD application registration to remove. Specify either `appId`, `objectId` or `name`
+
+`--confirm`:
+: Don't prompt for confirmation to delete the app
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+For best performance use the `objectId` option to reference the Azure AD application registration to delete. 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
+
+Delete the Azure AD application registration by its app (client) ID
+
+```sh
+m365 aad app delete --appId d75be2e1-0204-4f95-857d-51a37cf40be8
+```
+
+Delete the Azure AD application registration by its object ID
+
+```sh
+m365 aad app delete --objectId d75be2e1-0204-4f95-857d-51a37cf40be8
+```
+
+Delete the Azure AD application registration by its name. Will NOT prompt for confirmation before deleting.
+
+```sh
+m365 aad app delete --name "My app" --confirm
+```

package/docs/docs/cmd/aad/app/app-get.md

@@ -0,0 +1,59 @@
+# aad app get
+
+Gets an Azure AD app registration
+
+## Usage
+
+```sh
+m365 aad app get [options]
+```
+
+## Options
+
+`--appId [appId]`
+: Application (client) ID of the Azure AD application registration to get. Specify either `appId`, `objectId` or `name`
+
+`--objectId [objectId]`
+: Object ID of the Azure AD application registration to get. Specify either `appId`, `objectId` or `name`
+
+`--name [name]`
+: Name of the Azure AD application registration to get. Specify either `appId`, `objectId` or `name`
+
+`--save`
+: Use to store the information about the created app in a local file
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+For best performance use the `objectId` option to reference the Azure AD application registration to get. 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.
+
+If you want to store the information about the Azure AD app registration, use the `--save` option. This is useful when you build solutions connected to Microsoft 365 and want to easily manage app registrations used with your solution. When you use the `--save` option, after you get the app registration, the command will write its ID and name to the `.m365rc.json` file in the current directory. If the file already exists, it will add the information about the App registration to it if it's not already present, allowing you to track multiple apps. If the file doesn't exist, the command will create it.
+
+## Examples
+
+Get the Azure AD application registration by its app (client) ID
+
+```sh
+m365 aad app get --appId d75be2e1-0204-4f95-857d-51a37cf40be8
+```
+
+Get the Azure AD application registration by its object ID
+
+```sh
+m365 aad app get --objectId d75be2e1-0204-4f95-857d-51a37cf40be8
+```
+
+Get the Azure AD application registration by its name
+
+```sh
+m365 aad app get --name "My app"
+```
+
+Get the Azure AD application registration by its name. Store information about the retrieved app registration in the _.m365rc.json_ file in the current directory.
+
+```sh
+m365 aad app get --name "My app" --save
+```

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

@@ -22,6 +22,15 @@ m365 aad app set [options]
 `-u, --uri [uri]`
 : Application ID URI 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
+
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
@@ -49,3 +58,15 @@ Update the app URI of the Azure AD application registration specified by its nam
 ```sh
 m365 aad app set --name "My app" --uri 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
+```

package/docs/docs/cmd/aad/group/group-list.md

@@ -0,0 +1,30 @@
+# aad group list
+
+Lists Azure AD groups
+
+## Usage
+
+```sh
+m365 aad group list [options]
+```
+
+## Options
+
+`-d, --deleted`
+: Use to retrieve deleted groups
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Lists all groups defined in Azure Active Directory.
+
+```sh
+m365 aad group list
+```
+
+List all recently deleted groups in the tenant
+
+```sh
+m365 aad group list --deleted
+```