@pnp/cli-microsoft365 11.10.0-beta.6474466 → 11.10.0-beta.fdeb2ae

package/dist/m365/pp/commands/website/Webrole.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Webrole.js.map

package/dist/m365/pp/commands/website/website-remove.js

@@ -0,0 +1,80 @@
+import { globalOptionsZod } from '../../../../Command.js';
+import { powerPlatform } from '../../../../utils/powerPlatform.js';
+import { validation } from '../../../../utils/validation.js';
+import PowerPlatformCommand from '../../../base/PowerPlatformCommand.js';
+import commands from '../../commands.js';
+import { z } from 'zod';
+import request from '../../../../request.js';
+import { cli } from '../../../../cli/cli.js';
+export const options = z.strictObject({
+    ...globalOptionsZod.shape,
+    url: z.string().optional()
+        .refine(url => url === undefined || validation.isValidPowerPagesUrl(url) === true, {
+        error: e => `'${e.input}' is not a valid Power Pages URL.`
+    })
+        .alias('u'),
+    id: z.uuid().optional().alias('i'),
+    name: z.string().optional().alias('n'),
+    environmentName: z.string().alias('e'),
+    force: z.boolean().optional().alias('f')
+});
+class PpWebSiteRemoveCommand extends PowerPlatformCommand {
+    get name() {
+        return commands.WEBSITE_REMOVE;
+    }
+    get description() {
+        return 'Removes the specified Power Pages website from the list of active sites.';
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => [options.url, options.id, options.name].filter(x => x !== undefined).length === 1, {
+            error: `Specify either url, id or name, but not multiple.`
+        });
+    }
+    async commandAction(logger, args) {
+        if (args.options.verbose) {
+            await logger.logToStderr(`Removing website '${args.options.id || args.options.name || args.options.url}'...`);
+        }
+        if (args.options.force) {
+            await this.deleteWebsite(args);
+        }
+        else {
+            const result = await cli.promptForConfirmation({ message: `Are you sure you want to remove website '${args.options.id || args.options.name || args.options.url}'?` });
+            if (result) {
+                await this.deleteWebsite(args);
+            }
+        }
+    }
+    async getWebsiteId(args) {
+        if (args.options.id) {
+            return args.options.id;
+        }
+        if (args.options.name) {
+            const website = await powerPlatform.getWebsiteByName(args.options.environmentName, args.options.name);
+            return website.id;
+        }
+        const website = await powerPlatform.getWebsiteByUrl(args.options.environmentName, args.options.url);
+        return website.id;
+    }
+    async deleteWebsite(args) {
+        try {
+            const websiteId = await this.getWebsiteId(args);
+            const requestOptions = {
+                url: `https://api.powerplatform.com/powerpages/environments/${args.options.environmentName}/websites/${websiteId}?api-version=2022-03-01-preview`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none'
+                },
+                responseType: 'json'
+            };
+            await request.delete(requestOptions);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+export default new PpWebSiteRemoveCommand();
+//# sourceMappingURL=website-remove.js.map

package/dist/m365/pp/commands/website/website-webrole-list.js

@@ -0,0 +1,61 @@
+import { globalOptionsZod } from '../../../../Command.js';
+import { powerPlatform } from '../../../../utils/powerPlatform.js';
+import PowerPlatformCommand from '../../../base/PowerPlatformCommand.js';
+import commands from '../../commands.js';
+import { odata } from '../../../../utils/odata.js';
+import { z } from 'zod';
+export const options = z.strictObject({
+    ...globalOptionsZod.shape,
+    websiteId: z.uuid().optional(),
+    websiteName: z.string().optional(),
+    environmentName: z.string().alias('e'),
+    asAdmin: z.boolean().optional()
+});
+class PpWebSiteWebRoleListCommand extends PowerPlatformCommand {
+    get name() {
+        return commands.WEBSITE_WEBROLE_LIST;
+    }
+    get description() {
+        return 'Lists all webroles for the specified Power Pages website.';
+    }
+    get schema() {
+        return options;
+    }
+    defaultProperties() {
+        return ['mspp_webroleid', 'mspp_name', 'statuscode'];
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => [options.websiteId, options.websiteName].filter(x => x !== undefined).length === 1, {
+            error: `Specify either websiteId or websiteName, but not both.`
+        });
+    }
+    async commandAction(logger, args) {
+        if (this.verbose) {
+            await logger.logToStderr(`Retrieving the webroles for '${args.options.websiteId || args.options.websiteName}'...`);
+        }
+        try {
+            const dynamicsApiUrl = await powerPlatform.getDynamicsInstanceApiUrl(args.options.environmentName, args.options.asAdmin);
+            const websiteRecordId = await this.getWebsiteRecordId(args, dynamicsApiUrl);
+            const roles = await this.getWebsiteRoles(dynamicsApiUrl, websiteRecordId);
+            await logger.log(roles);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+    async getWebsiteRecordId(args, dynamicsApiUrl) {
+        if (args.options.websiteId) {
+            const website = await powerPlatform.getWebsiteById(args.options.environmentName, args.options.websiteId);
+            return website.websiteRecordId;
+        }
+        return powerPlatform.getWebsiteIdByUniqueName(dynamicsApiUrl, args.options.websiteName);
+    }
+    async getWebsiteRoles(dynamicsApiUrl, websiteId) {
+        const requestUrl = `${dynamicsApiUrl}/api/data/v9.2/mspp_webroles?$filter=_mspp_websiteid_value eq ${websiteId}`;
+        const result = await odata.getAllItems(requestUrl);
+        return result;
+    }
+}
+export default new PpWebSiteWebRoleListCommand();
+//# sourceMappingURL=website-webrole-list.js.map

package/dist/m365/pp/commands.js

@@ -27,6 +27,8 @@ export default {
     SOLUTION_PUBLISHER_REMOVE: `${prefix} solution publisher remove`,
     TENANT_SETTINGS_LIST: `${prefix} tenant settings list`,
     TENANT_SETTINGS_SET: `${prefix} tenant settings set`,
-    WEBSITE_GET: `${prefix} website get`
+    WEBSITE_GET: `${prefix} website get`,
+    WEBSITE_REMOVE: `${prefix} website remove`,
+    WEBSITE_WEBROLE_LIST: `${prefix} website webrole list`
 };
 //# sourceMappingURL=commands.js.map

package/dist/utils/powerPlatform.js

@@ -63,6 +63,26 @@ export const powerPlatform = {
         }
         return items[0];
     },
+    /**
+     * Get a website record ID by unique name
+     * Returns the powerpagesiteid of the website
+     * @param dynamicsApiUrl The dynamics api url of the environment
+     * @param websiteUniqueName The unique name of the Power Pages website
+     */
+    async getWebsiteIdByUniqueName(dynamicsApiUrl, websiteUniqueName) {
+        const requestOptions = {
+            url: `${dynamicsApiUrl}/api/data/v9.2/powerpagesites?$filter=name eq '${websiteUniqueName}'`,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json'
+        };
+        const result = await request.get(requestOptions);
+        if (result.value.length === 0) {
+            throw Error(`The specified website '${websiteUniqueName}' does not exist.`);
+        }
+        return result.value[0].powerpagesiteid;
+    },
     /**
      * Get a card by name
      * Returns a card object

package/docs/docs/cmd/pp/website/website-remove.mdx

@@ -0,0 +1,89 @@
+import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# pp website remove
+
+Removes the specified Power Pages website from the list of active sites.
+
+## Usage
+
+```sh
+m365 pp website remove [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --url [url]`
+: The URL of the website to remove. Specify either `url`, `name` or `id`.
+
+`-n, --name [name]`
+: The name of the website to remove. Specify either `url`, `name` or `id`.
+
+`-i, --id [id]`
+: The WebSite Id (GUID) of the website to remove. Specify either `url`, `name` or `id`.
+
+`-e, --environmentName <environmentName>`
+: The name of the environment from which to remove the Power Pages website.
+
+`-f, --force`
+: Don't prompt for confirmation
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource           | Permissions               |
+  |--------------------|---------------------------|
+  | Power Platform API | PowerPages.Websites.Write |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+Remove Power Pages website by name.
+
+```sh
+m365 pp website remove --name Demo --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5
+```
+
+Remove Power Pages website by name without confirmation.
+
+```sh
+m365 pp website remove --name Demo --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --force
+```
+
+Remove Power Pages website by id.
+
+```sh
+m365 pp website remove --id 4916bb2c-91e1-4716-91d5-b6171928fac9 --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5
+```
+
+Remove Power Pages website by id without confirmation.
+
+```sh
+m365 pp website remove --id 4916bb2c-91e1-4716-91d5-b6171928fac9 --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --force
+```
+
+Remove Power Pages website by url.
+
+```sh
+m365 pp website remove --url https://site-0uaq9.powerappsportals.com --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5
+```
+
+Remove Power Pages website by url without confirmation.
+
+```sh
+m365 pp website remove --url https://site-0uaq9.powerappsportals.com --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --force
+```
+
+## Response
+
+The command won't return a response on success.
+

package/docs/docs/cmd/pp/website/website-webrole-list.mdx

@@ -0,0 +1,139 @@
+import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# pp website webrole list
+
+Lists all webroles for the specified Power Pages website.
+
+## Usage
+
+```sh
+m365 pp website webrole list [options]
+```
+
+## Options
+
+```md definition-list
+`--websiteId [websiteId]`
+: ID of the Power Pages website. Specify either `websiteId` or `websiteName` but not both.
+
+`--websiteName [websiteName]`
+: The unique name (not the display name) of the Power Pages website. Specify either `websiteId` or `websiteName` but not both.
+
+`-e, --environmentName <environmentName>`
+: The name of the environment where the Power Pages websites are located.
+
+`--asAdmin`
+: Run the command as admin and retrieve Power Pages websites for environments you do not have explicitly assigned permissions to.
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource           | Permissions              |
+  |--------------------|--------------------------|
+  | Power Platform API | PowerPages.Websites.Read |
+  | Dynamics CRM       | user_impersonation       |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+List all webroles for the site by name.
+
+```sh
+m365 pp website webrole list --websiteName "Contoso" --environmentName "Default-2ca3eaa5-140f-4175-8261-3272edf9f339"
+```
+
+List all webroles for the site by name as admin.
+
+```sh
+m365 pp website webrole list --websiteName "Contoso" --environmentName "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --asAdmin
+```
+
+List all webroles for the site by id.
+
+```sh
+m365 pp website webrole list --websiteId "2ca3eaa5-140f-4175-8261-3272edf9f339" --environmentName "Default-2ca3eaa5-140f-4175-8261-3272edf9f339"
+```
+
+List all webroles for the site by id as admin.
+
+```sh
+m365 pp website webrole list --websiteId "2ca3eaa5-140f-4175-8261-3272edf9f339" --environmentName "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --asAdmin
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "mspp_webroleid": "a242a363-6077-4cb7-b2d1-1714502d129a",
+      "mspp_name": "Anonymous Users",
+      "mspp_description": "Role for anonymous users",
+      "mspp_key": null,
+      "mspp_authenticatedusersrole": false,
+      "mspp_anonymoususersrole": true,
+      "mspp_createdon": "2026-01-21T22:10:56Z",
+      "mspp_modifiedon": "2026-01-21T22:10:56Z",
+      "statecode": 0,
+      "statuscode": 1,
+      "_mspp_websiteid_value": "5eb107a6-5ac2-4e1c-a3b9-d5c21bbc10ce",
+      "_mspp_createdby_value": "b7aa2026-a8c1-f011-bbd2-000d3a66196e",
+      "_mspp_modifiedby_value": "b7aa2026-a8c1-f011-bbd2-000d3a66196e"
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  mspp_webroleid                        mspp_name        statuscode
+  ------------------------------------  ---------------  ----------
+  a242a363-6077-4cb7-b2d1-1714502d129a  Anonymous Users  1
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  mspp_modifiedon,mspp_key,mspp_description,mspp_authenticatedusersrole,statecode,_mspp_createdby_value,statuscode,mspp_anonymoususersrole,mspp_webroleid,mspp_createdon,_mspp_modifiedby_value,mspp_name,_mspp_websiteid_value
+  2026-01-21T22:10:56Z,,Role for anonymous users,0,0,b7aa2026-a8c1-f011-bbd2-000d3a66196e,1,1,a242a363-6077-4cb7-b2d1-1714502d129a,2026-01-21T22:10:56Z,b7aa2026-a8c1-f011-bbd2-000d3a66196e,Anonymous Users,5eb107a6-5ac2-4e1c-a3b9-d5c21bbc10ce
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # pp website webrole list --websiteName "Contoso" --environmentName "Default-2ca3eaa5-140f-4175-8261-3272edf9f339"
+
+  Date: 2/8/2026
+
+  Property | Value
+  ---------|-------
+  mspp\_modifiedon | 2026-01-21T22:10:53Z
+  mspp\_description | Role for anonymous users
+  mspp\_authenticatedusersrole | true
+  statecode | 0
+  \_mspp\_createdby\_value | b7aa2026-a8c1-f011-bbd2-000d3a66196e
+  statuscode | 1
+  mspp\_anonymoususersrole | false
+  mspp\_webroleid | cc3bf86b-204c-4a97-b0b6-f788c62ae5e8
+  mspp\_createdon | 2026-01-21T22:10:53Z
+  \_mspp\_modifiedby\_value | b7aa2026-a8c1-f011-bbd2-000d3a66196e
+  mspp\_name | Authenticated Users
+  \_mspp\_websiteid\_value | 5eb107a6-5ac2-4e1c-a3b9-d5c21bbc10ce
+  ```
+
+  </TabItem>
+</Tabs>

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

@@ -40,6 +40,25 @@ m365 spo field add [options]
 
 If the specified field already exists, you will get a _A duplicate field name "your-field" was found._ error.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | AllSites.Write |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions         |
+  |------------|---------------------|
+  | SharePoint | Sites.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Create a date time site column.

package/docs/docs/cmd/spo/field/field-get.mdx

@@ -39,6 +39,25 @@ m365 spo field get [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions   |
+  |------------|---------------|
+  | SharePoint | AllSites.Read |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | Sites.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Retrieves site column by id located in the specified site.

package/docs/docs/cmd/spo/field/field-list.mdx

@@ -30,6 +30,25 @@ m365 spo field list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions   |
+  |------------|---------------|
+  | SharePoint | AllSites.Read |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | Sites.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Retrieves site columns for the specified site.

package/docs/docs/cmd/spo/field/field-remove.mdx

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo field remove
 
@@ -43,6 +45,25 @@ m365 spo field remove [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | AllSites.Write |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions         |
+  |------------|---------------------|
+  | SharePoint | Sites.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Remove the site column with the specified ID, located in the specified site.

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

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo field set
 
@@ -50,6 +52,25 @@ When updating column formatting for a field with the `--CustomFormatter` option,
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions     |
+  |------------|-----------------|
+  | SharePoint | AllSites.Manage |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions      |
+  |------------|------------------|
+  | SharePoint | Sites.Manage.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Update the title of the site column specified by its internal name and push changes to existing lists.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "11.10.0-beta.6474466",
+  "version": "11.10.0-beta.fdeb2ae",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",