@pnp/cli-microsoft365 10.8.0-beta.708bf27 → 10.8.0-beta.7160233

package/docs/docs/cmd/spe/container/container-add.mdx

@@ -0,0 +1,128 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spe container add
+
+Creates a new container
+
+## Usage
+
+```sh
+m365 spe container add [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --name <name>`
+: The display name of the new container.
+
+`-d, --description [description]`
+: The description of the new container.
+
+`--containerTypeId [containerTypeId]`
+: The container type ID of the container instance. Use either `containerTypeId`, or `containerTypeName` but not both.
+
+`--containerTypeName [containerTypeName]`
+: The container type name of the container instance. Use either `containerTypeId`, or `containerTypeName` but not both.
+
+`--ocrEnabled [ocrEnabled]`
+: Indicates whether Optical Character Recognition (OCR) is enabled for the container. Possible values: `true`, `false`. Defaults to `false`.
+
+`--itemMajorVersionLimit [itemMajorVersionLimit]`
+: The maximum major versions allowed for items in the container. Defaults to `500`.
+
+`--itemVersioningEnabled [itemVersioningEnabled]`
+: Indicates whether versioning is enabled for items in the container. Possible values: `true`, `false`. Defaults to `true`.
+```
+
+<Global />
+
+## Examples
+
+Creates a new container by specifying the container type ID
+
+```sh
+m365 spe container add --name Invoices --containerTypeId bba89883-47c2-455b-956b-7a3d8db007fb
+```
+
+Creates a new container by specifying the container type name
+
+```sh
+m365 spe container add --name Invoices --containerTypeName "Invoice app container type"
+```
+
+Creates a new container with additional options
+
+```sh
+m365 spe container add --name Invoices --containerTypeId bba89883-47c2-455b-956b-7a3d8db007fb --ocrEnabled true --itemMajorVersionLimit 200 --itemVersioningEnabled true
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z",
+    "displayName": "Invoices",
+    "description": "This container is used to store invoices",
+    "containerTypeId": "bfdd048e-e03f-47d2-bd16-dbbc27281aa3",
+    "status": "inactive",
+    "createdDateTime": "2025-04-15T13:31:09.62Z",
+    "lockState": "unlocked",
+    "settings": {
+      "isOcrEnabled": false,
+      "itemMajorVersionLimit": 500,
+      "isItemVersioningEnabled": true
+    }
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  containerTypeId: bfdd048e-e03f-47d2-bd16-dbbc27281aa3
+  createdDateTime: 2025-04-15T15:14:03.89Z
+  description    : This container is used to store invoices
+  displayName    : Invoices
+  id             : b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z
+  lockState      : unlocked
+  settings       : {"isOcrEnabled":false,"itemMajorVersionLimit":500,"isItemVersioningEnabled":true}
+  status         : inactive
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,displayName,description,containerTypeId,status,createdDateTime,lockState
+  b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z,Invoices,This container is used to store invoices,bfdd048e-e03f-47d2-bd16-dbbc27281aa3,inactive,2025-04-15T15:14:45.317Z,unlocked
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spe container add --name "Invoices" --containerTypeId "bfdd048e-e03f-47d2-bd16-dbbc27281aa3" --description "This container is used to store invoices"
+
+  Date: 15/04/2025
+
+  ## Invoices (b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z)
+
+  Property | Value
+  ---------|-------
+  id | b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z
+  displayName | Invoices
+  description | This container is used to store invoices
+  containerTypeId | bfdd048e-e03f-47d2-bd16-dbbc27281aa3
+  status | inactive
+  createdDateTime | 2025-04-15T15:15:19.123Z
+  lockState | unlocked
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/spe/container/container-permission-list.mdx

@@ -0,0 +1,90 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spe container permission list
+
+Lists permissions of a SharePoint Embedded Container
+
+## Usage
+
+```sh
+m365 spe container permission list [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --containerId <id>`
+: The ID of the SharePoint Embedded Container.
+```
+
+<Global />
+
+## Examples
+
+Lists Container permissions.
+
+```sh
+m365 spe container permission list --containerId "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z"
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "id": "X2k6MCMuZnxtZW1iZXJzaGlwfGRlYnJhYkBuYWNoYW4zNjUub25taWNyb3NvZnQuY29t",
+      "roles": [
+        "owner"
+      ],
+      "grantedToV2": {
+        "user": {
+          "displayName": "John Doe",
+          "email": "john.doe@contoso.onmicrosoft.com",
+          "userPrincipalName": "john.doe@contoso.onmicrosoft.com"
+        }
+      }
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  id                                                                    userPrincipalName                 roles
+  --------------------------------------------------------------------  --------------------------------  ------
+  X2k6MCMuZnxtZW1iZXJzaGlwfGRlYnJhYkBuYWNoYW4zNjUub25taWNyb3NvZnQuY29t  john.doe@contoso.onmicrosoft.com  owner
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,roles,userPrincipalName
+  X2k6MCMuZnxtZW1iZXJzaGlwfGRlYnJhYkBuYWNoYW4zNjUub25taWNyb3NvZnQuY29t,owner,john.doe@contoso.onmicrosoft.com
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spe container permission list --containerId "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z"
+
+  Date: 3/3/2025
+
+  ## X2k6MCMuZnxtZW1iZXJzaGlwfGRlYnJhYkBuYWNoYW4zNjUub25taWNyb3NvZnQuY29t
+
+  Property | Value
+  ---------|-------
+  id | X2k6MCMuZnxtZW1iZXJzaGlwfGRlYnJhYkBuYWNoYW4zNjUub25taWNyb3NvZnQuY29t
+  roles | owner
+  userPrincipalName | john.doe@contoso.onmicrosoft.com
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/spe/container/container-recyclebinitem-list.mdx

@@ -0,0 +1,96 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spe container recyclebinitem list
+
+Lists deleted containers of a specific container type
+
+## Usage
+
+```sh
+m365 spe container recyclebinitem list [options]
+```
+
+## Options
+
+```md definition-list
+`--containerTypeId [containerTypeId]`
+: The container type ID of the container instance. Use either `containerTypeId` or `containerTypeName` but not both.
+
+`--containerTypeName [containerTypeName]`
+: The container type name of the container instance. Use either `containerTypeId` or `containerTypeName` but not both.
+```
+
+<Global />
+
+## Examples
+
+List deleted containers of a specific container type specified by id.
+
+```sh
+m365 spe container recyclebinitem list --containerTypeId "91710488-5756-407f-9046-fbe5f0b4de73"
+```
+
+List deleted containers of a specific container type specified by name.
+
+```sh
+m365 spe container recyclebinitem list --containerTypeName "My container type name"
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "id": "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z",
+      "displayName": "My Application Storage Container",
+      "containerTypeId": "1a55ba46-a673-45a4-b0d9-bd9913d06957",
+      "createdDateTime": "2025-04-15T21:51:48Z",
+      "settings": {
+        "isOcrEnabled": false
+      }
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  id                                                                  displayName
+  ------------------------------------------------------------------  --------------------------------
+  b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z  My Application Storage Container
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,displayName,containerTypeId,createdDateTime
+  b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z,My Application Storage Container,1a55ba46-a673-45a4-b0d9-bd9913d06957,2025-04-15T21:51:48Z
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spe container recyclebinitem list --containerTypeId "1a55ba46-a673-45a4-b0d9-bd9913d06957"
+
+  Date: 18/04/2025
+
+  ## My Application Storage Container (b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z)
+
+  Property | Value
+  ---------|-------
+  id | b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z
+  displayName | My Application Storage Container
+  containerTypeId | 1a55ba46-a673-45a4-b0d9-bd9913d06957
+  createdDateTime | 2025-04-15T21:51:48Z
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/spe/container/container-remove.mdx

@@ -0,0 +1,65 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spe container remove
+
+Removes a container
+
+## Usage
+
+```sh
+m365 spe container remove [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id [id]`
+: The ID of the container instance. Specify either `id` or `name` but not both.
+
+`-n, --name [name]`
+: The name of the container instance. Specify either `id` or `name` but not both.
+
+`--containerTypeId [containerTypeId]`
+: The ID of the container type. Specify either `containerTypeId` or `containerTypeName` when using `name` but not both.
+
+`--containerTypeName [containerTypeName]`
+: The name of the container type. Specify either `containerTypeId` or `containerTypeName` when using `name` but not both.
+
+`--recycle`
+: Recycle the container instance instead of permanently deleting it.
+
+`-f, --force`
+: Do not prompt for confirmation.
+```
+
+<Global />
+
+## Examples
+
+Remove a container by ID.
+
+```sh
+m365 spe container remove --id "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z"
+```
+
+Move a container specified by ID to the recycle bin.
+
+```sh
+m365 spe container remove --id "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z" --recycle
+```
+
+Remove a container by name specifying the container type id.
+
+```sh
+m365 spe container remove --name "My Application Storage Container" --containerTypeId d248c449-da7e-4119-b5f6-7bb0865a42f9
+```
+
+Remove a container by name specifying the container type name.
+
+```sh
+m365 spe container remove --name "My Application Storage Container" --containerTypeName "My Application Container Type"
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spe/containertype/containertype-add.mdx

@@ -38,8 +38,16 @@ m365 spe containertype add [options]
 
 ## Remarks
 
+:::info
+
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
+
+:::
+
 :::note
-You can only create one Trial Container per tenant, a single application registration can only contain one Container and a tenant can contain a maximum of five Containers in total.
+
+You can only create one Trial container type per tenant, a single application registration can only contain one container type and a tenant can contain a maximum of five containers types in total.
+
 :::
 
 ## Examples

package/docs/docs/cmd/spe/containertype/containertype-get.mdx

@@ -24,6 +24,14 @@ m365 containertype get [options]
 
 <Global />
 
+## Remarks
+
+:::info
+
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
+
+:::
+
 ## Examples
 
 Gets Container Type by id

package/docs/docs/cmd/spe/containertype/containertype-list.mdx

@@ -16,6 +16,14 @@ m365 spe containertype list [options]
 
 <Global />
 
+## Remarks
+
+:::info
+
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
+
+:::
+
 ## Examples
 
 Retrieves a list of Container Types created for a SharePoint Embedded Application from the tenant.

package/docs/docs/cmd/spe/containertype/containertype-remove.mdx

@@ -0,0 +1,52 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spe containertype remove
+
+Remove a specific container type
+
+## Usage
+
+```sh
+m365 spe containertype remove [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id [id]`
+: The ID of the container type. Specify either `id` or `name` but not both.
+
+`-n, --name [name]`
+: The container type name. Specify either `id` or `name` but not both.
+
+`-f, --force`
+: Force removal of the container type without confirmation.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
+
+:::
+
+## Examples
+
+Removes a container type by ID
+
+```sh
+m365 spe containertype remove --id 4ec4aefd-4fa3-0e4a-20c3-6e68389e7138
+```
+
+Removes a container type by name
+
+```sh
+m365 spe containertype remove --name 'My container type'
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -32,7 +32,6 @@ m365 spo field get [options]
 
 `-t, --title [title]`
 : The display name (case-sensitive) of the field to retrieve. Specify either `id`, `title` or `internalName`.
-```
 
 `--internalName [internalName]`
 : The internal name (case-sensitive) of the field to retrieve. Specify either `id`, `title` or `internalName`.