@pnp/cli-microsoft365 10.11.0 → 11.0.0-beta.3d99ea3

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

@@ -4,7 +4,7 @@ import TabItem from '@theme/TabItem';
 
 # spo homesite set
 
-Sets the specified site as the Home Site
+Updates an existing SharePoint home site.
 
 ## Usage
 
@@ -15,11 +15,23 @@ m365 spo homesite set [options]
 ## Options
 
 ```md definition-list
-`-u, --siteUrl <siteUrl>`
-: The URL of the site to set as Home site.
+`-u, --url <url>`
+: The URL of the home site
+
+`--draftMode [draftMode]` 
+: Set draft status. Valid values are: `true`, `false`.
+
+`--audienceIds [audienceIds]` 
+: Comma-separated list of group Ids to set as audiences. Specify either `audienceIds` or `audienceNames`, but not both.
+
+`--audienceNames [audienceNames]` 
+: Comma-separated list of group names to set as audiences. You must use either `audienceIds` or `audienceNames`, but not both. Pass `''` to clear audience.
+
+`--targetedLicenseType [targetedLicenseType]` 
+: Value of either `everyone`, `frontLineWorkers` or `informationWorkers` to create an experience for a distinct audience by license type.
 
 `--vivaConnectionsDefaultStart [vivaConnectionsDefaultStart]`
-: When set to `true`, the Viva Connections landing experience is set to the SharePoint home site. If set to `false`, the Viva Connections home experience will be used.
+: Specifies whether the home site is the default start for Viva Connections. Accepts `true` or `false`.
 ```
 
 <Global />
@@ -34,91 +46,119 @@ To use this command you must be a Global or SharePoint administrator.
 
 ## Examples
 
-Set the specified site as the Home Site.
+Sets the home site to the provided site collection url and sets the Viva Connections landing experience to the SharePoint home site
 
 ```sh
-m365 spo homesite set --siteUrl https://contoso.sharepoint.com/sites/comms
+m365 spo homesite set --url https://contoso.sharepoint.com/sites/comms --vivaConnectionsDefaultStart true
 ```
 
-Sets the Home site to the provided site collection url and sets the Viva Connections landing experience to the SharePoint home site
+Set the home site in draft mode
 
 ```sh
-m365 spo homesite set --siteUrl https://contoso.sharepoint.com/sites/comms --vivaConnectionsDefaultStart true
+m365 spo homesite set --url https://contoso.sharepoint.com/sites/contosoportal --draftMode true
 ```
 
-Sets the Home site to the provided site collection url and sets the Viva Connections landing experience to the default experience
+Set the audience to everyone
 
 ```sh
-m365 spo homesite set --siteUrl https://contoso.sharepoint.com/sites/comms --vivaConnectionsDefaultStart false
+m365 spo homesite set --url https://contoso.sharepoint.com/sites/contosoportal --targetedLicenseType "everyone"
 ```
 
-## Response
-
-### Standard response
-
-<Tabs>
-  <TabItem value="JSON">
-
-  ```json
-  "The Home site has been set to https://contoso.sharepoint.com. It may take some time for the change to apply. Check aka.ms/homesites for details."
-  ```
+Set the audience to groups using groups Ids
 
-  </TabItem>
-  <TabItem value="Text">
+```sh
+m365 spo homesite set --url https://contoso.sharepoint.com/sites/contosoportal --audienceIds "978b5280-4f80-47ea-a1db-b0d1d2fb1ba4,21af775d-17b3-4637-94a4-2ba8625277cb"
+```
 
-  ```text
-  The Home site has been set to https://contoso.sharepoint.com. It may take some time for the change to apply. Check aka.ms/homesites for details.
-  ```
+Set the audience to using their display name
 
-  </TabItem>
-  <TabItem value="CSV">
+```sh
+m365 spo homesite set --url https://contoso.sharepoint.com/sites/contosoportal --audienceNames "Marketing, IT department"
+```
 
-  ```csv
-  The Home site has been set to https://contoso.sharepoint.com. It may take some time for the change to apply. Check aka.ms/homesites for details.
-  ```
+Clear the audience and set to draft 
 
-  </TabItem>
-  <TabItem value="Markdown">
+```sh
+m365 spo homesite set --url https://contoso.sharepoint.com/sites/contosoportal --audienceNames '' --draftMode true
+```
 
-  ```md
-  The Home site has been set to https://contoso.sharepoint.com. It may take some time for the change to apply. Check aka.ms/homesites for details.
-  ```
+Configure multiple options
 
-  </TabItem>
-</Tabs>
+```sh
+m365 spo homesite set --url https://contoso.sharepoint.com/sites/contosoportal --audienceNames 'Marketing, IT department' --draftMode true --targetedLicenseType "everyone" --vivaConnectionsDefaultStart true
+```
 
-### `vivaConnectionsDefaultStart` response
+## Response
 
-When we make use of the option `vivaConnectionsDefaultStart` the response will differ. 
+### Standard response
 
 <Tabs>
   <TabItem value="JSON">
 
   ```json
-  "The Home site has been set to https://contoso.sharepoint.com and the Viva Connections default experience to True. It may take some time for the change to apply. Check aka.ms/homesites for details."
+  {
+    "Audiences": [
+      {
+        "Email": "active@contoso.onmicrosoft.com",
+        "Id": "7a1eea7f-9ab0-40ff-8f2e-0083d9d63451",
+        "Title": "active Members"
+      }
+    ],
+    "IsInDraftMode": true,
+    "IsVivaBackendSite": false,
+    "SiteId": "431d7819-4aaf-49a1-b664-b2fe9e609b63",
+    "TargetedLicenseType": 2,
+    "Title": "The Landing",
+    "Url": "https://contoso.sharepoint.com/sites/TheLanding",
+    "VivaConnectionsDefaultStart": true,
+    "WebId": "626c1724-8ac8-45d5-af87-c07c752fab75"
+  }
   ```
 
   </TabItem>
   <TabItem value="Text">
 
   ```text
-  The Home site has been set to https://contoso.sharepoint.com and the Viva Connections default experience to True. It may take some time for the change to apply. Check aka.ms/homesites for details.
+  Audiences                  : [{"Email":"active@contoso.onmicrosoft.com","Id":"7a1eea7f-9ab0-40ff-8f2e-0083d9d63451","Title":"active Members"}]
+  IsInDraftMode              : true
+  IsVivaBackendSite          : false
+  SiteId                     : 431d7819-4aaf-49a1-b664-b2fe9e609b63
+  TargetedLicenseType        : 2
+  Title                      : The Landing
+  Url                        : https://contoso.sharepoint.com/sites/TheLanding
+  VivaConnectionsDefaultStart: true
+  WebId                      : 626c1724-8ac8-45d5-af87-c07c752fab75
   ```
 
   </TabItem>
   <TabItem value="CSV">
 
   ```csv
-  The Home site has been set to https://contoso.sharepoint.com and the Viva Connections default experience to True. It may take some time for the change to apply. Check aka.ms/homesites for details.
+  IsInDraftMode,IsVivaBackendSite,SiteId,TargetedLicenseType,Title,Url,VivaConnectionsDefaultStart,WebId
+  1,0,431d7819-4aaf-49a1-b664-b2fe9e609b63,2,The Landing,https://contoso.sharepoint.com/sites/TheLanding,1,626c1724-8ac8-45d5-af87-c07c752fab75
   ```
-
+  
   </TabItem>
   <TabItem value="Markdown">
 
   ```md
-  The Home site has been set to https://contoso.sharepoint.com and the Viva Connections default experience to True. It may take some time for the change to apply. Check aka.ms/homesites for details.
+  # spo homesite set --url "https://contoso.sharepoint.com/sites/TheLanding" --vivaConnectionsDefaultStart "true" --audienceNames "active"
+
+  Date: 7/27/2025
+
+  ## The Landing (https://contoso.sharepoint.com/sites/TheLanding)
+
+  Property | Value
+  ---------|-------
+  IsInDraftMode | true
+  IsVivaBackendSite | false
+  SiteId | 431d7819-4aaf-49a1-b664-b2fe9e609b63
+  TargetedLicenseType | 2
+  Title | The Landing
+  Url | https://contoso.sharepoint.com/sites/TheLanding
+  VivaConnectionsDefaultStart | true
+  WebId | 626c1724-8ac8-45d5-af87-c07c752fab75
   ```
-
   </TabItem>
 </Tabs>
 

package/docs/docs/cmd/teams/report/report-directroutingcalls.mdx

@@ -62,42 +62,31 @@ m365 teams report directroutingcalls --fromDateTime 2020-10-31 --toDateTime 2020
   <TabItem value="JSON">
 
   ``` json
-  {
-    "@odata.count": 1,
-    "value": [
-      {
-        "id": "9e8bba57-dc14-533a-a7dd-f0da6575eed1",
-        "correlationId": "c98e1515-a937-4b81-b8a8-3992afde64e0",
-        "userId": "db03c14b-06eb-4189-939b-7cbf3a20ba27",
-        "userPrincipalName": "richard.malk@contoso.com",
-        "userDisplayName": "Richard Malk",
-        "startDateTime": "2019-11-01T00:00:25.105Z",
-        "inviteDateTime": "2019-11-01T00:00:21.949Z",
-        "failureDateTime": "0001-01-01T00:00:00Z",
-        "endDateTime": "2019-11-01T00:00:30.105Z",
-        "duration": 5,
-        "callType": "ByotIn",
-        "successfulCall": true,
-        "callerNumber": "+12345678***",
-        "calleeNumber": "+01234567***",
-        "mediaPathLocation": "USWE",
-        "signalingLocation": "EUNO",
-        "finalSipCode": 0,
-        "callEndSubReason": 540000,
-        "finalSipCodePhrase": "BYE",
-        "trunkFullyQualifiedDomainName": "tll-audiocodes01.adatum.biz",
-        "mediaBypassEnabled": false
-      }
-    ]
-  }
-  ```
-
-  </TabItem>
-  <TabItem value="Text">
-
-  ``` text
-  id,calleeNumber,callerNumber,startDateTime
-  9e8bba57-dc14-533a-a7dd-f0da6575eed1,+01234567***,+12345678***,2019-11-01T00:00:25.105Z
+  [
+    {
+      "id": "9e8bba57-dc14-533a-a7dd-f0da6575eed1",
+      "correlationId": "c98e1515-a937-4b81-b8a8-3992afde64e0",
+      "userId": "db03c14b-06eb-4189-939b-7cbf3a20ba27",
+      "userPrincipalName": "richard.malk@contoso.com",
+      "userDisplayName": "Richard Malk",
+      "startDateTime": "2019-11-01T00:00:25.105Z",
+      "inviteDateTime": "2019-11-01T00:00:21.949Z",
+      "failureDateTime": "0001-01-01T00:00:00Z",
+      "endDateTime": "2019-11-01T00:00:30.105Z",
+      "duration": 5,
+      "callType": "ByotIn",
+      "successfulCall": true,
+      "callerNumber": "+12345678***",
+      "calleeNumber": "+01234567***",
+      "mediaPathLocation": "USWE",
+      "signalingLocation": "EUNO",
+      "finalSipCode": 0,
+      "callEndSubReason": 540000,
+      "finalSipCodePhrase": "BYE",
+      "trunkFullyQualifiedDomainName": "tll-audiocodes01.adatum.biz",
+      "mediaBypassEnabled": false
+    }
+  ]
   ```
 
   </TabItem>
@@ -108,14 +97,6 @@ m365 teams report directroutingcalls --fromDateTime 2020-10-31 --toDateTime 2020
   9e8bba57-dc14-533a-a7dd-f0da6575eed1,+01234567***,+12345678***,2019-11-01T00:00:25.105Z
   ```
 
-  </TabItem>
-  <TabItem value="Markdown">
-
-  ```md
-  id,calleeNumber,callerNumber,startDateTime
-  9e8bba57-dc14-533a-a7dd-f0da6575eed1,+01234567***,+12345678***,2019-11-01T00:00:25.105Z
-  ```
-
   </TabItem>
 </Tabs>
 

package/docs/docs/cmd/teams/report/report-pstncalls.mdx

@@ -56,52 +56,37 @@ Get details about PSTN calls made between 2020-10-31 and 2020-12-31 and exports
 m365 teams report pstncalls --fromDateTime 2020-10-31 --toDateTime 2020-12-31 --output json > "pstncalls.json"
 ```
 
-## More information
-
-- List PSTN calls: [https://learn.microsoft.com/graph/api/callrecords-callrecord-getpstncalls?view=graph-rest-1.0](https://learn.microsoft.com/graph/api/callrecords-callrecord-getpstncalls?view=graph-rest-1.0)
-
 ## Response
 
 <Tabs>
   <TabItem value="JSON">
 
   ``` json
-  {
-    "@odata.count": 1,
-    "value": [
-      {
-        "id": "9c4984c7-6c3c-427d-a30c-bd0b2eacee90",
-        "callId": "1835317186_112562680@61.221.3.176",
-        "userId": "db03c14b-06eb-4189-939b-7cbf3a20ba27",
-        "userPrincipalName": "richard.malk@contoso.com",
-        "userDisplayName": "Richard Malk",
-        "startDateTime": "2019-11-01T00:00:08.2589935Z",
-        "endDateTime": "2019-11-01T00:03:47.2589935Z",
-        "duration": 219,
-        "charge": 0.00,
-        "callType": "user_in",
-        "currency": "USD",
-        "calleeNumber": "+1234567890",
-        "usageCountryCode": "US",
-        "tenantCountryCode": "US",
-        "connectionCharge": 0.00,
-        "callerNumber": "+0123456789",
-        "destinationContext": null,
-        "destinationName": "United States",
-        "conferenceId": null,
-        "licenseCapability": "MCOPSTNU",
-        "inventoryType": "Subscriber"
-      }
-    ]
-}
-  ```
-
-  </TabItem>
-  <TabItem value="Text">
-
-  ``` text
-  id,calleeNumber,callerNumber,startDateTime
-  9c4984c7-6c3c-427d-a30c-bd0b2eacee90,+1234567890,+0123456789,2019-11-01T00:00:08.2589935Z
+  [
+    {
+      "id": "9c4984c7-6c3c-427d-a30c-bd0b2eacee90",
+      "callId": "1835317186_112562680@61.221.3.176",
+      "userId": "db03c14b-06eb-4189-939b-7cbf3a20ba27",
+      "userPrincipalName": "richard.malk@contoso.com",
+      "userDisplayName": "Richard Malk",
+      "startDateTime": "2019-11-01T00:00:08.2589935Z",
+      "endDateTime": "2019-11-01T00:03:47.2589935Z",
+      "duration": 219,
+      "charge": 0.00,
+      "callType": "user_in",
+      "currency": "USD",
+      "calleeNumber": "+1234567890",
+      "usageCountryCode": "US",
+      "tenantCountryCode": "US",
+      "connectionCharge": 0.00,
+      "callerNumber": "+0123456789",
+      "destinationContext": null,
+      "destinationName": "United States",
+      "conferenceId": null,
+      "licenseCapability": "MCOPSTNU",
+      "inventoryType": "Subscriber"
+    }
+  ]
   ```
 
   </TabItem>
@@ -112,14 +97,6 @@ m365 teams report pstncalls --fromDateTime 2020-10-31 --toDateTime 2020-12-31 --
   9c4984c7-6c3c-427d-a30c-bd0b2eacee90,+1234567890,+0123456789,2019-11-01T00:00:08.2589935Z
   ```
 
-  </TabItem>
-  <TabItem value="Markdown">
-
-  ```md
-  id,calleeNumber,callerNumber,startDateTime
-  9c4984c7-6c3c-427d-a30c-bd0b2eacee90,+1234567890,+0123456789,2019-11-01T00:00:08.2589935Z
-  ```
-
   </TabItem>
 </Tabs>
 

package/docs/docs/cmd/viva/engage/engage-community-list.mdx

@@ -16,6 +16,25 @@ m365 viva engage community list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions        |
+  |-----------------|--------------------|
+  | Microsoft Graph | Community.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions        |
+  |-----------------|--------------------|
+  | Microsoft Graph | Community.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Lists all Viva Engage communities

package/docs/docs/cmd/viva/engage/engage-community-user-add.mdx

@@ -36,6 +36,25 @@ m365 viva engage community user add [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions               |
+  |-----------------|---------------------------|
+  | Microsoft Graph | GroupMember.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions               |
+  |-----------------|---------------------------|
+  | Microsoft Graph | GroupMember.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Add a single user specified by ID as a member to a community specified by display name.

package/docs/docs/cmd/viva/engage/engage-community-user-remove.mdx

@@ -36,6 +36,25 @@ m365 viva engage community user remove [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions               |
+  |-----------------|---------------------------|
+  | Microsoft Graph | GroupMember.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions               |
+  |-----------------|---------------------------|
+  | Microsoft Graph | GroupMember.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Remove a user specified by ID as a member from a community specified by display name.