@pnp/cli-microsoft365 10.3.0-beta.f5e6f85 → 10.4.0-beta.17b3a55

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

@@ -0,0 +1,164 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# entra rolepermission list
+
+Lists all Microsoft Entra ID role permissions
+
+## Usage
+
+```sh
+m365 entra rolepermission list [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --resourceNamespace [resourceNamespace]`
+: The namespace of the resource for which to retrieve role permissions.
+
+`-p, --privileged`
+: Retrieve only sensitive role permissions.
+```
+
+<Global />
+
+## Remarks
+
+:::warning
+
+The command is based on an API that is currently in preview and is subject to change once the API reached general availability.
+
+:::
+
+Use the `m365 entra resourcenamespace list` command to get a list of available resource namespaces.
+
+## Examples
+
+Get a list of role permissions
+
+```sh
+m365 entra rolepermission list --resourceNamespace 'microsoft.directory'
+```
+
+Get a list of sensitive role permissions
+
+```sh
+m365 entra rolepermission list --resourceNamespace 'microsoft.directory' --privileged
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "actionVerb": null,
+      "description": "Create and delete access reviews, and read and update all properties of access reviews in Microsoft Entra ID",
+      "id": "microsoft.directory-accessReviews-allProperties-allTasks",
+      "isPrivileged": false,
+      "name": "microsoft.directory/accessReviews/allProperties/allTasks",
+      "resourceScopeId": null
+    },
+    {
+      "actionVerb": "GET",
+      "description": "Read all properties of access reviews",
+      "id": "microsoft.directory-accessReviews-allProperties-read-get",
+      "isPrivileged": false,
+      "name": "microsoft.directory/accessReviews/allProperties/read",
+      "resourceScopeId": null
+    },
+    {
+      "actionVerb": null,
+      "description": "Manage access reviews of application role assignments in Microsoft Entra ID",
+      "id": "microsoft.directory-accessReviews-definitions.applications-allProperties-allTasks",
+      "isPrivileged": false,
+      "name": "microsoft.directory/accessReviews/definitions.applications/allProperties/allTasks",
+      "resourceScopeId": null
+    },
+    {
+      "actionVerb": "GET",
+      "description": "Read all properties of access reviews of application role assignments in Microsoft Entra ID",
+      "id": "microsoft.directory-accessReviews-definitions.applications-allProperties-read-get",
+      "isPrivileged": false,
+      "name": "microsoft.directory/accessReviews/definitions.applications/allProperties/read",
+      "resourceScopeId": null
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  id                                                                                      name                                                                                     actionVerb  isPrivileged
+  --------------------------------------------------------------------------------------  ---------------------------------------------------------------------------------------  ----------  ------------
+  microsoft.directory-accessReviews-allProperties-allTasks                                microsoft.directory/accessReviews/allProperties/allTasks                                 null        false
+  microsoft.directory-accessReviews-allProperties-read-get                                microsoft.directory/accessReviews/allProperties/read                                     GET         false
+  microsoft.directory-accessReviews-definitions.applications-allProperties-allTasks       microsoft.directory/accessReviews/definitions.applications/allProperties/allTasks        null        false
+  microsoft.directory-accessReviews-definitions.applications-allProperties-read-get       microsoft.directory/accessReviews/definitions.applications/allProperties/read            GET         false
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  actionVerb,description,id,isPrivileged,name,resourceScopeId
+  ,"Create and delete access reviews, and read and update all properties of access reviews in Microsoft Entra ID",microsoft.directory-accessReviews-allProperties-allTasks,0,microsoft.directory/accessReviews/allProperties/allTasks,
+  GET,Read all properties of access reviews,microsoft.directory-accessReviews-allProperties-read-get,0,microsoft.directory/accessReviews/allProperties/read,
+  ,Manage access reviews of application role assignments in Microsoft Entra ID,microsoft.directory-accessReviews-definitions.applications-allProperties-allTasks,0,microsoft.directory/accessReviews/definitions.applications/allProperties/allTasks,
+  GET,Read all properties of access reviews of application role assignments in Microsoft Entra ID,microsoft.directory-accessReviews-definitions.applications-allProperties-read-get,0,microsoft.directory/accessReviews/definitions.applications/allProperties/read,
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # entra rolepermission list --resourceNamespace "microsoft.directory"
+
+  Date: 1/16/2025
+
+  ## microsoft.directory/accessReviews/allProperties/allTasks (microsoft.directory-accessReviews-allProperties-allTasks)
+
+  Property | Value
+  ---------|-------
+  description | Create and delete access reviews, and read and update all properties of access reviews in Microsoft Entra ID
+  id | microsoft.directory-accessReviews-allProperties-allTasks
+  isPrivileged | false
+  name | microsoft.directory/accessReviews/allProperties/allTasks
+
+  ## microsoft.directory/accessReviews/allProperties/read (microsoft.directory-accessReviews-allProperties-read-get)
+
+  Property | Value
+  ---------|-------
+  actionVerb | GET
+  description | Read all properties of access reviews
+  id | microsoft.directory-accessReviews-allProperties-read-get
+  isPrivileged | false
+  name | microsoft.directory/accessReviews/allProperties/read
+
+  ## microsoft.directory/accessReviews/definitions.applications/allProperties/allTasks (microsoft.directory-accessReviews-definitions.applications-allProperties-allTasks)
+
+  Property | Value
+  ---------|-------
+  description | Manage access reviews of application role assignments in Microsoft Entra ID
+  id | microsoft.directory-accessReviews-definitions.applications-allProperties-allTasks
+  isPrivileged | false
+  name | microsoft.directory/accessReviews/definitions.applications/allProperties/allTasks
+
+  ## microsoft.directory/accessReviews/definitions.applications/allProperties/read (microsoft.directory-accessReviews-definitions.applications-allProperties-read-get)
+
+  Property | Value
+  ---------|-------
+  actionVerb | GET
+  description | Read all properties of access reviews of application role assignments in Microsoft Entra ID
+  id | microsoft.directory-accessReviews-definitions.applications-allProperties-read-get
+  isPrivileged | false
+  name | microsoft.directory/accessReviews/definitions.applications/allProperties/read
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/outlook/mailbox/mailbox-settings-get.mdx

@@ -0,0 +1,131 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# outlook mailbox settings get
+
+Get the user's mailbox settings
+
+## Usage
+
+```sh
+m365 outlook mailbox settings get [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --userId [userId]`
+: The ID of the Microsoft Entra user for which you want to get mailbox settings. Specify either `userId` or `userName`, but not both. This option is required when using application permissions.
+
+`-n, --userName [userName]`
+: The UPN of the Microsoft Entra user for which you want to get mailbox settings. Specify either `userId` or `userName`, but not both. This option is required when using application permissions.
+```
+
+<Global />
+
+## Examples
+
+Get mailbox settings of the signed-in user
+
+```sh
+m365 outlook mailbox settings get
+```
+
+Get mailbox settings of a user specified by id
+
+```sh
+m365 outlook mailbox settings get --userId 1caf7dcd-7e83-4c3a-94f7-932a1299c844
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "archiveFolder": "AQMkAGRlM2Y5YTkzLWI2NzAtNDczOS05YWMyLTJhZGY2MGExMGU0MgAuAAADSG3wPE27kUeySjmT5eRT8QEAfJKVL07sbkmIfHqjbDnRgQAAAgEMAAAA",
+    "timeZone": "Central Europe Standard Time",
+    "delegateMeetingMessageDeliveryOptions": "sendToDelegateOnly",
+    "dateFormat": "dd.MM.yyyy",
+    "timeFormat": "H:mm",
+    "userPurpose": "user",
+    "automaticRepliesSetting": {
+      "status": "disabled",
+      "externalAudience": "all",
+      "internalReplyMessage": "On vacation. Will be back.",
+      "externalReplyMessage": "Vacation",
+      "scheduledStartDateTime": {
+        "dateTime": "2025-01-20T08:00:00.0000000",
+        "timeZone": "UTC"
+      },
+      "scheduledEndDateTime": {
+        "dateTime": "2025-01-25T18:00:00.0000000",
+        "timeZone": "UTC"
+      }
+    },
+    "language": {
+      "locale": "en-US",
+      "displayName": "English (United States)"
+    },
+    "workingHours": {
+      "daysOfWeek": [
+        "monday",
+        "tuesday",
+        "wednesday",
+        "thursday",
+        "friday"
+      ],
+      "startTime": "08:00:00.0000000",
+      "endTime": "16:30:00.0000000",
+      "timeZone": {
+        "name": "Central Europe Standard Time"
+      }
+    }
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  archiveFolder                        : AQMkAGRlM2Y5YTkzLWI2NzAtNDczOS05YWMyLTJhZGY2MGExMGU0MgAuAAADSG3wPE27kUeySjmT5eRT8QEAfJKVL07sbkmIfHqjbDnRgQAAAgEMAAAA
+  automaticRepliesSetting              : {"status":"disabled","externalAudience":"all","internalReplyMessage":"","externalReplyMessage":"","scheduledStartDateTime":{"dateTime":"2025-01-20T08:00:00.0000000","timeZone":"UTC"},"scheduledEndDateTime":{"dateTime":"2025-01-25T18:00:00.0000000","timeZone":"UTC"}}
+  dateFormat                           : dd.MM.yyyy
+  delegateMeetingMessageDeliveryOptions: sendToDelegateOnly
+  language                             : {"locale":"en-US","displayName":"English (United States)"}
+  timeFormat                           : H:mm
+  timeZone                             : Central Europe Standard Time
+  userPurpose                          : user
+  workingHours                         : {"daysOfWeek":["monday","tuesday","wednesday","thursday","friday"],"startTime":"08:00:00.0000000","endTime":"16:30:00.0000000","timeZone":{"name":"Central Europe Standard Time"}}
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  archiveFolder,timeZone,delegateMeetingMessageDeliveryOptions,dateFormat,timeFormat,userPurpose
+  AQMkAGRlM2Y5YTkzLWI2NzAtNDczOS05YWMyLTJhZGY2MGExMGU0MgAuAAADSG3wPE27kUeySjmT5eRT8QEAfJKVL07sbkmIfHqjbDnRgQAAAgEMAAAA,Central Europe Standard Time,sendToDelegateOnly,dd.MM.yyyy,H:mm,user
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # outlook mailbox settings get
+
+  Date: 1/17/2025
+
+  Property | Value
+  ---------|-------
+  archiveFolder | AQMkAGRlM2Y5YTkzLWI2NzAtNDczOS05YWMyLTJhZGY2MGExMGU0MgAuAAADSG3wPE27kUeySjmT5eRT8QEAfJKVL07sbkmIfHqjbDnRgQAAAgEMAAAA
+  timeZone | Central Europe Standard Time
+  delegateMeetingMessageDeliveryOptions | sendToDelegateOnly
+  dateFormat | dd.MM.yyyy
+  timeFormat | H:mm
+  userPurpose | user
+  ```
+
+  </TabItem>
+</Tabs>

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

@@ -0,0 +1,34 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spe container activate
+
+Activates a container
+
+## Usage
+
+```sh
+m365 spe container activate [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id <id>`
+: The Id of the container instance.
+```
+
+<Global />
+
+## Examples
+
+Activates a container.
+
+```sh
+m365 spe container activate --id "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z"
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/list/list-defaultvalue-clear.mdx

@@ -0,0 +1,62 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo list defaultvalue clear
+
+Clears default column values for a specific document library
+
+## Usage
+
+```sh
+m365 spo list defaultvalue clear [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: URL of the site where the list is located.
+
+`-i, --listId [listId]`
+: ID of the list. Specify either `listTitle`, `listId`, or `listUrl`.
+
+`-t, --listTitle [listTitle]`
+: Title of the list. Specify either `listTitle`, `listId`, or `listUrl`.
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId`, or `listUrl`.
+
+`--fieldName [fieldName]`
+: Internal name of the field to clear over the entire list. Specify either `fieldName` or `folderUrl`, but not both.
+
+`--folderUrl [folderUrl]`
+: Clear all fields of a specific folder by specifying a server- or site-relative URL. Specify either `fieldName` or `folderUrl`, but not both.
+
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Examples
+
+Remove all default column values from a library
+
+```sh
+m365 spo list defaultvalue clear --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle Logos
+```
+
+Clear a field from all folders of a library
+
+```sh
+m365 spo list defaultvalue clear --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle Logos --field Company
+```
+
+Clear all fields from a specific folder in a library
+
+```sh
+m365 spo list defaultvalue clear --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle Logos --folderUrl "/sites/Marketing/Logos/Contoso"
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/list/list-defaultvalue-remove.mdx

@@ -0,0 +1,62 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo list defaultvalue remove
+
+Removes a specific default column value for a specific document library
+
+## Usage
+
+```sh
+m365 spo list defaultvalue remove [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: URL of the site where the list is located.
+
+`-i, --listId [listId]`
+: ID of the list. Specify either `listTitle`, `listId`, or `listUrl`.
+
+`-t, --listTitle [listTitle]`
+: Title of the list. Specify either `listTitle`, `listId`, or `listUrl`.
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId`, or `listUrl`.
+
+`--fieldName <fieldName>`
+: Internal name of the field.
+
+`--folderUrl [folderUrl]`
+: Server- or site-relative URL of a specific folder to remove the field from. By default, the root folder of the list is used.
+
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Examples
+
+Remove a default column value from the root folder of the list
+
+```sh
+m365 spo list defaultvalue remove --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle Logos --fieldName Company
+```
+
+Remove a column default value from a specific folder using web-relative URL
+
+```sh
+m365 spo list defaultvalue remove --webUrl https://contoso.sharepoint.com/sites/Marketing --listUrl '/Logos' --fieldName Company --folderUrl '/Logos/Branding'
+```
+
+Remove a column default value from a specific folder by server relative URL
+
+```sh
+m365 spo list defaultvalue remove --webUrl https://contoso.sharepoint.com/sites/Marketing --listId fc6d514f-e7da-47d4-b48b-f72e2fb9c82a --field Company --folderUrl '/sites/Marketing/Logos/Branding'
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -0,0 +1,112 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo list defaultvalue set
+
+Sets default column values for a specific document library
+
+## Usage
+
+```sh
+m365 spo list defaultvalue set [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: URL of the site where the list is located.
+
+`-i, --listId [listId]`
+: ID of the list. Specify either `listTitle`, `listId`, or `listUrl`.
+
+`-t, --listTitle [listTitle]`
+: Title of the list. Specify either `listTitle`, `listId`, or `listUrl`.
+
+`--listUrl [listUrl]`
+: Server- or site-relative URL of the list. Specify either `listTitle`, `listId`, or `listUrl`.
+
+`--fieldName <fieldName>`
+: Internal name of the field.
+
+`--fieldValue <fieldValue>`
+: Default value of the field.
+
+`--folderUrl [folderUrl]`
+: Set the value for a specific folder by specifying a server- or site-relative URL. By default, the root folder of the list is used.
+```
+
+<Global />
+
+# Remarks
+
+:::note
+
+Due to limitations in SharePoint Online, setting default column values for folders with a `#` or `%` character in their path is not supported.
+
+:::
+
+## Examples
+
+Set a default folder value on the root folder of a list for a text field
+
+```sh
+m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle Logos --fieldName Company --fieldValue Contoso
+```
+
+Set a default folder value for a taxonomy field on a specific folder
+
+```sh
+m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle Logos --folderUrl "/sites/Marketing/Logos/Contoso" --fieldName Country --fieldValue "-1;#Belgium|442affc2-7fab-4f33-9590-330403a579c2"
+```
+
+Set a default folder value for a multi-taxonomy field on a specific folder
+
+```sh
+m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listUrl /sites/marketing/Logos --folderUrl "/sites/Marketing/Logos/Contoso" --fieldName Countries --fieldValue "-1;#Belgium|442affc2-7fab-4f33-9590-330403a579c2;#-1;#France|14888324-5c48-46db-b748-215cbe24eb4c"
+```
+
+Set a default folder value for a date field to today
+
+```sh
+m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listId 3540460d-cb6e-4bc5-8380-bc1844401ee3 --fieldName Published --fieldValue "[today]"
+```
+
+Set a default folder value for a date field
+
+```sh
+m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle Logos --fieldName Published --fieldValue "2020-05-03T11:00:00Z"
+```
+
+Set a default folder value for a choice field
+
+```sh
+m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listUrl /sites/marketing/Logos --fieldName FileType --fieldValue Logo
+```
+
+Set a default folder value for a multi-choice field
+
+```sh
+m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listTitle Logos --fieldName FileTypes --fieldValue "Logo;#Brand"
+```
+
+Set a default folder value for a yes/no field using site-relative list URL
+
+```sh
+m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listUrl /Logos --fieldName Active --fieldValue 1
+```
+
+Set a default folder value for a user field
+
+```sh
+m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listId 3540460d-cb6e-4bc5-8380-bc1844401ee3 --fieldName Responsible --fieldValue "1;#john.doe@contoso.com"
+```
+
+Set a default folder value for a multi-user field
+
+```sh
+m365 spo list defaultvalue set --webUrl https://contoso.sharepoint.com/sites/Marketing --listId 3540460d-cb6e-4bc5-8380-bc1844401ee3 --fieldName Responsible --fieldValue "1;#john.doe@contoso.com;#2;#adele.vance@contoso.com"
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -15,8 +15,11 @@ m365 spo page get [options]
 ## Options
 
 ```md definition-list
-`-n, --name <name>`
-: Name of the page to retrieve.
+`-n, --name [name]`
+: Name of the page to retrieve. Specify either `name` or `default`, but not both. 
+
+`--default`
+: Get the homepage of a specific web. Specify either `name` or `default`, but not both.
 
 `-u, --webUrl <webUrl>`
 : URL of the site where the page to retrieve is located.
@@ -39,6 +42,12 @@ Get information about the modern page.
 m365 spo page get --webUrl https://contoso.sharepoint.com/sites/team-a --name home.aspx
 ```
 
+Get information about the home page.
+
+```sh
+m365 spo page get --webUrl https://contoso.sharepoint.com/sites/team-a --default
+```
+
 Get all the metadata from the modern page, without the section and control count information.
 
 ```sh

package/docs/docs/cmd/tenant/report/report-settings-get.mdx

@@ -0,0 +1,67 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# tenant report settings get
+
+Get the tenant-level settings for Microsoft 365 reports
+
+## Usage
+
+```sh
+m365 tenant report settings get [options]
+```
+
+## Options
+
+<Global />
+
+## Examples
+
+Get the tenant-level settings for Microsoft 365 reports.
+
+```sh
+m365 tenant report settings get
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "displayConcealedNames": true
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  displayConcealedNames: true
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  displayConcealedNames
+  1
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # tenant report settings get
+
+  Date: 1/28/2025
+
+  Property | Value
+  ---------|-------
+  displayConcealedNames | true
+  ```
+  
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/tenant/report/report-settings-set.mdx

@@ -0,0 +1,32 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# tenant report settings set
+
+Update tenant-level settings for Microsoft 365 reports
+
+## Usage
+
+```sh
+m365 tenant report settings set [options]
+```
+
+## Options
+
+```md definition-list
+`-d, --displayConcealedNames <displayConcealedNames>`
+: Determines whether all reports conceal user information such as usernames, groups, and sites. If false, all reports show identifiable information.
+```
+
+<Global />
+
+## Examples
+
+Configure the tenant to display concealed user information in Microsoft 365 reports
+
+```sh
+m365 tenant report settings set --displayConcealedNames true
+```
+
+## Response
+
+The command won't return a response on success