@pnp/cli-microsoft365 7.11.0-beta.c513557 → 8.0.0-beta.3c404b8

package/dist/utils/validation.js

@@ -1,3 +1,4 @@
+import { formatting } from "./formatting.js";
 export const validation = {
     isValidGuidArray(guidsString) {
         const guids = guidsString.split(',').map(guid => guid.trim());
@@ -33,6 +34,24 @@ export const validation = {
         // verify if the upn is a valid upn. @meusername will be replaced in a later stage with the actual username of the logged in user
         return upnRegEx.test(upn) || upn.toLowerCase().trim() === '@meusername';
     },
+    /**
+     * Validates if the provided number is a valid positive integer (1 or higher).
+     * @param integer Integer value.
+     * @returns True if integer, false otherwise.
+     */
+    isValidPositiveInteger(integer) {
+        return !isNaN(Number(integer)) && Number.isInteger(+integer) && +integer > 0;
+    },
+    /**
+     * Validates an array of integers. The integers must be positive (1 or higher).
+     * @param integerString Comma-separated string of integers.
+     * @returns True if the integers are valid, an error message with the invalid integers otherwise.
+     */
+    isValidPositiveIntegerArray(integerString) {
+        const integers = formatting.splitAndTrim(integerString);
+        const invalidIntegers = integers.filter(integer => !this.isValidPositiveInteger(integer));
+        return invalidIntegers.length > 0 ? invalidIntegers.join(', ') : true;
+    },
     isDateInRange(date, monthOffset) {
         const d = new Date(date);
         const cutoffDate = new Date();
@@ -332,6 +351,12 @@ export const validation = {
     isValidISODuration(duration) {
         const durationRegEx = new RegExp(/^P(?!$)((\d+Y)|(\d+\.\d+Y$))?((\d+M)|(\d+\.\d+M$))?((\d+W)|(\d+\.\d+W$))?((\d+D)|(\d+\.\d+D$))?(T(?=\d)((\d+H)|(\d+\.\d+H$))?((\d+M)|(\d+\.\d+M$))?(\d+(\.\d+)?S)?)??$/);
         return durationRegEx.test(duration);
+    },
+    isValidPermission(permissions) {
+        const invalidPermissions = permissions
+            .split(' ')
+            .filter(permission => permission.indexOf('/') < 0);
+        return invalidPermissions.length > 0 ? invalidPermissions : true;
     }
 };
 //# sourceMappingURL=validation.js.map

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

@@ -35,10 +35,22 @@ m365 aad m365group set [options]
 : Comma-separated list of Microsoft 365 Group members to add
 
 `--isPrivate [isPrivate]`
-: Set to true if the Microsoft 365 Group should be private and to false if it should be public (default)
+: Set to `true` if the Microsoft 365 Group should be private and `false` if it should be public.  
 
 `-l, --logoPath [logoPath]`
 : Local path to the image file to use as group logo
+
+`--allowExternalSenders [allowExternalSenders]`
+: Indicates if people external to the organization can send messages to the group. Valid values: `true`, `false`.
+
+`--autoSubscribeNewMembers [autoSubscribeNewMembers]`
+: Indicates if new members added to the group will be auto-subscribed to receive email notifications. Valid values: `true`, `false`.
+
+`--hideFromAddressLists [hideFromAddressLists]`
+: Indicates if the group is not displayed in certain parts of the Outlook UI: the Address Book, address lists for selecting message recipients, and the Browse Groups dialog for searching groups. Valid values: `true`, `false`.
+
+`--hideFromOutlookClients [hideFromOutlookClients]`
+: Indicates if the group is not displayed in Outlook clients, such as Outlook for Windows and Outlook on the web. Valid values: `true`, `false`.
 ```
 
 <Global />
@@ -49,38 +61,56 @@ When updating group's owners and members, the command will add newly specified u
 
 When specifying the path to the logo image you can use both relative and absolute paths. Note, that ~ in the path, will not be resolved and will most likely result in an error.
 
+:::note
+
+Options `allowExternalSenders` and `autoSubscribeNewMembers` can only be set using delegated permissions.  
+
+:::
+
 ## Examples
 
-Update Microsoft 365 Group display name
+Update Microsoft 365 Group display name.
 
 ```sh
 m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --displayName Finance
 ```
 
-Change Microsoft 365 Group visibility to public
+Change Microsoft 365 Group visibility to public.
 
 ```sh
-m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --isPrivate false
+m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --isPrivate `false`
 ```
 
-Add new Microsoft 365 Group owners
+Add new Microsoft 365 Group owners.
 
 ```sh
 m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --owners "DebraB@contoso.onmicrosoft.com,DiegoS@contoso.onmicrosoft.com"
 ```
 
-Add new Microsoft 365 Group members
+Add new Microsoft 365 Group members.
 
 ```sh
 m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --members "DebraB@contoso.onmicrosoft.com,DiegoS@contoso.onmicrosoft.com"
 ```
 
-Update Microsoft 365 Group logo
+Update Microsoft 365 Group logo.
 
 ```sh
 m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --logoPath images/logo.png
 ```
 
+Hide the Microsoft 365 group from the address lists and the Outlook clients.
+
+```sh
+m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --hideFromOutlookClients true --hideFromAddressLists true
+```
+
+Auto-subscribe new members to receive email notifications and do not allow external senders to send messages to the group.
+
+```sh
+m365 entra m365group set --id 28beab62-7540-4db1-a23f-29a6018a3848 --autoSubscribeNewMembers true --allowExternalSenders false
+```
+
 ## Response
 
 The command won't return a response on success.

package/docs/docs/cmd/entra/multitenant/multitenant-get.mdx

@@ -0,0 +1,94 @@
+
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# entra multitenant get
+
+Gets properties of the multitenant organization
+
+## Usage
+
+```sh
+m365 entra multitenant get [options]
+```
+
+## Options
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command you must be at least **Security Administrator**.
+
+:::
+
+## Examples
+
+Gets properties of the multitenant organization
+
+```sh
+m365 entra multitenant get
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "c231d4a5-138f-4bdf-9fee-f26a90ea3ad0",
+    "createdDateTime": "2024-05-05T05:05:05Z",
+    "state": "active",
+    "displayName": "Contoso organization",
+    "description": "Multitenant organization between Contoso, Fabrikam, and Woodgrove Bank"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  createdDateTime: 2024-05-05T05:05:05Z
+  description    : Multitenant organization between Contoso, Fabrikam, and Woodgrove Bank
+  displayName    : Contoso organization
+  id             : c231d4a5-138f-4bdf-9fee-f26a90ea3ad0
+  state          : active
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,createdDateTime,state,displayName,description
+  c231d4a5-138f-4bdf-9fee-f26a90ea3ad0,2024-05-05T05:05:05Z,active,Contoso organization,"Multitenant organization between Contoso, Fabrikam, and Woodgrove Bank"
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # entra multitenant get
+
+  Date: 5/5/2024
+
+  ## Contoso organization (c231d4a5-138f-4bdf-9fee-f26a90ea3ad0)
+
+  Property | Value
+  ---------|-------
+  id | c231d4a5-138f-4bdf-9fee-f26a90ea3ad0
+  createdDateTime | 2024-05-05T05:05:05Z
+  state | active
+  displayName | Contoso organization
+  description | Multitenant organization between Contoso, Fabrikam, and Woodgrove Bank
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- Multitenant organization: https://learn.microsoft.com/entra/identity/multi-tenant-organizations/overview

package/docs/docs/cmd/external/connection/connection-doctor.mdx

@@ -126,15 +126,15 @@ m365 external connection doctor --id contosoproducts --ux copilot
   <TabItem value="Text">
 
   ```text
-  ✔ Load connection
-  ✔ Load schema
-  ✖ Required semantic labels: Missing label iconUrl
-  ✔ Searchable properties
-  ✔ Items have content ingested
-  ℹ Connection configured for inline results (manual)
-  ℹ Items have activities recorded (manual)
-  ℹ Meaningful connection name and description (manual)
-  ✔ urlToItemResolver configured
+  √ Load connection
+  √ Load schema
+  × Required semantic labels: Missing label iconUrl
+  √ Searchable properties
+  √ Items have content ingested
+  i Connection configured for inline results (manual)
+  i Items have activities recorded (manual)
+  i Meaningful connection name and description (manual)
+  √ urlToItemResolver configured
   ```
 
   </TabItem>

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

@@ -4,7 +4,7 @@ import TabItem from '@theme/TabItem';
 
 # flow list
 
-Lists Power Automate flow in the given environment
+Lists Power Automate flows in the given environment
 
 ## Usage
 
@@ -83,85 +83,61 @@ m365 flow list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --
   ```json
   [
     {
-      "name": "00afcb83-df7b-4fe0-ab9c-1542a1dc66a9",
-      "id": "/providers/Microsoft.ProcessSimple/environments/Default-00000000-0000-0000-0000-000000000000/flows/00afcb83-df7b-4fe0-ab9c-1542a1dc66a9",
+      "name": "fc2d4ef5-4151-4e93-9aaa-1f380d7ed95d",
+      "id": "/providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4/flows/fc2d4ef5-4151-4e93-9aaa-1f380d7ed95d",
       "type": "Microsoft.ProcessSimple/environments/flows",
       "properties": {
         "apiId": "/providers/Microsoft.PowerApps/apis/shared_logicflows",
-        "displayName": "Contoso Invoicing Flow",
+        "displayName": "Invoicing flow",
         "userType": "Owner",
         "state": "Started",
         "connectionReferences": {
-          "shared_contoso-20invoicing-5fdd00e4805bfffb8f-5fbaee43593a7efda0": {
-            "connectionName": "bd877f62e4224011aa936d706fc68902",
-            "source": "Invoker",
-            "id": "/providers/Microsoft.PowerApps/apis/shared_contoso-20invoicing-5fdd00e4805bfffb8f-5fbaee43593a7efda0",
-            "displayName": "Contoso Invoicing",
-            "iconUri": "https://az787822.vo.msecnd.net/defaulticons/api-dedicated.png",
-            "brandColor": "#007ee5",
-            "tier": "NotSpecified"
-          },
-          "shared_flowpush": {
-            "connectionName": "shared-flowpush-d2c01136-3f7d-4449-b4f1-cb2d03a35ba8",
-            "source": "Invoker",
-            "id": "/providers/Microsoft.PowerApps/apis/shared_flowpush",
-            "displayName": "Notifications",
-            "iconUri": "https://connectoricons-prod.azureedge.net/releases/v1.0.1599/1.0.1599.3017/flowpush/icon.png",
-            "brandColor": "#FF3B30",
+          "shared_office365": {
+            "connectionName": "shared-office365-19528cc4-23c1-4b39-abea-f010eb9fe3f9",
+            "source": "Embedded",
+            "id": "/providers/Microsoft.PowerApps/apis/shared_office365",
+            "displayName": "Office 365 Outlook",
+            "iconUri": "https://connectoricons-prod.azureedge.net/releases/v1.0.1686/1.0.1686.3706/office365/icon.png",
+            "brandColor": "#0078D4",
             "tier": "Standard"
           }
         },
-        "createdTime": "2022-06-11T10:34:03.7241198Z",
-        "lastModifiedTime": "2022-06-11T10:35:54.1920032Z",
+        "createdTime": "2024-07-09T21:32:14.5918501Z",
+        "lastModifiedTime": "2024-07-09T21:32:15.2349507Z",
         "environment": {
-          "name": "Default-00000000-0000-0000-0000-000000000000",
+          "name": "Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4",
           "type": "Microsoft.ProcessSimple/environments",
-          "id": "/providers/Microsoft.ProcessSimple/environments/Default-00000000-0000-0000-0000-000000000000"
+          "id": "/providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4"
         },
         "definitionSummary": {
           "triggers": [
             {
-              "type": "Request",
-              "kind": "Button",
+              "type": "Recurrence",
               "metadata": {
-                "operationMetadataId": "0cc0490e-e1b6-4a19-b313-f54862d64f02"
+                "operationMetadataId": "57317efe-4f87-47bc-b69c-179452c75f87"
               }
             }
           ],
           "actions": [
             {
               "type": "OpenApiConnection",
-              "swaggerOperationId": "ListInvoices",
+              "swaggerOperationId": "SendEmailV2",
               "metadata": {
-                "operationMetadataId": "d76a7b54-48bb-49a0-86b8-dd3d21b3d5ce"
-              }
-            },
-            {
-              "type": "Table",
-              "metadata": {
-                "operationMetadataId": "1164ebc4-b501-46bc-bc88-cc99660f92c3"
-              }
-            },
-            {
-              "type": "OpenApiConnection",
-              "swaggerOperationId": "SendEmailNotification",
-              "metadata": {
-                "operationMetadataId": "9febe29f-2e36-4765-81ab-83645d28332d"
+                "operationMetadataId": "474e8016-6a45-466a-a021-3fedf5a766be"
               }
             }
           ]
         },
         "creator": {
-          "tenantId": "00000000-0000-0000-0000-000000000000",
-          "objectId": "00000000-0000-0000-0000-000000000000",
-          "userId": "00000000-0000-0000-0000-000000000000",
+          "tenantId": "1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4",
+          "objectId": "9723d9b0-b8d6-48af-b381-fb4a9f0403e4",
+          "userId": "9723d9b0-b8d6-48af-b381-fb4a9f0403e4",
           "userType": "ActiveDirectory"
         },
         "provisioningMethod": "FromDefinition",
         "flowFailureAlertSubscribed": true,
         "isManaged": false
-      },
-      "displayName": "Contoso Invoicing Flow"
+      }
     }
   ]
   ```
@@ -171,16 +147,16 @@ m365 flow list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --
 
   ```text
   name                                  displayName
-  ------------------------------------  -----------------------------------------------
-  00afcb83-df7b-4fe0-ab9c-1542a1dc66a9  Contoso Invoicing Flow
+  ------------------------------------  --------------
+  fc2d4ef5-4151-4e93-9aaa-1f380d7ed95d  Invoicing Flow
   ```
 
   </TabItem>
   <TabItem value="CSV">
 
   ```csv
-  name,displayName
-  00afcb83-df7b-4fe0-ab9c-1542a1dc66a9,Contoso Invoicing Flow
+  name,id,type,displayName
+  fc2d4ef5-4151-4e93-9aaa-1f380d7ed95d,/providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4/flows/fc2d4ef5-4151-4e93-9aaa-1f380d7ed95d,Microsoft.ProcessSimple/environments/flows,Invoicing flow
   ```
 
   </TabItem>
@@ -189,18 +165,100 @@ m365 flow list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --
   ```md
   # flow list --environmentName "Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4"
 
-  Date: 2023-05-18
+  Date: 09/07/2024
 
-  ## Contoso Invoicing Flow (/providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4/flows/00afcb83-df7b-4fe0-ab9c-1542a1dc66a9)
+  ## Invoicing flow (/providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4/flows/fc2d4ef5-4151-4e93-9aaa-1f380d7ed95d)
 
   Property | Value
   ---------|-------
-  name | 00afcb83-df7b-4fe0-ab9c-1542a1dc66a9
-  id | /providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4/flows/00afcb83-df7b-4fe0-ab9c-1542a1dc66a9
+  name | fc2d4ef5-4151-4e93-9aaa-1f380d7ed95d
+  id | /providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4/flows/fc2d4ef5-4151-4e93-9aaa-1f380d7ed95d
   type | Microsoft.ProcessSimple/environments/flows
-  displayName | Contoso Invoicing Flow
+  displayName | Invoicing flow
   ```
 
   </TabItem>
 </Tabs>
 
+### `asAdmin` response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "name": "fc2d4ef5-4151-4e93-9aaa-1f380d7ed95d",
+      "id": "/providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4/flows/fc2d4ef5-4151-4e93-9aaa-1f380d7ed95d",
+      "type": "Microsoft.ProcessSimple/environments/flows",
+      "properties": {
+        "apiId": "/providers/Microsoft.PowerApps/apis/shared_logicflows",
+        "displayName": "Invoicing flow",
+        "state": "Started",
+        "createdTime": "2024-07-09T21:32:15Z",
+        "lastModifiedTime": "2024-07-09T21:32:15Z",
+        "flowSuspensionReason": "None",
+        "environment": {
+          "name": "Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4",
+          "type": "Microsoft.ProcessSimple/environments",
+          "id": "/providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4"
+        },
+        "definitionSummary": {
+          "triggers": [],
+          "actions": []
+        },
+        "creator": {
+          "tenantId": "1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4",
+          "objectId": "9723d9b0-b8d6-48af-b381-fb4a9f0403e4",
+          "userId": "9723d9b0-b8d6-48af-b381-fb4a9f0403e4",
+          "userType": "ActiveDirectory"
+        },
+        "flowFailureAlertSubscribed": false,
+        "isManaged": false,
+        "machineDescriptionData": {},
+        "flowOpenAiData": {
+          "isConsequential": false,
+          "isConsequentialFlagOverwritten": false
+        }
+      }
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  name                                  displayName
+  ------------------------------------  --------------
+  fc2d4ef5-4151-4e93-9aaa-1f380d7ed95d  Invoicing Flow
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  name,id,type,displayName
+  fc2d4ef5-4151-4e93-9aaa-1f380d7ed95d,/providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4/flows/fc2d4ef5-4151-4e93-9aaa-1f380d7ed95d,Microsoft.ProcessSimple/environments/flows,Invoicing flow
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # flow list --environmentName "Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4"
+
+  Date: 09/07/2024
+
+  ## Invoicing flow (/providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4/flows/fc2d4ef5-4151-4e93-9aaa-1f380d7ed95d)
+
+  Property | Value
+  ---------|-------
+  name | fc2d4ef5-4151-4e93-9aaa-1f380d7ed95d
+  id | /providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4/flows/fc2d4ef5-4151-4e93-9aaa-1f380d7ed95d
+  type | Microsoft.ProcessSimple/environments/flows
+  displayName | Invoicing flow
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/graph/subscription/subscription-add.mdx

@@ -67,6 +67,24 @@ Create a subscription using the maximum allowed expiration for Group resources
 m365 graph subscription add --resource groups --changeTypes "updated" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient"
 ```
 
+Create a subscription for Event Hub location if you are using Key Vault
+
+```sh
+m365 graph subscription add --resource user --changeTypes "created,updated,deleted" --notificationUrl "EventHub:https://azureKeyVaultName.vault.azure.net/secrets/secretName?tenantId=contoso.com"
+```
+
+Create a subscription for Event Hub location if you are using role-based access control
+
+```sh
+m365 graph subscription add --resource user --changeTypes "created,updated,deleted" --notificationUrl "EventHub:https://eventHubNamespace.servicebus.windows.net/eventhubname/eventHubName?tenantId=contoso.com"
+```
+
+Create a subscription for Event Grid Partner Topic.
+
+```sh
+m365 graph subscription add --resource user --changeTypes "created,updated,deleted" --notificationUrl "EventGrid:?azuresubscriptionid=8A8A8A8A-4B4B-4C4C-4D4D-12E12E12E12E&resourcegroup=resourceGroupName&partnertopic=partnerTopicName&location=partnerTopicAzureRegionName"
+```
+
 ## Response
 
 <Tabs>

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

@@ -17,10 +17,10 @@ m365 spo cdn set [options]
 : Set to true to enable CDN or to false to disable it. Allowed values: `true`, `false`.
 
 `-t, --type [type]`
-: Type of CDN to manage. Allowed values: `Public`, `Private`, `Both`. Defaults to `Public`.
+: Type of CDN to update. Allowed values: `Public`, `Private`, `Both`. Defaults to `Public`.
 
 `--noDefaultOrigins`
-: pass to not create the default origins.
+: Specify this flag to not create the default origins.
 ```
 
 <Global />
@@ -35,7 +35,7 @@ Using the `--noDefaultOrigins` option you can specify to skip the creation of th
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be a Global or SharePoint administrator.
 
 :::