@pnp/cli-microsoft365 6.8.0-beta.f473be5 → 6.9.0-beta.1cd2525

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

@@ -0,0 +1,131 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo customaction set
+
+Updates a user custom action for site or site collection
+
+## Usage
+
+```sh
+m365 spo customaction set [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: Url of the site or site collection to update the custom action
+
+`-i, --id <id>`
+: ID of the custom action to update
+
+`-n, --name [name]`
+: The name of the custom action
+
+`-t, --title [title]`
+: The title of the custom action
+
+`-l, --location [location]`
+: The actual location where this custom action need to be added like `CommandUI.Ribbon`
+
+`-g, --group [group]`
+: The group of the custom action like `SiteActions`
+
+`-d, --description [description]`
+: The description of the custom action
+
+`--sequence [sequence]`
+: Sequence of this CustomAction being injected. Use when you have a specific sequence with which to have multiple CustomActions being added to the page
+
+`--actionUrl [actionUrl]`
+: The URL, URI or JavaScript function associated with the action. URL example `~site/_layouts/sampleurl.aspx` or `~sitecollection/_layouts/sampleurl.aspx`
+
+`--imageUrl [imageUrl]`
+: The URL of the image associated with the custom action
+
+`-e, --commandUIExtension [commandUIExtension]`
+: XML fragment that determines user interface properties of the custom action
+
+`--registrationId [registrationId]`
+: Specifies the identifier of the list or item content type that this action is associated with, or the file type or programmatic identifier
+
+`--registrationType [registrationType]`
+: Specifies the type of object associated with the custom action. Allowed values `None`, `List`, `ContentType`, `ProgId`, `FileType`. Default `None`
+
+`--rights [rights]`
+: A case-sensitive string array that contain the permissions needed for the custom action. Allowed values `EmptyMask`, `ViewListItems`, `AddListItems`, `EditListItems`, `DeleteListItems`, `ApproveItems`, `OpenItems`, `ViewVersions`, `DeleteVersions`, `CancelCheckout`, `ManagePersonalViews`, `ManageLists`, `ViewFormPages`, `AnonymousSearchAccessList`, `Open`, `ViewPages`, `AddAndCustomizePages`, `ApplyThemeAndBorder`, `ApplyStyleSheets`, `ViewUsageData`, `CreateSSCSite`, `ManageSubwebs`, `CreateGroups`, `ManagePermissions`, `BrowseDirectories`, `BrowseUserInfo`, `AddDelPrivateWebParts`, `UpdatePersonalWebParts`, `ManageWeb`, `AnonymousSearchAccessWebLists`, `UseClientIntegration`, `UseRemoteAPIs`, `ManageAlerts`, `CreateAlerts`, `EditMyUserInfo`, `EnumeratePermissions`, `FullMask`. Default `EmptyMask`
+
+`-s, --scope [scope]`
+: Scope of the existing custom action. Allowed values `Site`, `Web`, `All`. Default `All`. Note, this would not update the scope, but might speed up the execution of the scope of the custom action is known.
+
+`--scriptBlock [scriptBlock]`
+: Specifies a block of script to be executed. This attribute is only applicable when the Location attribute is set to ScriptLink
+
+`--scriptSrc [scriptSrc]`
+: Specifies a file that contains script to be executed. This attribute is only applicable when the Location attribute is set to ScriptLink
+
+`-c, --clientSideComponentId [clientSideComponentId]`
+: The Client Side Component Id (GUID) of the custom action
+
+`-p, --clientSideComponentProperties [clientSideComponentProperties]`
+: The Client Side Component Properties of the custom action. Specify values as a JSON string : `'{"testMessage":"Test message"}'`
+```
+
+<Global />
+
+## Remarks
+
+Running this command from the Windows Command Shell (cmd.exe) or PowerShell for Windows OS XP, 7, 8, 8.1 without bash installed might require additional formatting for command options that have JSON, XML or JavaScript values because the command shell treats quotes differently. For example, this is how ApplicationCustomizer user custom action can be created from the Windows cmd.exe:
+
+```sh
+m365 spo customaction set --webUrl https://contoso.sharepoint.com/sites/test --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --clientSideComponentProperties '{\"testMessage\":\"Test message\"}'
+```
+
+The `--rights` option accepts **case-sensitive** values.
+
+Note, specifying the scope option might speed up the execution of the command, but would not update the scope. If the scope has to be changed, then the existing custom action should be removed and new should be added with different scope.
+
+:::caution Escaping JSON in PowerShell
+
+When using the `--clientSideComponentProperties` option it's possible to enter a JSON string. In PowerShell 5 to 7.2 [specific escaping rules](./../../../user-guide/using-cli.mdx#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../../user-guide/using-cli.mdx#passing-complex-content-into-cli-options) instead.
+
+:::
+
+## Examples
+
+Updates tenant-wide SharePoint Framework Application Customizer extension properties in site _https://contoso.sharepoint.com/sites/test_
+
+```sh
+m365 spo customaction set --webUrl https://contoso.sharepoint.com/sites/test --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --clientSideComponentProperties '{"testMessage":"Test message"}'
+```
+
+Updates tenant-wide SharePoint Framework **modern List View** Command Set extension in site _https://contoso.sharepoint.com/sites/test_
+
+```sh
+m365 spo customaction set --webUrl https://contoso.sharepoint.com/sites/test --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --clientSideComponentProperties '{"sampleTextOne":"One item is selected in the list.", "sampleTextTwo":"This command is always visible."}' --sequence 100
+```
+
+Updates url custom action in the SiteActions menu in site _https://contoso.sharepoint.com/sites/test_
+
+```sh
+m365 spo customaction set --webUrl https://contoso.sharepoint.com/sites/test --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --actionUrl "~site/SitePages/Home.aspx"
+```
+
+Updates ScriptLink custom action with script source in **classic pages** in site collection _https://contoso.sharepoint.com/sites/test_
+
+```sh
+m365 spo customaction set --webUrl https://contoso.sharepoint.com/sites/test --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --scriptSrc "~sitecollection/SiteAssets/YourScript.js"
+```
+
+Creates custom action with delegated rights in the SiteActions menu in site _https://contoso.sharepoint.com/sites/test_
+
+```sh
+m365 spo customaction set --webUrl https://contoso.sharepoint.com/sites/test --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --rights "AddListItems,DeleteListItems,ManageLists"
+```
+
+## More information
+
+- UserCustomAction REST API resources: [https://msdn.microsoft.com/en-us/library/office/dn531432.aspx#bk_UserCustomAction](https://msdn.microsoft.com/en-us/library/office/dn531432.aspx#bk_UserCustomAction)
+- UserCustomAction Locations and Group IDs: [https://msdn.microsoft.com/en-us/library/office/bb802730.aspx](https://msdn.microsoft.com/en-us/library/office/bb802730.aspx)
+- UserCustomAction Element: [https://msdn.microsoft.com/en-us/library/office/ms460194.aspx](https://msdn.microsoft.com/en-us/library/office/ms460194.aspx)
+- UserCustomAction Rights: [https://msdn.microsoft.com/en-us/library/office/microsoft.sharepoint.spbasepermissions.aspx](https://msdn.microsoft.com/en-us/library/office/microsoft.sharepoint.spbasepermissions.aspx)

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

@@ -0,0 +1,119 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo eventreceiver get
+
+Retrieves specific event receiver for the specified web, site or list by event receiver name or id.
+
+## Usage
+
+```sh
+m365 spo eventreceiver get [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The URL of the web for which to retrieve the event receivers.
+
+`--listTitle [listTitle]`
+: The title of the list for which to retrieve the event receivers, _if the event receivers should be retrieved from a list_. Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listId [listId]`
+: The id of the list for which to retrieve the event receivers, _if the event receivers should be retrieved from a list_. Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listUrl [listUrl]`
+: The url of the list for which to retrieve the event receivers, _if the event receivers should be retrieved from a list_. Specify either `listTitle`, `listId` or `listUrl`.
+
+`-n, --name [name]`
+: The name of the event receiver to retrieve. Specify either `name` or `id` but not both.
+
+`-i, --id [id]`
+: The id of the event receiver to retrieve. Specify either `name` or `id` but not both.
+
+`-s, --scope [scope]`
+: The scope of which to retrieve the event receivers. Can be either `site` or `web`. Defaults to `web`. Only applicable when not specifying any of the list properties.
+```
+
+<Global />
+
+## Examples
+
+Retrieve event receivers in web _<https://contoso.sharepoint.com/sites/contoso-sales>_ with name _PnP Test Receiver_.
+
+```sh
+m365 spo eventreceiver list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --name 'PnP Test Receiver'
+```
+
+Retrieve event receivers in site _<https://contoso.sharepoint.com/sites/contoso-sales>_ with id _c5a6444a-9c7f-4a0d-9e29-fc6fe30e34ec_.
+
+```sh
+m365 spo eventreceiver list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --scope site --id c5a6444a-9c7f-4a0d-9e29-fc6fe30e34ec
+```
+
+Retrieve event receivers for list with title _Events_ in web _<https://contoso.sharepoint.com/sites/contoso-sales>_ with name _PnP Test Receiver_.
+
+```sh
+m365 spo eventreceiver list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listTitle Events --name 'PnP Test Receiver'
+```
+
+Retrieve event receivers for list with ID _202b8199-b9de-43fd-9737-7f213f51c991_ in web _<https://contoso.sharepoint.com/sites/contoso-sales>_ with id _c5a6444a-9c7f-4a0d-9e29-fc6fe30e34ec_.
+
+```sh
+m365 spo eventreceiver list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listId '202b8199-b9de-43fd-9737-7f213f51c991' --id c5a6444a-9c7f-4a0d-9e29-fc6fe30e34ec
+```
+
+Retrieve event receivers for list with url _/sites/contoso-sales/lists/Events_ in web _<https://contoso.sharepoint.com/sites/contoso-sales>_ with name _PnP Test Receiver_.
+
+```sh
+m365 spo eventreceiver list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listUrl '/sites/contoso-sales/lists/Events' --name 'PnP Test Receiver'
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "ReceiverAssembly": "Microsoft.Office.Server.UserProfiles, Version=16.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c",
+    "ReceiverClass": "Microsoft.Office.Server.UserProfiles.ContentFollowingWebEventReceiver",
+    "ReceiverId": "c5a6444a-9c7f-4a0d-9e29-fc6fe30e34ec",
+    "ReceiverName": "PnP Test Receiver",
+    "SequenceNumber": 10000,
+    "Synchronization": 2,
+    "EventType": 10204,
+    "ReceiverUrl": "https://northeurope1-0.pushnp.svc.ms/notifications?token=b4c0def2-a5ea-490a-bb85-c2e423b1384b"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  EventType       : 10204
+  ReceiverAssembly: Microsoft.Office.Server.UserProfiles, Version=16.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c
+  ReceiverClass   : Microsoft.Office.Server.UserProfiles.ContentFollowingWebEventReceiver
+  ReceiverId      : c5a6444a-9c7f-4a0d-9e29-fc6fe30e34ec
+  ReceiverName    : PnP Test Receiver
+  ReceiverUrl     : https://northeurope1-0.pushnp.svc.ms/notifications?token=b4c0def2-a5ea-490a-bb85-c2e423b1384b
+  SequenceNumber  : 10000
+  Synchronization : 2
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  ReceiverAssembly,ReceiverClass,ReceiverId,ReceiverName,SequenceNumber,Synchronization,EventType,ReceiverUrl
+  "Microsoft.Office.Server.UserProfiles, Version=16.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c",Microsoft.Office.Server.UserProfiles.ContentFollowingWebEventReceiver,c5a6444a-9c7f-4a0d-9e29-fc6fe30e34ec,PnP Test Receiver,10000,2,10204,https://northeurope1-0.pushnp.svc.ms/notifications?token=b4c0def2-a5ea-490a-bb85-c2e423b1384b
+  ```
+
+  </TabItem>
+</Tabs>
+
+
+
+

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

@@ -0,0 +1,64 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo eventreceiver list
+
+Retrieves event receivers for the specified web, site or list.
+
+## Usage
+
+```sh
+m365 spo eventreceiver list [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The URL of the web for which to retrieve the event receivers.
+
+`--listTitle [listTitle]`
+: The title of the list for which to retrieve the event receivers, _if the event receivers should be retrieved from a list_. Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listId [listId]`
+: The id of the list for which to retrieve the event receivers, _if the event receivers should be retrieved from a list_. Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listUrl [listUrl]`
+: The url of the list for which to retrieve the event receivers, _if the event receivers should be retrieved from a list_. Specify either `listTitle`, `listId` or `listUrl`.
+
+`-s, --scope [scope]`
+: The scope of which to retrieve the Event Receivers. Can be either "site" or "web". Defaults to "web". Only applicable when not specifying any of the list properties.
+```
+
+<Global />
+
+## Examples
+
+Retrieves event receivers in web _<https://contoso.sharepoint.com/sites/contoso-sales>_.
+
+```sh
+m365 spo eventreceiver list --webUrl https://contoso.sharepoint.com/sites/contoso-sales
+```
+
+Retrieves event receivers in site _<https://contoso.sharepoint.com/sites/contoso-sales>_.
+
+```sh
+m365 spo eventreceiver list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --scope site
+```
+
+Retrieves event receivers for list with title _Events_ in web _<https://contoso.sharepoint.com/sites/contoso-sales>_.
+
+```sh
+m365 spo eventreceiver list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listTitle Events
+```
+
+Retrieves event receivers for list with ID _202b8199-b9de-43fd-9737-7f213f51c991_ in web _<https://contoso.sharepoint.com/sites/contoso-sales>_.
+
+```sh
+m365 spo eventreceiver list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listId '202b8199-b9de-43fd-9737-7f213f51c991'
+```
+
+Retrieves event receivers for list with url _/sites/contoso-sales/lists/Events_ in web _<https://contoso.sharepoint.com/sites/contoso-sales>_.
+
+```sh
+m365 spo eventreceiver list --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listUrl '/sites/contoso-sales/lists/Events'
+```

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

@@ -0,0 +1,81 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo eventreceiver remove
+
+Removes event receivers for the specified web, site, or list.
+
+## Usage
+
+```sh
+m365 spo eventreceiver remove [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The URL of the web.
+
+`--listTitle [listTitle]`
+: The title of the list, _if the event receiver should be removed from a list_. Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listId [listId]`
+: The id of the list, _if the event receiver should be retrieved from a list_. Specify either `listTitle`, `listId` or `listUrl`.
+
+`--listUrl [listUrl]`
+: The url of the list, _if the event receiver should be retrieved from a list_. Specify either `listTitle`, `listId` or `listUrl`.
+
+`-n, --name [name]`
+: The name. Specify either `name` or `id` but not both.
+
+`-i, --id [id]`
+: The id. Specify either `name` or `id` but not both.
+
+`-s, --scope [scope]`
+: The scope. Can be either "site" or "web". Defaults to "web". Only applicable when not specifying any of the list properties.
+
+`--confirm`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Remarks
+
+:::caution
+
+You can only remove an event receiver if it has been registered by an app with the same ID.
+
+:::
+
+## Examples
+
+Remove event receiver in a specific web by name.
+
+```sh
+m365 spo eventreceiver remove --webUrl https://contoso.sharepoint.com/sites/contoso-sales --name 'PnP Test Receiver'
+```
+
+Remove event receiver in a specific site by id.
+
+```sh
+m365 spo eventreceiver remove --webUrl https://contoso.sharepoint.com/sites/contoso-sales --scope site --id c5a6444a-9c7f-4a0d-9e29-fc6fe30e34ec
+```
+
+Remove event receiver in a specific list retrieved by title by name.
+
+```sh
+m365 spo eventreceiver remove --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listTitle Events --name 'PnP Test Receiver'
+```
+
+Remove event receiver in a specific list retrieved by list id by id.
+
+```sh
+m365 spo eventreceiver remove --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listId '202b8199-b9de-43fd-9737-7f213f51c991' --id c5a6444a-9c7f-4a0d-9e29-fc6fe30e34ec
+```
+
+Remove event receiver in a specific list retrieved by list url by name.
+
+```sh
+m365 spo eventreceiver remove --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listUrl '/sites/contoso-sales/lists/Events' --name 'PnP Test Receiver'
+```

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

@@ -0,0 +1,68 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo externaluser list
+
+Lists external users in the tenant
+
+## Usage
+
+```sh
+m365 spo externaluser list [options]
+```
+
+## Options
+
+```md definition-list
+`-f, --filter [filter]`
+: Limits the results to only those users whose first name, last name or email address begins with the text in the string, using a case-insensitive comparison
+
+`-p, --pageSize [pageSize]`
+: Specifies the maximum number of users to be returned in the collection. The value must be less than or equal to `50`
+
+`-i, --position [position]`
+: Use to specify the zero-based index of the position in the sorted collection of the first result to be returned
+
+`-s, --sortOrder [sortOrder]`
+: Specifies the sort results in Ascending or Descending order on the `SPOUser.Email` property should occur. Allowed values `asc|desc`. Default `asc`
+
+`-u, --siteUrl [siteUrl]`
+: Specifies the site to retrieve external users for. If no site is specified, the external users for all sites are returned
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command you have to have permissions to access the tenant admin site.
+
+:::
+
+## Examples
+
+List all external users from the current tenant. Show the first batch of 50 users.
+
+```sh
+m365 spo externaluser list --pageSize 50 --position 0
+```
+
+List all external users from the current tenant whose first name, last name or email address
+begins with `Vesa`. Show the first batch of 50 users.
+
+```sh
+m365 spo externaluser list --pageSize 50 --position 0 --filter Vesa
+```
+
+List all external users from the specified site. Show the first batch of 50 users.
+
+```sh
+m365 spo externaluser list --pageSize 50 --position 0 --siteUrl https://contoso.sharepoint.com
+```
+
+List all external users from the current tenant. Show the first batch of 50 users sorted descending
+by e-mail.
+
+```sh
+m365 spo externaluser list --pageSize 50 --position 0 --sortOrder desc
+```

package/docs/docs/cmd/spo/feature/feature-disable.mdx

@@ -0,0 +1,47 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo feature disable
+
+Disables a feature for the specified site or web
+
+## Usage
+
+```sh
+m365 spo feature disable [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The URL of the site or web for which to disable the feature
+
+`-i, --id <id>`
+: The ID of the feature to disable
+
+`-s, --scope [scope]`
+: Scope of the Feature to disable. Allowed values `Site,Web`. Default `Web`
+
+`--force`
+: Specifies whether to continue if an error occurs when disabling the feature
+```
+
+<Global />
+
+## Remarks
+
+If the specified url doesn't refer to an existing site collection, you will get a `"404 FILE NOT FOUND"` error.
+
+## Examples
+
+Disable site feature
+
+```sh
+m365 spo feature disable --webUrl https://contoso.sharepoint.com/sites/salis --id 915c240e-a6cc-49b8-8b2c-0bff8b553ed3 --scope Site
+```
+
+Disable web feature (with force to ignore errors)
+
+```sh
+m365 spo feature disable --webUrl https://contoso.sharepoint.com/sites/salis --id 00bfea71-5932-4f9c-ad71-1557e5751100 --scope Web --force
+```

package/docs/docs/cmd/spo/feature/feature-enable.mdx

@@ -0,0 +1,47 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo feature enable
+
+Enables feature for the specified site or web
+
+## Usage
+
+```sh
+m365 spo feature enable [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The URL of the site or web for which to enable the feature
+
+`-i, --id <id>`
+: The ID of the feature to enable
+
+`-s, --scope [scope]`
+: Scope of the Feature to enable. Allowed values `Site,Web`. Default `Web`
+
+`--force`
+: Specifies whether to overwrite an existing feature with the same feature identifier. This parameter is ignored if there are no errors.
+```
+
+<Global />
+
+## Remarks
+
+If the specified url doesn't refer to an existing site collection, you will get a `"404 FILE NOT FOUND"` error.
+
+## Examples
+
+Enable site feature
+
+```sh
+m365 spo feature enable --webUrl https://contoso.sharepoint.com/sites/sales --id 915c240e-a6cc-49b8-8b2c-0bff8b553ed3 --scope Site
+```
+
+Enable web feature (with force to overwrite feature with same id)
+
+```sh
+m365 spo feature enable --webUrl https://contoso.sharepoint.com/sites/sales --id 00bfea71-5932-4f9c-ad71-1557e5751100 --scope Web --force
+```

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

@@ -0,0 +1,37 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo feature list
+
+Lists Features activated in the specified site or site collection
+
+## Usage
+
+```sh
+m365 spo feature list [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: URL of the site (collection) to retrieve the activated Features from
+
+`-s, --scope [scope]`
+: Scope of the Features to retrieve. Allowed values `Site,Web`. Default `Web`
+```
+
+<Global />
+
+## Examples
+
+Return details about Features activated in the specified site collection
+
+```sh
+m365 spo feature list --webUrl https://contoso.sharepoint.com/sites/test --scope Site
+```
+
+Return details about Features activated in the specified site
+
+```sh
+m365 spo feature list --webUrl https://contoso.sharepoint.com/sites/test --scope Web
+```

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

@@ -0,0 +1,75 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo field add
+
+Adds a new list or site column using the CAML field definition
+
+## Usage
+
+```sh
+m365 spo field add [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: Absolute URL of the site where the field should be created
+
+`-l, --listTitle [listTitle]`
+: Title of the list where the field should be created (if it should be created as a list column). Specify either `listTitle`, `listId` or `listUrl`
+
+`--listId [listId]`
+: ID of the list where the field should be created (if it should be created as a list column). Specify either `listTitle`, `listId` or `listUrl`
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list where the field should be created (if it should be created as a list column). Specify either `listTitle`, `listId` or `listUrl`
+
+`-x, --xml <xml>`
+: CAML field definition
+
+`--options [options]`
+: The options to use to add to the field. Allowed values: `DefaultValue`,`AddToDefaultContentType`, `AddToNoContentType`, `AddToAllContentTypes`, `AddFieldInternalNameHint`, `AddFieldToDefaultView`, `AddFieldCheckDisplayName`
+```
+
+<Global />
+
+## Remarks
+
+If the specified field already exists, you will get a _A duplicate field name "your-field" was found._ error.
+
+## Examples
+
+Create a date time site column
+
+```sh
+m365 spo field add --webUrl https://contoso.sharepoint.com/sites/contoso-sales --xml '`<Field Type="DateTime" DisplayName="Start date-time" Required="FALSE" EnforceUniqueValues="FALSE" Indexed="FALSE" Format="DateTime" Group="PnP Columns" FriendlyDisplayFormat="Disabled" ID="{5ee2dd25-d941-455a-9bdb-7f2c54aed11b}" SourceID="{4f118c69-66e0-497c-96ff-d7855ce0713d}" StaticName="PnPAlertStartDateTime" Name="PnPAlertStartDateTime"><Default>[today]</Default></Field>`'
+```
+
+Create a URL list column to a list retrieved by Title
+
+```sh
+m365 spo field add --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listTitle Events --xml '`<Field Type="URL" DisplayName="More information link" Required="FALSE" EnforceUniqueValues="FALSE" Indexed="FALSE" Format="Hyperlink" Group="PnP Columns" ID="{6085e32a-339b-4da7-ab6d-c1e013e5ab27}" SourceID="{4f118c69-66e0-497c-96ff-d7855ce0713d}" StaticName="PnPAlertMoreInformation" Name="PnPAlertMoreInformation"></Field>`'
+```
+
+Create a URL list column and add it to all content types
+
+```sh
+m365 spo field add --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listTitle Events --xml '`<Field Type="URL" DisplayName="More information link" Required="FALSE" EnforceUniqueValues="FALSE" Indexed="FALSE" Format="Hyperlink" Group="PnP Columns" ID="{6085e32a-339b-4da7-ab6d-c1e013e5ab27}" SourceID="{4f118c69-66e0-497c-96ff-d7855ce0713d}" StaticName="PnPAlertMoreInformation" Name="PnPAlertMoreInformation"></Field>`' --options AddToAllContentTypes
+```
+
+Create a URL list column to a list retrieved by ID
+
+```sh
+m365 spo field add --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listId e785fe80-2ca1-409e-b9d1-19055a85cd38 --xml '`<Field Type="URL" DisplayName="More information link" Required="FALSE" EnforceUniqueValues="FALSE" Indexed="FALSE" Format="Hyperlink" Group="PnP Columns" ID="{6085e32a-339b-4da7-ab6d-c1e013e5ab27}" SourceID="{4f118c69-66e0-497c-96ff-d7855ce0713d}" StaticName="PnPAlertMoreInformation" Name="PnPAlertMoreInformation"></Field>`'
+```
+
+Create a date time list column to a list retrieved by URL
+
+```sh
+m365 spo field add --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listUrl /sites/contoso-sales/lists/Events --xml '`<Field Type="DateTime" DisplayName="Start date-time" Required="FALSE" EnforceUniqueValues="FALSE" Indexed="FALSE" Format="DateTime" Group="PnP Columns" FriendlyDisplayFormat="Disabled" ID="{5ee2dd25-d941-455a-9bdb-7f2c54aed11b}" SourceID="{4f118c69-66e0-497c-96ff-d7855ce0713d}" StaticName="PnPAlertStartDateTime" Name="PnPAlertStartDateTime"><Default>[today]</Default></Field>`'
+```
+
+## More information
+
+- AddFieldOptions enumeration: [https://msdn.microsoft.com/en-us/library/microsoft.sharepoint.client.addfieldoptions.aspx](https://msdn.microsoft.com/en-us/library/microsoft.sharepoint.client.addfieldoptions.aspx)