@pnp/cli-microsoft365 8.0.0-beta.e6f9331 → 8.1.0-beta.3a80e6f

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

@@ -0,0 +1,58 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# entra multitenant remove
+
+Removes a multitenant organization
+
+## Usage
+
+```sh
+m365 entra multitenant remove [options]
+```
+
+## options
+
+```md definition-list
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command you must be at least **Security Administrator**.
+
+:::
+
+:::info
+
+When removing a Multi-Tenant Organization, all associations with other tenants will be removed too.
+
+The removing process can take up to 2 hours to complete.
+
+:::
+
+## Examples
+
+Remove the multitenant organization.
+
+```sh
+m365 entra multitenant remove
+```
+
+Remove the multitenant organization without prompting for confirmation.
+
+```sh
+m365 entra multitenant remove --force
+```
+
+## Response
+
+The command won't return a response on success
+
+## More information
+
+- Multitenant organization: https://learn.microsoft.com/entra/identity/multi-tenant-organizations/overview

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

@@ -0,0 +1,53 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# entra multitenant set
+
+Updates the properties of a multitenant organization
+
+## Usage
+
+```sh
+m365 entra multitenant set [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --displayName [displayName]`
+: New display name of the multitenant organization. Both options, `displayName` and `description` are optional but at least must be specified.
+
+`-d, --description [description]`
+: New description of the multitenant organization. Both options, `displayName` and `description` are optional but at least must be specified.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command you must be at least **Security Administrator**.
+
+:::
+
+## Examples
+
+Update display name of multitenant organization.
+
+```sh
+m365 entra multitenant set --displayName 'Fabrikam organization'
+```
+
+Update display name and description of multitenant organization.
+
+```sh
+m365 entra multitenant set --displayName 'Fabrikam organization' --description 'Multitenant organization between Fabrikam and Contoso'
+```
+
+## Response
+
+The command won't return a response on success
+
+## 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-get.mdx

@@ -62,352 +62,218 @@ m365 flow get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --n
 
   ```json
   {
-    "name": "ca76d7b8-3b76-4050-8c03-9fb310ad172f",
-    "id": "/providers/Microsoft.ProcessSimple/environments/Default-00000000-0000-0000-0000-000000000000/flows/ca76d7b8-3b76-4050-8c03-9fb310ad172f",
+    "name": "a18e89d1-4c75-41e4-9517-e90aedc079be",
+    "id": "/providers/Microsoft.ProcessSimple/environments/Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d/flows/a18e89d1-4c75-41e4-9517-e90aedc079be",
     "type": "Microsoft.ProcessSimple/environments/flows",
     "properties": {
       "apiId": "/providers/Microsoft.PowerApps/apis/shared_logicflows",
-      "displayName": "My Flow",
+      "displayName": "TEST",
       "userType": "Owner",
       "definition": {
         "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
         "contentVersion": "1.0.0.0",
         "parameters": {
-          "$connections": {
-            "defaultValue": {},
-            "type": "Object"
-          },
           "$authentication": {
             "defaultValue": {},
             "type": "SecureObject"
+          },
+          "$connections": {
+            "defaultValue": {},
+            "type": "Object"
           }
         },
         "triggers": {
-          "When_a_file_is_created_in_a_folder": {
-            "recurrence": {
-              "frequency": "Minute",
-              "interval": 1
-            },
+          "manual": {
             "metadata": {
-              "%252fComputer%2bVision%2bDemo": "/My Flow Demo",
-              "operationMetadataId": "2e0aa276-5536-4f67-a7b7-c1a37a91b8ca",
-              "%252fShared%2bDocuments": "/Shared Documents"
+              "operationMetadataId": "04077d6a-9fdd-4c79-b742-09a8d5c022eb"
             },
-            "type": "OpenApiConnection",
+            "type": "Request",
+            "kind": "Button",
             "inputs": {
-              "host": {
-                "apiId": "/providers/Microsoft.PowerApps/apis/shared_sharepointonline",
-                "connectionName": "shared_sharepointonline",
-                "operationId": "OnNewFile"
-              },
-              "parameters": {
-                "dataset": "https://contoso.sharepoint.com/sites/contosoHome",
-                "folderId": "%252fShared%2bDocuments",
-                "inferContentType": true
-              },
-              "authentication": "@parameters('$authentication')"
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "text": {
+                    "description": "Please enter your input",
+                    "title": "Text",
+                    "type": "string",
+                    "x-ms-content-hint": "TEXT",
+                    "x-ms-dynamically-added": true
+                  },
+                  "boolean": {
+                    "description": "Please select yes or no",
+                    "title": "Boolean",
+                    "type": "boolean",
+                    "x-ms-content-hint": "BOOLEAN",
+                    "x-ms-dynamically-added": true
+                  },
+                  "number": {
+                    "description": "Please enter a number",
+                    "title": "Number",
+                    "type": "number",
+                    "x-ms-content-hint": "NUMBER",
+                    "x-ms-dynamically-added": true
+                  }
+                },
+                "required": [
+                  "text",
+                  "boolean",
+                  "number"
+                ]
+              }
             }
           }
         },
         "actions": {
-          "Analyze_Image": {
-            "runAfter": {
-              "Initialize_variable": [
-                "Succeeded"
-              ]
-            },
-            "metadata": {
-              "operationMetadataId": "82b95160-9c96-4507-ad8c-c688ea95c2b1"
-            },
-            "type": "OpenApiConnection",
-            "inputs": {
-              "host": {
-                "apiId": "/providers/Microsoft.PowerApps/apis/shared_cognitiveservicescomputervision",
-                "connectionName": "shared_cognitiveservicescomputervision",
-                "operationId": "AnalyzeImageV2"
-              },
-              "parameters": {
-                "format": "Image Content",
-                "Image": "@triggerOutputs()?['body']"
-              },
-              "authentication": "@parameters('$authentication')"
-            }
-          },
-          "Compose": {
-            "runAfter": {
-              "Analyze_Image": [
-                "Succeeded"
-              ]
-            },
-            "metadata": {
-              "operationMetadataId": "cbd09106-eb7a-4743-b553-8b11cd09a90c"
-            },
-            "type": "Compose",
-            "inputs": "@outputs('Analyze_Image')?['body/tags']"
-          },
           "Initialize_variable": {
             "runAfter": {},
-            "metadata": {
-              "operationMetadataId": "818f9da8-8ebf-4081-8d7b-8fe37470cd57"
-            },
             "type": "InitializeVariable",
             "inputs": {
               "variables": [
                 {
-                  "name": "FilePath",
-                  "type": "string",
-                  "value": "@{decodeUriComponent(decodeUriComponent(triggerOutputs()?['headers/x-ms-file-id']))}"
+                  "name": "TEST",
+                  "type": "string"
                 }
               ]
             }
+          }
+        }
+      },
+      "triggerSchema": {
+        "type": "object",
+        "properties": {
+          "text": {
+            "description": "Please enter your input",
+            "title": "Text",
+            "type": "string",
+            "x-ms-content-hint": "TEXT",
+            "x-ms-dynamically-added": true
           },
-          "Send_an_HTTP_request_to_SharePoint": {
-            "runAfter": {
-              "Compose": [
-                "Succeeded"
-              ]
-            },
-            "metadata": {
-              "operationMetadataId": "0e9b2bf7-c52e-4b28-8351-2850a3373186"
-            },
-            "type": "OpenApiConnection",
-            "inputs": {
-              "host": {
-                "apiId": "/providers/Microsoft.PowerApps/apis/shared_sharepointonline",
-                "connectionName": "shared_sharepointonline",
-                "operationId": "HttpRequest"
-              },
-              "parameters": {
-                "dataset": "https://contoso.sharepoint.com/sites/contosoHome",
-                "parameters/method": "GET",
-                "parameters/uri": "_api/web/getFileByServerRelativeURL('@{concat('/sites/contosoHome/', variables('FilePath'))}')?$select=ListItemAllFields/ID&$expand=ListItemAllFields"
-              },
-              "authentication": "@parameters('$authentication')"
-            }
-          },
-          "Parse_JSON": {
-            "runAfter": {
-              "Send_an_HTTP_request_to_SharePoint": [
-                "Succeeded"
-              ]
-            },
-            "metadata": {
-              "operationMetadataId": "7d758c3f-f603-44d0-94b6-26cb08590fb3"
-            },
-            "type": "ParseJson",
-            "inputs": {
-              "content": "@body('Send_an_HTTP_request_to_SharePoint')",
-              "schema": {
-                "type": "object",
-                "properties": {
-                  "d": {
-                    "type": "object",
-                    "properties": {
-                      "__metadata": {
-                        "type": "object",
-                        "properties": {
-                          "id": {
-                            "type": "string"
-                          },
-                          "uri": {
-                            "type": "string"
-                          },
-                          "type": {
-                            "type": "string"
-                          }
-                        }
-                      },
-                      "ListItemAllFields": {
-                        "type": "object",
-                        "properties": {
-                          "__metadata": {
-                            "type": "object",
-                            "properties": {
-                              "id": {
-                                "type": "string"
-                              },
-                              "uri": {
-                                "type": "string"
-                              },
-                              "etag": {
-                                "type": "string"
-                              },
-                              "type": {
-                                "type": "string"
-                              }
-                            }
-                          },
-                          "Id": {
-                            "type": "integer"
-                          },
-                          "ID": {
-                            "type": "integer"
-                          }
-                        }
-                      }
-                    }
-                  }
-                }
-              }
-            }
+          "boolean": {
+            "description": "Please select yes or no",
+            "title": "Boolean",
+            "type": "boolean",
+            "x-ms-content-hint": "BOOLEAN",
+            "x-ms-dynamically-added": true
           },
-          "Update_file_properties": {
-            "runAfter": {
-              "Parse_JSON": [
-                "Succeeded"
-              ]
-            },
-            "metadata": {
-              "operationMetadataId": "c1a801a8-1f96-498a-a356-82c9d0dd8188"
-            },
-            "type": "OpenApiConnection",
-            "inputs": {
-              "host": {
-                "apiId": "/providers/Microsoft.PowerApps/apis/shared_sharepointonline",
-                "connectionName": "shared_sharepointonline",
-                "operationId": "PatchFileItem"
-              },
-              "parameters": {
-                "dataset": "https://contoso.sharepoint.com/sites/contosoHome",
-                "table": "13e0b5a3-f626-4272-a73b-a3e84978199b",
-                "id": "@body('Parse_JSON')?['d']?['ListItemAllFields']?['Id']",
-                "item/CognitiveTags": "@join(outputs('Analyze_Image')?['body/description/tags'], ', ')"
-              },
-              "authentication": "@parameters('$authentication')"
-            }
+          "number": {
+            "description": "Please enter a number",
+            "title": "Number",
+            "type": "number",
+            "x-ms-content-hint": "NUMBER",
+            "x-ms-dynamically-added": true
           }
         },
-        "outputs": {}
+        "required": [
+          "text",
+          "boolean",
+          "number"
+        ]
       },
       "state": "Started",
-      "connectionReferences": {
-        "shared_cognitiveservicescomputervision": {
-          "connectionName": "shared-cognitiveserv-34d89cec-971e-41b6-8c79-247c97eecec5",
-          "source": "Embedded",
-          "id": "/providers/Microsoft.PowerApps/apis/shared_cognitiveservicescomputervision",
-          "displayName": "My Flow API",
-          "iconUri": "https://connectoricons-prod.azureedge.net/releases/v1.0.1549/1.0.1549.2680/cognitiveservicescomputervision/icon.png",
-          "brandColor": "#1267AE",
-          "tier": "Standard"
-        },
-        "shared_sharepointonline": {
-          "connectionName": "shared-sharepointonl-1c433d0f-a030-45eb-9795-8c2585f84781",
-          "source": "Embedded",
-          "id": "/providers/Microsoft.PowerApps/apis/shared_sharepointonline",
-          "displayName": "SharePoint",
-          "iconUri": "https://connectoricons-prod.azureedge.net/releases/v1.0.1610-greyhound-localization-RelayFix/1.0.1610.3091/sharepointonline/icon.png",
-          "brandColor": "#036C70",
+      "plan": "NotSpecified",
+      "connectionReferences": {},
+      "installedConnectionReferences": {
+        "shared_approvals": {
+          "connectionName": "shared-approvals-068230cf-43ef-455d-b823-ee6f989d0193",
+          "apiDefinition": {
+            "name": "shared_approvals",
+            "id": "/providers/Microsoft.PowerApps/apis/shared_approvals",
+            "type": "/providers/Microsoft.PowerApps/apis",
+            "properties": {
+              "displayName": "Approvals",
+              "iconUri": "https://connectoricons-prod.azureedge.net/releases/v1.0.1682/1.0.1682.3671/approvals/icon.png",
+              "purpose": "NotSpecified",
+              "connectionParameters": {},
+              "runtimeUrls": [
+                "https://europe-002.azure-apim.net/apim/approvals"
+              ],
+              "primaryRuntimeUrl": "https://europe-002.azure-apim.net/apim/approvals",
+              "metadata": {
+                "source": "marketplace",
+                "brandColor": "#6464F5",
+                "connectionLimits": {
+                  "*": 1
+                },
+                "useNewApimVersion": "true",
+                "version": {
+                  "previous": "releases/v1.0.1679\\1.0.1679.3643",
+                  "current": "releases/v1.0.1682\\1.0.1682.3671"
+                }
+              },
+              "capabilities": [
+                "actions"
+              ],
+              "tier": "Standard",
+              "isCustomApi": false,
+              "description": "Enables approvals in workflows.",
+              "createdTime": "2018-09-16T08:09:23.9434372Z",
+              "changedTime": "2024-03-11T18:25:46.7755101Z",
+              "publisher": "Microsoft"
+            }
+          },
+          "source": "Invoker",
+          "id": "/providers/Microsoft.PowerApps/apis/shared_approvals",
+          "displayName": "Approvals",
+          "iconUri": "https://connectoricons-prod.azureedge.net/releases/v1.0.1682/1.0.1682.3671/approvals/icon.png",
+          "brandColor": "#6464F5",
           "tier": "Standard"
         }
       },
-      "createdTime": "2022-06-20T15:13:24.5135728Z",
-      "lastModifiedTime": "2022-11-01T14:15:31.5790933Z",
+      "createdTime": "2023-07-25T18:42:15.7693633Z",
+      "lastModifiedTime": "2024-03-08T10:24:12.0147046Z",
       "flowSuspensionReason": "None",
       "environment": {
-        "name": "Default-00000000-0000-0000-0000-000000000000",
+        "name": "Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d",
         "type": "Microsoft.ProcessSimple/environments",
-        "id": "/providers/Microsoft.ProcessSimple/environments/Default-00000000-0000-0000-0000-000000000000"
+        "id": "/providers/Microsoft.ProcessSimple/environments/Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d"
       },
       "definitionSummary": {
         "triggers": [
           {
-            "type": "OpenApiConnection",
-            "swaggerOperationId": "OnNewFile",
+            "type": "Request",
+            "kind": "Button",
             "metadata": {
-              "%252fComputer%2bVision%2bDemo": "/My Flow Demo",
-              "operationMetadataId": "2e0aa276-5536-4f67-a7b7-c1a37a91b8ca",
-              "%252fShared%2bDocuments": "/Shared Documents"
+              "operationMetadataId": "04077d6a-9fdd-4c79-b742-09a8d5c022eb"
             }
           }
         ],
         "actions": [
           {
-            "type": "OpenApiConnection",
-            "swaggerOperationId": "AnalyzeImageV2",
-            "metadata": {
-              "operationMetadataId": "82b95160-9c96-4507-ad8c-c688ea95c2b1"
-            }
-          },
-          {
-            "type": "Compose",
-            "metadata": {
-              "operationMetadataId": "cbd09106-eb7a-4743-b553-8b11cd09a90c"
-            }
-          },
-          {
-            "type": "InitializeVariable",
-            "metadata": {
-              "operationMetadataId": "818f9da8-8ebf-4081-8d7b-8fe37470cd57"
-            }
-          },
-          {
-            "type": "OpenApiConnection",
-            "swaggerOperationId": "HttpRequest",
-            "metadata": {
-              "operationMetadataId": "0e9b2bf7-c52e-4b28-8351-2850a3373186"
-            }
-          },
-          {
-            "type": "ParseJson",
-            "metadata": {
-              "operationMetadataId": "7d758c3f-f603-44d0-94b6-26cb08590fb3"
-            }
-          },
-          {
-            "type": "OpenApiConnection",
-            "swaggerOperationId": "PatchFileItem",
-            "metadata": {
-              "operationMetadataId": "c1a801a8-1f96-498a-a356-82c9d0dd8188"
-            }
+            "type": "InitializeVariable"
           }
         ]
       },
       "creator": {
-        "tenantId": "00000000-0000-0000-0000-000000000000",
-        "objectId": "e1251b10-1ba4-49e3-b35a-933e3f21772b",
-        "userId": "e1251b10-1ba4-49e3-b35a-933e3f21772b",
+        "tenantId": "e1dd4023-a656-480a-8a0e-c1b1eec51e1d",
+        "objectId": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
+        "userId": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
         "userType": "ActiveDirectory"
       },
-      "installationStatus": "NotApplicable",
+      "flowTriggerUri": "https://europe-002.azure-apim.net:443/apim/logicflows/A18E89D14C7541E49517E90AEDC079BE-5FA12B1209B98E3B/triggers/manual/run?api-version=2016-06-01",
+      "installationStatus": "Installed",
       "provisioningMethod": "FromDefinition",
       "flowFailureAlertSubscribed": true,
-      "referencedResources": [
-        {
-          "service": "sharepoint",
-          "resource": {
-            "site": "https://contoso.sharepoint.com/sites/contosoHome"
-          },
-          "referencers": [
-            {
-              "referenceSourceType": "Triggers",
-              "operationId": "/providers/Microsoft.PowerApps/apis/shared_sharepointonline/apiOperations/OnNewFile"
-            },
-            {
-              "referenceSourceType": "Actions",
-              "operationId": "/providers/Microsoft.PowerApps/apis/shared_sharepointonline/apiOperations/HttpRequest"
-            }
-          ]
+      "referencedResources": [],
+      "licenseData": {
+        "performanceProfile": {
+          "throttles": {
+            "mode": "High"
+          }
         },
-        {
-          "service": "sharepoint",
-          "resource": {
-            "site": "https://contoso.sharepoint.com/sites/contosoHome",
-            "list": "13e0b5a3-f626-4272-a73b-a3e84978199b"
-          },
-          "referencers": [
-            {
-              "referenceSourceType": "Actions",
-              "operationId": "/providers/Microsoft.PowerApps/apis/shared_sharepointonline/apiOperations/PatchFileItem"
-            }
-          ]
-        }
-      ],
-      "isManaged": false
+        "flowLicenseName": "placeholder"
+      },
+      "isManaged": false,
+      "machineDescriptionData": {},
+      "flowOpenAiData": {
+        "isConsequential": false,
+        "isConsequentialFlagOverwritten": false
+      }
     },
-    "displayName": "My Flow",
+    "displayName": "TEST",
     "description": "",
-    "triggers": "OpenApiConnection",
-    "actions": "OpenApiConnection-AnalyzeImageV2, Compose, InitializeVariable, OpenApiConnection-HttpRequest, ParseJson, OpenApiConnection-PatchFileItem"
+    "triggers": "Request-Button",
+    "actions": "InitializeVariable"
   }
   ```
 

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>