@pnp/cli-microsoft365 11.11.0 → 12.0.0-beta.0be7d8d

package/docs/docs/cmd/spo/listitem/listitem-attachment-set.mdx

@@ -39,6 +39,25 @@ m365 spo listitem attachment set [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | AllSites.Write |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions         |
+  |------------|---------------------|
+  | SharePoint | Sites.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Update an attachment from a list item by using list title

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

@@ -33,8 +33,8 @@ m365 spo listitem get [options]
 `--listUrl [listUrl]`
 : Server- or site-relative URL of the list. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
 
-`-p, --properties [properties]`
-: Comma-separated list of properties to retrieve. Will retrieve all properties if not specified and json output is requested.
+`--fields [fields]`
+: Comma-separated list of fields to retrieve. Will retrieve all fields if not specified and json output is requested.
 
 `--withPermissions`
 : Set if you want to return associated roles and permissions.
@@ -44,7 +44,13 @@ m365 spo listitem get [options]
 
 ## Remarks
 
-If you want to specify a lookup type in the `properties` option, define which columns from the related list should be returned.
+:::note
+
+The `--properties` option has been renamed to `--fields`. If you use `--properties`, the command still works but shows a deprecation warning.
+
+:::
+
+If you want to specify a lookup type in the `fields` option, define which columns from the related list should be returned.
 
 ## Examples
 
@@ -63,19 +69,19 @@ m365 spo listitem get --listTitle "Demo List" --uniqueId "64dc28c4-3c43-45f6-ba6
 Get an item columns with the ID parameter from a given list in a given site.
 
 ```sh
-m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --properties "Title,Created"
+m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --fields "Title,Created"
 ```
 
 Get an item columns and lookup column with the ID parameter from a given list in a given site.
 
 ```sh
-m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --properties "Title,Created,Company/Title"
+m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --fields "Title,Created,Company/Title"
 ```
 
-Get an item with specific properties from a given list based on the server-relative URL in a specific site.
+Get an item with specific fields from a given list based on the server-relative URL in a specific site.
 
 ```sh
-m365 spo listitem get --listUrl /sites/project-x/documents --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --properties "Title,Created,Company/Title"
+m365 spo listitem get --listUrl /sites/project-x/documents --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --fields "Title,Created,Company/Title"
 ```
 
 Get an item with ID parameter from a given list based on the server-relative URL in a specific site with permissions.

package/docs/docs/cmd/spo/page/page-header-set.mdx

@@ -22,7 +22,7 @@ m365 spo page header set [options]
 : URL of the site where the page to update is located.
 
 `-t, --type [type]`
-: Type of header, allowed values `None`, `Default`, `Custom`. Default `Default`.
+: Type of header, allowed values `None`, `Default`, `Custom`.
 
 `--imageUrl [imageUrl]`
 : Server-relative URL of the image to use in the header. Image must be stored in the same site collection as the page.
@@ -37,19 +37,19 @@ m365 spo page header set [options]
 : Y focal point of the header image.
 
 `--layout [layout]`
-: Layout to use in the header. Allowed values `FullWidthImage`, `NoImage`, `ColorBlock`, `CutInShape`. Default `FullWidthImage`.
+: Layout to use in the header. Allowed values `FullWidthImage`, `NoImage`, `ColorBlock`, `CutInShape`.
 
 `--textAlignment [textAlignment]`
-: How to align text in the header. Allowed values `Center`, `Left`. Default `Left`.
+: How to align text in the header. Allowed values `Center`, `Left`.
 
 `--showTopicHeader [showTopicHeader]`
-: Show the topic header. Valid values: `true`, `false`. Defaults to `false`.
+: Show the topic header. Valid values: `true`, `false`.
 
 `--showPublishDate [showPublishDate]`
-: Show the publishing date. Valid values: `true`, `false`. Defaults to `false`.
+: Show the publishing date. Valid values: `true`, `false`.
 
 `--showTimeToRead [showTimeToRead]`
-: Show the estimated time to read the page. Valid values: `true`, `false`. Defaults to `false`.
+: Show the estimated time to read the page. Valid values: `true`, `false`.
 
 `--topicHeader [topicHeader]`
 : Text to show in the topic header, when `showTopicHeader` is set.
@@ -81,16 +81,16 @@ m365 spo page header set [options]
 
 ## Examples
 
-Reset the page header to default
+Update the page header authors
 
 ```sh
-m365 spo page header set --webUrl https://contoso.sharepoint.com/sites/team-a --pageName home.aspx
+m365 spo page header set --webUrl https://contoso.sharepoint.com/sites/team-a --pageName home.aspx --authors "steve@contoso.com, bob@contoso.com"
 ```
 
 Reset the page header to default and set authors
 
 ```sh
-m365 spo page header set --webUrl https://contoso.sharepoint.com/sites/team-a --pageName home.aspx --authors "steve@contoso.com, bob@contoso.com"
+m365 spo page header set --webUrl https://contoso.sharepoint.com/sites/team-a --pageName home.aspx --type Default --authors "steve@contoso.com, bob@contoso.com"
 ```
 
 Use the specified image focused on the given coordinates in the page header

package/docs/docs/cmd/tenant/id/id-get.mdx

@@ -25,6 +25,21 @@ m365 tenant id get [options]
 
 If no domain name is specified, the command will return the tenant ID of the tenant to which you are currently logged in.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  The command doesn't require any permissions.
+
+  </TabItem>
+  <TabItem value="Application">
+
+  The command doesn't require any permissions.
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get Microsoft 365 tenant ID for the specified domain

package/docs/docs/cmd/tenant/info/info-get.mdx

@@ -28,6 +28,25 @@ m365 tenant info get [options]
 
 If no domain name or tenantId is specified, the command will return the tenant information of the currently signed in user.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                          |
+  |-----------------|--------------------------------------|
+  | Microsoft Graph | CrossTenantInformation.ReadBasic.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                          |
+  |-----------------|--------------------------------------|
+  | Microsoft Graph | CrossTenantInformation.ReadBasic.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get tenant information for the currently signed in user.

package/docs/docs/cmd/tenant/people/people-pronouns-get.mdx

@@ -16,6 +16,25 @@ m365 tenant people pronouns get [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions             |
+  |-----------------|-------------------------|
+  | Microsoft Graph | PeopleSettings.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions             |
+  |-----------------|-------------------------|
+  | Microsoft Graph | PeopleSettings.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Retrieve information about pronouns settings

package/docs/docs/cmd/tenant/people/people-pronouns-set.mdx

@@ -21,6 +21,25 @@ m365 tenant people pronouns set [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                  |
+  |-----------------|------------------------------|
+  | Microsoft Graph | PeopleSettings.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                  |
+  |-----------------|------------------------------|
+  | Microsoft Graph | PeopleSettings.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Enable pronouns in the organization

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

@@ -16,6 +16,25 @@ m365 tenant report settings get [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions             |
+  |-----------------|-------------------------|
+  | Microsoft Graph | ReportSettings.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions             |
+  |-----------------|-------------------------|
+  | Microsoft Graph | ReportSettings.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get the tenant-level settings for Microsoft 365 reports.

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

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # tenant report settings set
 
@@ -19,6 +21,25 @@ m365 tenant report settings set [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                  |
+  |-----------------|------------------------------|
+  | Microsoft Graph | ReportSettings.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                  |
+  |-----------------|------------------------------|
+  | Microsoft Graph | ReportSettings.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Configure the tenant to display concealed user information in Microsoft 365 reports

package/docs/docs/cmd/tenant/security/security-alerts-list.mdx

@@ -21,6 +21,25 @@ m365 tenant security alerts list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions            |
+  |-----------------|------------------------|
+  | Microsoft Graph | SecurityEvents.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions            |
+  |-----------------|------------------------|
+  | Microsoft Graph | SecurityEvents.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get all security alerts for a tenant