@pnp/cli-microsoft365 10.8.0-beta.cdb5c81 → 10.9.0-beta.3261443

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

@@ -16,54 +16,56 @@ m365 entra m365group list [options]
 
 ```md definition-list
 `-d, --displayName [displayName]`
-: Retrieve only groups with displayName starting with the specified value
+: Retrieve only groups with displayName starting with the specified value.
 
 `-m, --mailNickname [displayName]`
-: Retrieve only groups with mailNickname starting with the specified value
+: Retrieve only groups with mailNickname starting with the specified value.
 
 `--includeSiteUrl`
-: Set to retrieve the site URL for each group
+: (deprecated. Use option `withSiteUrl` instead) Set to retrieve the site URL for each group.
+
+`--withSiteUrl`
+: Set to retrieve the site URL for each group.
 
 `--orphaned`
-: Set to only retrieve groups without owners
+: Set to only retrieve groups without owners.
 ```
 
 <Global />
 
 ## Remarks
 
-Using the `--includeSiteUrl` option, you can retrieve the URL of the site associated with the particular Microsoft 365 Group. If you however retrieve too many groups and will try to get their site URLs, you will most likely get an error as the command will get throttled, issuing too many requests, too frequently. If you get an error, consider narrowing down the result set using the `--displayName` and `--mailNickname` filters.
+Using the `--withSiteUrl` option, you can retrieve the URL of the site associated with the particular Microsoft 365 Group. If you however retrieve too many groups and will try to get their site URLs, you will most likely get an error as the command will get throttled, issuing too many requests, too frequently. If you get an error, consider narrowing down the result set using the `--displayName` and `--mailNickname` filters.
 
 Using the `--orphaned` option, you can retrieve Microsoft 365 Groups without owners.
 
 ## Examples
 
-List all Microsoft 365 Groups in the tenant
+List all Microsoft 365 Groups in the tenant.
 
 ```sh
 m365 entra m365group list
 ```
 
-List Microsoft 365 Groups with display name starting with _Project_
+List Microsoft 365 Groups with display name starting with _Project_.
 
 ```sh
 m365 entra m365group list --displayName Project
 ```
 
-List Microsoft 365 Groups mail nick name starting with _team_
+List Microsoft 365 Groups mail nick name starting with _team_.
 
 ```sh
 m365 entra m365group list --mailNickname team
 ```
 
-List Microsoft 365 Groups with display name starting with _Project_ including
-the URL of the corresponding SharePoint site
+List Microsoft 365 Groups with display name starting with _Project_ including the URL of the corresponding SharePoint site.
 
 ```sh
-m365 entra m365group list --displayName Project --includeSiteUrl
+m365 entra m365group list --displayName Project --withSiteUrl
 ```
 
-List Microsoft 365 Groups without owners
+List Microsoft 365 Groups without owners.
 
 ```sh
 m365 entra m365group list --orphaned

package/docs/docs/cmd/entra/pim/pim-role-assignment-eligibility-list.mdx

@@ -28,6 +28,9 @@ m365 entra pim role assignment eligibility list [options]
 : Display name of the group for which to list eligible roles. Specify either `userId`, `userName`, `groupId` or `groupName`. If not specified, all eligible roles will be listed.
 
 `--includePrincipalDetails`
+: (deprecated. Use option `withPrincipalDetails` instead) An optional flag to include details of the principals that were eligible for a role.
+
+`--withPrincipalDetails`
 : An optional flag to include details of the principals that were eligible for a role.
 ```
 
@@ -50,7 +53,7 @@ m365 entra pim role assignment eligibility list --userId '@meID'
 Get a list of eligible roles for any user with principal details.
 
 ```sh
-m365 entra pim role assignment eligibility list --includePrincipalDetails
+m365 entra pim role assignment eligibility list --withPrincipalDetails
 ```
 
 ## Response
@@ -121,9 +124,9 @@ m365 entra pim role assignment eligibility list --includePrincipalDetails
   </TabItem>
 </Tabs>
 
-### `includePrincipalDetails` response
+### `withPrincipalDetails` response
 
-When we make use of the option `includePrincipalDetails` the response will differ. 
+When we make use of the option `withPrincipalDetails` the response will differ. 
 
 <Tabs>
   <TabItem value="JSON">
@@ -183,7 +186,7 @@ When we make use of the option `includePrincipalDetails` the response will diffe
   <TabItem value="Markdown">
 
   ```md
-  # entra pim role assignment eligibility list --includePrincipalDetails "true"
+  # entra pim role assignment eligibility list --withPrincipalDetails "true"
 
   Date: 4/8/2024
 

package/docs/docs/cmd/entra/pim/pim-role-assignment-list.mdx

@@ -31,7 +31,10 @@ m365 entra pim role assignment list [options]
 : An optional ISO 8601 formatted date filter to search from.
 
 `--includePrincipalDetails`
-: An optional flag to include details of the principals that were assigned a role
+: (deprecated. Use option `withPrincipalDetails` instead) An optional flag to include details of the principals that were assigned a role.
+
+`--withPrincipalDetails`
+: An optional flag to include details of the principals that were assigned a role.
 ```
 
 <Global />
@@ -50,7 +53,7 @@ Get a list of Entra role assignments for the current user.
 m365 entra pim role assignment list --userId '@meID'
 ```
 
-Get a list of Entra role assignments since the first of January 2024
+Get a list of Entra role assignments since the first of January 2024.
 
 ```sh
 m365 entra pim role assignment list --startDateTime 2024-01-01T00:00:00Z
@@ -59,7 +62,7 @@ m365 entra pim role assignment list --startDateTime 2024-01-01T00:00:00Z
 Get a list of Entra role assignments with principal details.
 
 ```sh
-m365 entra pim role assignment list --includePrincipalDetails
+m365 entra pim role assignment list --withPrincipalDetails
 ```
 
 ## Response
@@ -135,9 +138,9 @@ m365 entra pim role assignment list --includePrincipalDetails
   </TabItem>
 </Tabs>
 
-### `includePrincipalDetails` response
+### `withPrincipalDetails` response
 
-When we make use of the option `includePrincipalDetails` the response will differ. 
+When we make use of the option `withPrincipalDetails` the response will differ. 
 
 <Tabs>
   <TabItem value="JSON">
@@ -201,7 +204,7 @@ When we make use of the option `includePrincipalDetails` the response will diffe
   <TabItem value="Markdown">
 
   ```md
-  # entra pim role assignment list --includePrincipalDetails "true"
+  # entra pim role assignment list --withPrincipalDetails "true"
 
   Date: 3/31/2024
 

package/docs/docs/cmd/entra/pim/pim-role-request-list.mdx

@@ -34,6 +34,9 @@ m365 entra pim role request list [options]
 : An optional value to filter the list of requests. Allowed values are: `Canceled`, `Denied`, `Failed`, `Granted`, `PendingAdminDecision`, `PendingApproval`, `PendingProvisioning`, `PendingScheduleCreation`, `Provisioned`, `Revoked`, and `ScheduleCreated`.
 
 `--includePrincipalDetails`
+: (deprecated. Use option `withPrincipalDetails` instead) An optional flag to include details of the principals that were assigned a role.
+
+`--withPrincipalDetails`
 : An optional flag to include details of the principals that were assigned a role.
 ```
 
@@ -62,7 +65,7 @@ m365 entra pim role request list --createdDateTime 2024-01-01T00:00:00Z
 Get a list of PIM requests with principal details.
 
 ```sh
-m365 entra pim role request list --includePrincipalDetails
+m365 entra pim role request list --withPrincipalDetails
 ```
 
 Get a list of PIM requests with pending approvals.
@@ -158,9 +161,9 @@ m365 entra pim role request list --status PendingApproval
   </TabItem>
 </Tabs>
 
-### `includePrincipalDetails` response
+### `withPrincipalDetails` response
 
-When we make use of the option `includePrincipalDetails` the response will differ. 
+When we make use of the option `withPrincipalDetails` the response will differ. 
 
 <Tabs>
   <TabItem value="JSON">
@@ -238,7 +241,7 @@ When we make use of the option `includePrincipalDetails` the response will diffe
   <TabItem value="Markdown">
 
   ```md
-  # entra pim role request list --includePrincipalDetails "true"
+  # entra pim role request list --withPrincipalDetails "true"
 
   Date: 5/30/2024
 

package/docs/docs/cmd/flow/flow-list.mdx

@@ -22,6 +22,9 @@ m365 flow list [options]
 : List a specific type of flows. Valid values: `ownedByMe`, `personal`, `sharedWithMe`, `all`. Defaults to `ownedByMe`. Don't specify this option when using asAdmin.
 
 `--includeSolutions`
+: (deprecated. Use option `withSolutions` instead) Include flows from solutions.
+
+`--withSolutions`
 : Include flows from solutions.
 
 `--asAdmin`
@@ -49,28 +52,28 @@ When you specify a value for `sharingStatus`, consider the following:
 
 ## Examples
 
-List all your flows in the given environment
+List all your flows in the given environment.
 
 ```sh
 m365 flow list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5
 ```
 
-List all flows in the given environment
+List all flows in the given environment.
 
 ```sh
 m365 flow list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --asAdmin
 ```
 
-List all flows that are shared with the current user
+List all flows that are shared with the current user.
 
 ```sh
 m365 flow list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --sharingStatus sharedWithMe
 ```
 
-List all personal flows and include flows from solutions
+List all personal flows and include flows from solutions.
 
 ```sh
-m365 flow list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --sharingStatus personal --includeSolutions
+m365 flow list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --sharingStatus personal --withSolutions
 ```
 
 ## Response

package/docs/docs/cmd/flow/run/run-get.mdx

@@ -22,7 +22,7 @@ m365 flow run get [options]
 : The name of the Power Automate flow for which to retrieve information.
 
 `-e, --environmentName <environmentName>`
-: The name of the environment where the flow is located
+: The name of the environment where the flow is located.
 
 `--includeTriggerInformation`
 : (deprecated. Use option `withTrigger` instead) If specified, include information about the trigger details.

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/subscription/subscription-add.mdx

@@ -40,13 +40,16 @@ m365 graph subscription add [options]
 : The latest version of TLS that the notification endpoint supports. Allowed values are `v1_0`, `v1_1`, `v1_2`, `v1_3`. Default is `v1_2`.
 
 `--includeResourceData`
+: (deprecated. Use option `withResourceData` instead) When set, the change notifications will include the changed resource data.
+
+`--withResourceData`
 : When set, the change notifications will include the changed resource data.
 
 `--encryptionCertificate [encryptionCertificate]`
-: A base64-encoded representation of a certificate with a public key used to encrypt resource data in change notifications. Required when using `includeResourceData`.
+: A base64-encoded representation of a certificate with a public key used to encrypt resource data in change notifications. Required when using `withResourceData`.
 
 `--encryptionCertificateId [encryptionCertificateId]`
-: A custom app-provided identifier to help identify the certificate needed to decrypt resource data. Required when using `includeResourceData`.
+: A custom app-provided identifier to help identify the certificate needed to decrypt resource data. Required when using `withResourceData`.
 ```
 
 <Global />
@@ -83,7 +86,7 @@ m365 graph subscription add --resource "me/mailFolders('Inbox')/messages" --chan
 Create a subscription on multiple change types and include resource data
 
 ```sh
-m365 graph subscription add --resource "me/messages" --changeTypes "updated,deleted" --includeResourceData --encryptionCertificate 'Q0xJIGZvciBNaWNyb3NvZnQgMzY1' --encryptionCertificateId 'myCert' --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient" --expirationDateTime "2016-11-20T18:23:45.935Z" --clientState "secretClientState"
+m365 graph subscription add --resource "me/messages" --changeTypes "updated,deleted" --withResourceData --encryptionCertificate 'Q0xJIGZvciBNaWNyb3NvZnQgMzY1' --encryptionCertificateId 'myCert' --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient" --expirationDateTime "2016-11-20T18:23:45.935Z" --clientState "secretClientState"
 ```
 
 Create a subscription using the maximum allowed expiration for Group resources

package/docs/docs/cmd/pp/solution/solution-publisher-list.mdx

@@ -16,10 +16,13 @@ m365 pp solution publisher list [options]
 
 ```md definition-list
 `-e, --environmentName <environmentName>`
-: The name of the environment
+: The name of the environment.
 
 `--includeMicrosoftPublishers`
-: Include the Microsoft Publishers
+: (deprecated. Use option `withMicrosoftPublishers` instead) Include the Microsoft Publishers.
+
+`--withMicrosoftPublishers`
+: Include the Microsoft Publishers.
 
 `--asAdmin`
 : Run the command as admin for environments you do not have explicitly assigned permissions to.
@@ -29,13 +32,13 @@ m365 pp solution publisher list [options]
 
 ## Examples
 
-List all publishers in a specific environment
+List all publishers in a specific environment.
 
 ```sh
 m365 pp solution publisher list --environmentName "Default-2ca3eaa5-140f-4175-8261-3272edf9f339"
 ```
 
-List all publishers in a specific environment as Admin
+List all publishers in a specific environment as Admin.
 
 ```sh
 m365 pp solution publisher list --environmentName "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --asAdmin

package/docs/docs/cmd/purview/threatassessment/threatassessment-get.mdx

@@ -19,6 +19,9 @@ m365 purview threatassessment get [options]
 : The Id of the threat assessment.
 
 `--includeResults`
+: (deprecated. Use option `withResults` instead) Include the threat assessment results.
+
+`--withResults`
 : Include the threat assessment results.
 ```
 
@@ -35,7 +38,7 @@ m365 purview threatassessment get --id c37d695e-d581-4ae9-82a0-9364eba4291e
 Get a threat assessment including results.
 
 ```sh
-m365 purview threatassessment get --id c37d695e-d581-4ae9-82a0-9364eba4291e --includeResults
+m365 purview threatassessment get --id c37d695e-d581-4ae9-82a0-9364eba4291e --withResults
 ```
 
 ## Response
@@ -118,9 +121,9 @@ m365 purview threatassessment get --id c37d695e-d581-4ae9-82a0-9364eba4291e --in
   </TabItem>
 </Tabs>
 
-### `includeResults` response
+### `withResults` response
 
-When we make use of the option `includeResults` the response will differ. 
+When we make use of the option `withResults` the response will differ. 
 
 <Tabs>
   <TabItem value="JSON">
@@ -184,7 +187,7 @@ When we make use of the option `includeResults` the response will differ.
   <TabItem value="Markdown">
 
   ```md
-  # purview threatassessment get --id "8aaba0ac-ec4d-4e62-5774-08db16c68731" --includeResults "true"
+  # purview threatassessment get --id "8aaba0ac-ec4d-4e62-5774-08db16c68731" --withResults "true"
 
   Date: 25/02/2023
 

package/docs/docs/cmd/spo/file/file-move.mdx

@@ -34,6 +34,9 @@ m365 spo file move [options]
 : Behavior when a file or folder with the same name is already present at the destination. Allowed values: `fail`, `replace`, `rename`. Defaults to `fail`.
 
 `--includeItemPermissions`
+: (deprecated. Use option `withItemPermissions` instead) Ensure that item-level permissions are preserved during the move.
+
+`--withItemPermissions`
 : Ensure that item-level permissions are preserved during the move.
 
 `--bypassSharedLock`
@@ -75,7 +78,7 @@ m365 spo file move --webUrl https://contoso.sharepoint.com/sites/project-x --sou
 Move a file referenced by its ID to another document library and retain item-level permissions.
 
 ```sh
-m365 spo file move --webUrl https://contoso.sharepoint.com/sites/project-x --sourceId b8cc341b-9c11-4f2d-aa2b-0ce9c18bcba2 --targetUrl "/sites/project-x/My Documents" --includeItemPermissions
+m365 spo file move --webUrl https://contoso.sharepoint.com/sites/project-x --sourceId b8cc341b-9c11-4f2d-aa2b-0ce9c18bcba2 --targetUrl "/sites/project-x/My Documents" --withItemPermissions
 ```
 
 ## Response

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

@@ -25,6 +25,9 @@ m365 spo hubsite get [options]
 : URL of the hub site. Specify either `id`, `title`, or `url` but not multiple.
 
 `--includeAssociatedSites`
+: (deprecated. Use option `withAssociatedSites` instead) Include the associated sites in the result (only in JSON output).
+
+`--withAssociatedSites`
 : Include the associated sites in the result (only in JSON output)
 ```
 
@@ -53,7 +56,7 @@ m365 spo hubsite get --url 'https://contoso.sharepoint.com/sites/HubSite'
 Get information about the hub site with specific ID, including its associated sites. Associated site info is only shown in JSON output.
 
 ```sh
-m365 spo hubsite get --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a --includeAssociatedSites --output json
+m365 spo hubsite get --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a --withAssociatedSites --output json
 ```
 
 ## Response
@@ -147,9 +150,9 @@ m365 spo hubsite get --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a --includeAssociat
   </TabItem>
 </Tabs>
 
-### `includeAssociatedSites` response
+### `withAssociatedSites` response
 
-When we make use of the option `includeAssociatedSites` the response will differ. This command can only be executed using --output json or an error will be thrown.
+When we make use of the option `withAssociatedSites` the response will differ. This command can only be executed using --output json or an error will be thrown.
 
 <Tabs>
   <TabItem value="JSON">

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

@@ -16,6 +16,9 @@ m365 spo hubsite list [options]
 
 ```md definition-list
 `-i, --includeAssociatedSites`
+: (deprecated. Use option `withAssociatedSites` instead) Include the associated sites in the result (only in JSON output).
+
+`--withAssociatedSites`
 : Include the associated sites in the result (only in JSON output).
 ```
 
@@ -36,7 +39,7 @@ m365 spo hubsite list
 List hub sites, including their associated sites, in the current tenant. Associated site info is only shown in JSON output.
 
 ```sh
-m365 spo hubsite list --includeAssociatedSites --output json
+m365 spo hubsite list --withAssociatedSites --output json
 ```
 
 ## Response
@@ -119,9 +122,9 @@ m365 spo hubsite list --includeAssociatedSites --output json
   </TabItem>
 </Tabs>
 
-### `includeAssociatedSites` response
+### `withAssociatedSites` response
 
-When we make use of the option `includeAssociatedSites` the response will differ. 
+When we make use of the option `withAssociatedSites` the response will differ. 
 
 <Tabs>
   <TabItem value="JSON">
@@ -176,7 +179,7 @@ When we make use of the option `includeAssociatedSites` the response will differ
   <TabItem value="Markdown">
 
   ```md
-  # spo hubsite list --includeAssociatedSites "true"
+  # spo hubsite list --withAssociatedSites "true"
 
   Date: 2/20/2023
 

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

@@ -127,7 +127,7 @@ m365 spo list add [options]
 : Boolean value that specifies whether the list is hidden. Valid values are `true`, `false`.
 
 `--includedInMyFilesScope [includedInMyFilesScope]`
-: Specifies whether this list is accessible to an app principal that has been granted an OAuth scope that contains the string “myfiles” by a case-insensitive comparison when the current user is a site collection administrator of the personal site that contains the list.
+: Specifies whether this list is accessible to an app principal that has been granted an OAuth scope that contains the string "myfiles" by a case-insensitive comparison when the current user is a site collection administrator of the personal site that contains the list.
 
 `--irmEnabled [irmEnabled]`
 : Gets or sets a Boolean value that specifies whether Information Rights Management (IRM) is enabled for the list.

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

@@ -19,13 +19,16 @@ m365 spo list get [options]
 : URL of the site where the list to retrieve is located.
 
 `-i, --id [id]`
-: ID of the list to retrieve information for. Specify either `id`, `title`, or `url` but not multiple.
+: ID of the list to retrieve information for. Specify either `id`, `title`,`url` or `default` but not multiple.
 
 `-t, --title [title]`
-: Title of the list to retrieve information for. Specify either `id`, `title`, or `url` but not multiple.
+: Title of the list to retrieve information for. Specify either `id`, `title`,`url` or `default` but not multiple.
 
 `--url [url]`
-: Server- or site-relative URL of the list. Specify either `id`, `title`, or `url` but not multiple.
+: Server- or site-relative URL of the list. Specify either `id`, `title`,`url` or `default` but not multiple.
+
+`--default`
+: Set to retrieve the default list from the site. Specify either `id`, `title`, `url`, or `default` but not multiple.  
 
 `-p, --properties [properties]`
 : Comma-separated list of properties to retrieve from the list. Will retrieve all properties possible from default response, if not specified.
@@ -42,6 +45,12 @@ When the `properties` option includes values with a `/`, for example: `ListItemA
 
 ## Examples
 
+Get the default document library located in the specified site.
+
+```sh
+m365 spo list get --webUrl https://contoso.sharepoint.com/sites/project-x --default  
+```
+
 Get information about a list with specified ID located in the specified site.
 
 ```sh

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

@@ -14,7 +14,7 @@ m365 spo list set [options]
 
 ```md definition-list
 `-u, --webUrl <webUrl>`
-: URL of the site
+: URL of the site.
 
 `--id [id]`
 : ID of the list. Specify either `id`, `title`, or `url` but not multiple.
@@ -128,7 +128,7 @@ m365 spo list set [options]
 : Boolean value that specifies whether the list is hidden. Valid values are `true`, `false`.
 
 `--includedInMyFilesScope [includedInMyFilesScope]`
-: Specifies whether this list is accessible to an app principal that has been granted an OAuth scope that contains the string “myfiles” by a case-insensitive comparison when the current user is a site collection administrator of the personal site that contains the list.
+: Specifies whether this list is accessible to an app principal that has been granted an OAuth scope that contains the string "myfiles" by a case-insensitive comparison when the current user is a site collection administrator of the personal site that contains the list.
 
 `--irmEnabled [irmEnabled]`
 : Gets or sets a Boolean value that specifies whether Information Rights Management (IRM) is enabled for the list.