@pnp/cli-microsoft365 9.0.0-beta.2f8dd1e → 9.0.0-beta.d6b190a

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/spe/containertype/containertype-list.mdx

@@ -0,0 +1,131 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# Container Types list
+
+Retrieves a list of Container Types created for a SharePoint Embedded Application
+
+## Usage
+
+```sh
+m365 containertype list [options]
+```
+
+## Options
+
+<Global />
+
+## Examples
+
+Retrieves a list of Container Types created for a SharePoint Embedded Application from the tenant.
+
+```sh
+m365 containertype list
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [{
+    "_ObjectType_": "Microsoft.Online.SharePoint.TenantAdministration.SPContainerTypeProperties",
+    "ApplicationRedirectUrl": null,
+    "AzureSubscriptionId": "/Guid(00000000-0000-0000-0000-000000000000)/",
+    "ContainerTypeId": "/Guid(073269af-f1d2-042d-2ef5-5bdd6ac83115)/",
+    "CreationDate": null,
+    "DisplayName": "test1",
+    "ExpiryDate": null,
+    "IsBillingProfileRequired": true,
+    "OwningAppId": "/Guid(df4085cc-9a38-4255-badc-5c5225610475)/",
+    "OwningTenantId": "/Guid(00000000-0000-0000-0000-000000000000)/",
+    "Region": null,
+    "ResourceGroup": null,
+    "SPContainerTypeBillingClassification": 0
+  },
+   {
+    "_ObjectType_": "Microsoft.Online.SharePoint.TenantAdministration.SPContainerTypeProperties",
+    "ApplicationRedirectUrl": null,
+    "AzureSubscriptionId": "/Guid(00000000-0000-0000-0000-000000000000)/",
+    "ContainerTypeId": "/Guid(3ec7c59d-ef31-0752-1ab5-5c343a5e8557)/",
+    "CreationDate": null,
+    "DisplayName": "SharePoint Embedded Free Trial Container Type",
+    "ExpiryDate": null,
+    "IsBillingProfileRequired": true,
+    "OwningAppId": "/Guid(e6b529fe-84db-412a-8e9c-5bbb75f7b037)/",
+    "OwningTenantId": "/Guid(00000000-0000-0000-0000-000000000000)/",
+    "Region": null,
+    "ResourceGroup": null,
+    "SPContainerTypeBillingClassification": 1
+  }]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+ContainerTypeId                               DisplayName                                    OwningAppId                                 
+--------------------------------------------  ---------------------------------------------  --------------------------------------------
+/Guid(073269af-f1d2-042d-2ef5-5bdd6ac83115)/  test1                                          /Guid(df4085cc-9a38-4255-badc-5c5225610475)/
+/Guid(880ab3bd-5b68-01d4-3744-01a7656cf2ba)/  test1                                          /Guid(50785fde-3082-47ac-a36d-06282ac5c7da)/
+/Guid(3ec7c59d-ef31-0752-1ab5-5c343a5e8557)/  SharePoint Embedded Free Trial Container Type  /Guid(e6b529fe-84db-412a-8e9c-5bbb75f7b037)/
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  _ObjectType_,ApplicationRedirectUrl,AzureSubscriptionId,ContainerTypeId,CreationDate,DisplayName,ExpiryDate,IsBillingProfileRequired,OwningAppId,OwningTenantId,Region,ResourceGroup,SPContainerTypeBillingClassification
+  Microsoft.Online.SharePoint.TenantAdministration.SPContainerTypeProperties,,/Guid(00000000-0000-0000-0000-000000000000)/,/Guid(073269af-f1d2-042d-2ef5-5bdd6ac83115)/,,test1,,1,/Guid(df4085cc-9a38-4255-badc-5c5225610475)/,/Guid(00000000-0000-0000-0000-000000000000)/,,,0
+  Microsoft.Online.SharePoint.TenantAdministration.SPContainerTypeProperties,,/Guid(00000000-0000-0000-0000-000000000000)/,/Guid(3ec7c59d-ef31-0752-1ab5-5c343a5e8557)/,,SharePoint Embedded Free Trial Container Type,,1,/Guid(e6b529fe-84db-412a-8e9c-5bbb75f7b037)/,/Guid(00000000-0000-0000-0000-000000000000)/,,,1
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spe containertype list 
+
+  Date: 5/11/2024
+
+  ## test1
+
+  Property | Value
+  ---------|-------
+  \_ObjectType\_ | Microsoft.Online.SharePoint.TenantAdministration.SPContainerTypeProperties
+  AzureSubscriptionId | /Guid(00000000-0000-0000-0000-000000000000)/
+  ContainerTypeId | /Guid(073269af-f1d2-042d-2ef5-5bdd6ac83115)/
+  DisplayName | test1
+  IsBillingProfileRequired | true
+  OwningAppId | /Guid(df4085cc-9a38-4255-badc-5c5225610475)/
+  OwningTenantId | /Guid(00000000-0000-0000-0000-000000000000)/
+  SPContainerTypeBillingClassification | 0
+
+  ## SharePoint Embedded Free Trial Container Type
+
+  Property | Value
+  ---------|-------
+  \_ObjectType\_ | Microsoft.Online.SharePoint.TenantAdministration.SPContainerTypeProperties
+  AzureSubscriptionId | /Guid(00000000-0000-0000-0000-000000000000)/
+  ContainerTypeId | /Guid(3ec7c59d-ef31-0752-1ab5-5c343a5e8557)/
+  DisplayName | SharePoint Embedded Free Trial Container Type
+  IsBillingProfileRequired | true
+  OwningAppId | /Guid(e6b529fe-84db-412a-8e9c-5bbb75f7b037)/
+  OwningTenantId | /Guid(00000000-0000-0000-0000-000000000000)/
+  SPContainerTypeBillingClassification | 1
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+In SharePoint Embedded, all files and documents are stored in Containers, and each Container is identified by a Container Type.
+
+Container Type is a property stamped on every Container instance. Each Container Type is owned by one Application, and each Application can own only one Container Type.
+
+The primary function of a Container Type is to manage the application workload that can access the Containers. Container Type defines the access permissions an Application has towards all Containers of that type, including create, read, write, delete containers; manage container permissions, etc.
+
+More information about SharePoint Embedded and the limits can be found at the following location: [SharePoint Embedded](https://learn.microsoft.com/en-us/sharepoint/dev/embedded/concepts/app-concepts/containertypes#sharepoint-embedded-trial-container-types)