@pnp/cli-microsoft365 10.8.0-beta.a51d886 → 10.8.0-beta.cdb5c81

package/docs/docs/cmd/cli/app/app-reconsent.mdx

@@ -0,0 +1,63 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# cli app reconsent
+
+Reconsent all permission scopes used in CLI for Microsoft 365
+
+## Usage
+
+```sh
+m365 cli app reconsent [options]
+```
+
+## Options
+
+<Global />
+
+## Remarks
+
+This command will add all missing scopes used in CLI for Microsoft 365 to your current app registration. It will only add missing scopes and won't remove any scopes that are already present in the app registration.
+
+## Examples
+
+Consent all permission scopes used in CLI for Microsoft 365 to the current app registration
+
+```sh
+m365 cli app reconsent
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  "To consent to the new scopes for your Microsoft Entra application registration, please navigate to the following URL: https://login.microsoftonline.com/f72203fd-b0a0-472d-85eb-079a117a80de/adminconsent?client_id=62b981af-59d3-4d25-8baf-6cc067a03102"
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  To consent to the new scopes for your Microsoft Entra application registration, please navigate to the following URL: https://login.microsoftonline.com/f72203fd-b0a0-472d-85eb-079a117a80de/adminconsent?client_id=62b981af-59d3-4d25-8baf-6cc067a03102
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  To consent to the new scopes for your Microsoft Entra application registration, please navigate to the following URL: https://login.microsoftonline.com/f72203fd-b0a0-472d-85eb-079a117a80de/adminconsent?client_id=62b981af-59d3-4d25-8baf-6cc067a03102
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  To consent to the new scopes for your Microsoft Entra application registration, please navigate to the following URL: https://login.microsoftonline.com/f72203fd-b0a0-472d-85eb-079a117a80de/adminconsent?client_id=62b981af-59d3-4d25-8baf-6cc067a03102
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/entra/organization/organization-list.mdx

@@ -0,0 +1,154 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# entra organization list
+
+Retrieves a list of organizations
+
+## Usage
+
+```sh
+m365 entra organization list [options]
+```
+
+## Options
+
+```md definition-list
+`-p, --properties [properties]`
+: The comma separated list of properties to be returned.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+Applications granted the `User.Read` permission are able to read only the id, displayName, and verifiedDomains properties of the organization. 
+All other properties return with null values. To read all properties, use at least `Organization.Read.All`.
+
+:::
+
+## Examples
+
+Retrieve organizations
+
+```sh
+m365 entra organization list
+```
+
+Retrieve specific info
+
+```sh
+m365 entra organization list --properties 'id,displayName,tenantType'
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "id": "e65b162c-6f87-4eb1-a24e-1b37d3504663",
+      "deletedDateTime": null,
+      "businessPhones": [
+        "4258828080"
+      ],
+      "city": null,
+      "country": null,
+      "countryLetterCode": "IE",
+      "createdDateTime": "2023-02-21T19:56:38Z",
+      "defaultUsageLocation": null,
+      "displayName": "Contoso",
+      "isMultipleDataLocationsForServicesEnabled": null,
+      "marketingNotificationEmails": [],
+      "onPremisesLastSyncDateTime": null,
+      "onPremisesSyncEnabled": null,
+      "partnerTenantType": null,
+      "postalCode": null,
+      "preferredLanguage": "en",
+      "securityComplianceNotificationMails": [],
+      "securityComplianceNotificationPhones": [],
+      "state": null,
+      "street": null,
+      "technicalNotificationMails": [
+        "john.doe@contoso.com"
+      ],
+      "tenantType": "AAD",
+      "directorySizeQuota": {
+        "used": 1400,
+        "total": 300000
+      },
+      "assignedPlans": [],
+      "onPremisesSyncStatus": [],
+      "privacyProfile": {
+        "contactEmail": "john.doe@contoso.com",
+        "statementUrl": ""
+      },
+      "provisionedPlans": [],
+      "verifiedDomains": [
+        {
+          "capabilities": "Email, OfficeCommunicationsOnline",
+          "isDefault": true,
+          "isInitial": true,
+          "name": "contoso.onmicrosoft.com",
+          "type": "Managed"
+        },
+        {
+          "capabilities": "Email, OfficeCommunicationsOnline, MoeraDomain",
+          "isDefault": false,
+          "isInitial": false,
+          "name": "contoso2.onmicrosoft.com",
+          "type": "Managed"
+        }
+      ]
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  displayName: Contoso
+  id         : e65b162c-6f87-4eb1-a24e-1b37d3504663
+  tenantType : AAD
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,deletedDateTime,city,country,countryLetterCode,createdDateTime,defaultUsageLocation,displayName,isMultipleDataLocationsForServicesEnabled,onPremisesLastSyncDateTime,onPremisesSyncEnabled,partnerTenantType,postalCode,preferredLanguage,state,street,tenantType
+  e65b162c-6f87-4eb1-a24e-1b37d3504663,,,,IE,2023-02-21T19:56:38Z,,Contoso,,,,,,en,,,AAD
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # entra organization list --debug "false" --verbose "false"
+
+  Date: 4/18/2025
+
+  ## Contoso (e65b162c-6f87-4eb1-a24e-1b37d3504663)
+
+  Property | Value
+  ---------|-------
+  id | e65b162c-6f87-4eb1-a24e-1b37d3504663
+  countryLetterCode | IE
+  createdDateTime | 2023-02-21T19:56:38Z
+  displayName | Contoso
+  preferredLanguage | en
+  tenantType | AAD
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- Organization: https://learn.microsoft.com/graph/api/organization-list

package/docs/docs/cmd/graph/openextension/openextension-set.mdx

@@ -0,0 +1,97 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# graph openextension set
+
+Updates an open extension for a resource
+
+## Usage
+
+```sh
+m365 graph openextension set [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --name <name>`
+: The name of the open extension.
+
+`-i, --resourceId <resourceId>`
+: The Id of the resource for which to update the open extension.
+
+`-t, --resourceType <resourceType>`
+: The type of resource. Allowed values are `user`, `group`, `device`, `organization`.
+
+`-k, --keepUnchangedProperties`
+: Keeps unspecified properties. Without this flag, any property that is not updated will be removed from the extension.
+```
+
+<Global />
+
+## Remarks
+
+This command allows using unknown options to update custom data of the open extension.
+
+When updating an open extension to a user, it's possible to use the UPN as the resourceId.
+
+:::warning[Escaping JSON in PowerShell]
+
+When updating open extensions 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.
+
+:::
+
+:::info
+
+If a property of the open extension is not specified, the property is removed from the open extension.
+
+If a property of the open extension is not specified and `keepUnchangedProperties` is specified, the property will be kept in the open extension.
+
+:::
+
+## Examples
+
+Updates an open extension for a user specified by id
+
+```sh
+m365 graph openextension set --userId eb77fbcf-6fe8-458b-985d-1747284793bc --name 'com.contoso.roamingSettings' --resourceType user --theme dark --color red --language English
+```
+
+Updates an open extension for a user specified by UPN
+
+```sh
+m365 graph openextension set --userName john.doe@contoso.com --name 'com.contoso.roamingSettings' --resourceType user --theme dark --color red --language English
+```
+
+Updates an open extension for a group specified by id, one of the property represents a JSON object
+
+```sh
+m365 graph openextension set --resourceId c956e711-f074-40c3-8431-fbd69bb67d9c --name 'com.contoso.roamingSettings' --resourceType group --settings '{"theme": "dark", "color": "red" }'
+```
+
+Updates an open extension, but keeps the properties that are not specified
+
+```sh
+m365 graph openextension set --userId eb77fbcf-6fe8-458b-985d-1747284793bc --name 'com.contoso.roamingSettings' --resourceType user --color red --keepUnchangedProperties
+```
+
+Updates an open extension, but removes the properties that are not specified
+
+```sh
+m365 graph openextension set --userId eb77fbcf-6fe8-458b-985d-1747284793bc --name 'com.contoso.roamingSettings' --resourceType user --color red
+```
+
+Clears the value of the property
+
+```sh
+m365 graph openextension set --userId eb77fbcf-6fe8-458b-985d-1747284793bc --name 'com.contoso.roamingSettings' --resourceType user --theme ""
+```
+
+## Response
+
+The command won't return a response on success.
+
+## More information
+
+- Open extensions: https://learn.microsoft.com/graph/extensibility-overview?tabs=http#open-extensions

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

@@ -1,6 +1,4 @@
 import Global from '/docs/cmd/_global.mdx';
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
 
 # spe container activate
 

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-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.