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

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/directoryextension/directoryextension-list.mdx

@@ -0,0 +1,135 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# graph directoryextension list
+
+Retrieves a list of directory extensions
+
+## Usage
+
+```sh
+m365 graph directoryextension list [options]
+```
+
+## Options
+
+```md definition-list
+`--appId [appId]`
+: Application (client) ID of the Entra application where the directory extensions are registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
+
+`--appObjectId [appObjectId]`
+: Object ID of the Entra application where the directory extensions are registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
+
+`--appName [appName]`
+: The name of Entra application where the directory extensions are registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
+```
+
+<Global />
+
+## Remarks
+
+When neither `appId`, `appObjectId` nor `appName` is specified, the command will return all available directory extensions including those registered for multi-tenant apps.
+
+https://learn.microsoft.com/en-us/graph/api/directoryobject-getavailableextensionproperties?view=graph-rest-1.0&tabs=http
+
+Otherwise, it will return directory extensions for a specific application.
+
+https://learn.microsoft.com/en-us/graph/api/application-list-extensionproperty?view=graph-rest-1.0&tabs=http
+
+## Examples
+
+Get all available directory extensions including those registered for multi-tenant apps
+
+```sh
+m365 graph directoryextension list
+```
+
+Get all directory extensions registered for an application specified by app id.
+
+```sh
+m365 graph directoryextension list --appId fd918e4b-c821-4efb-b50a-5eddd23afc6f
+```
+
+Get all directory extensions registered for an application specified by app object id.
+
+```sh
+m365 graph directoryextension list --appObjectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844
+```
+
+Get all directory extensions registered for an application specified by name.
+
+```sh
+m365 graph directoryextension list --appName ContosoApp
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "id": "8133c498-ad76-4a7b-90a0-675bf5adf492",
+      "deletedDateTime": null,
+      "appDisplayName": "ContosoApp",
+      "dataType": "String",
+      "isMultiValued": true,
+      "isSyncedFromOnPremises": false,
+      "name": "extension_66eac1c505384aec9e024b9e60f5e4b9_jobGroup",
+      "targetObjects": [
+        "User"
+      ]
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  appDisplayName        : ContosoApp
+  dataType              : String
+  deletedDateTime       : null
+  id                    : 8133c498-ad76-4a7b-90a0-675bf5adf492
+  isMultiValued         : true
+  isSyncedFromOnPremises: false
+  name                  : extension_66eac1c505384aec9e024b9e60f5e4b9_jobGroup
+  targetObjects         : ["User"]
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,deletedDateTime,appDisplayName,dataType,isMultiValued,isSyncedFromOnPremises,name
+  8133c498-ad76-4a7b-90a0-675bf5adf492,,ContosoApp,String,1,0,extension_66eac1c505384aec9e024b9e60f5e4b9_jobGroup
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # graph directoryextension list --debug "false" --verbose "false" --appId "66eac1c5-0538-4aec-9e02-4b9e60f5e4b9"
+
+  Date: 3/23/2025
+
+  ## extension_66eac1c505384aec9e024b9e60f5e4b9_jobGroup (8133c498-ad76-4a7b-90a0-675bf5adf492)
+
+  Property | Value
+  ---------|-------
+  id | 8133c498-ad76-4a7b-90a0-675bf5adf492
+  appDisplayName | ContosoApp
+  dataType | String
+  isMultiValued | true
+  isSyncedFromOnPremises | false
+  name | extension\_66eac1c505384aec9e024b9e60f5e4b9\_jobGroup
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- Directory extensions: https://learn.microsoft.com/graph/extensibility-overview#directory-microsoft-entra-id-extensions

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