@pnp/cli-microsoft365 7.2.0 → 7.3.0-beta.01256d2

package/docs/docs/cmd/teams/meeting/meeting-add.mdx

@@ -0,0 +1,283 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# teams meeting add
+
+Create a new online meeting
+
+## Usage
+
+```sh
+m365 teams meeting add [options]
+```
+
+## Options
+
+```md definition-list
+`-s, --startTime [startTime]`
+: The start time of the meeting. If not specified, the start time will be set to the current time.
+
+`-e, --endTime [endTime]`
+: The end time of the meeting. If not specified, the end time will be set to one hour after the start time.
+
+`--subject [subject]`
+: The subject of the meeting.
+
+`-p, --participantUserNames [participantUserNames]`
+: A comma-separated list of participant UPNs.
+
+`--organizerEmail [organizerEmail]`
+: The organizer's email address.
+
+`-r, --recordAutomatically`
+: When using this flag, the meeting will be recorded automatically.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+This command creates a standalone meeting that is not associated with any event on the user's calendar; therefore, meetings created via this command will not show on the user's calendar.
+
+:::
+
+To create an online meeting for a specific organizer, use the `organizerEmail` option along with app-only permissions. The application should have the _OnlineMeetings.ReadWrite.All_ permissions, and a special policy should be assigned to the user specified in the `organizerEmail` option. You can find more information on how to assign this policy to a user [here](https://learn.microsoft.com/en-us/graph/cloud-communication-online-meeting-application-access-policy).
+
+## Examples
+
+Create a new online meeting for the currently logged-in user, starting immediately and ending after one hour. 
+
+```sh
+m365 teams meeting add
+```
+
+Create a new online meeting for the currently logged-in user, with a specified start date and a duration of one hour.
+
+```sh
+m365 teams meeting add --startTime "2025-09-21T13:30:00Z"
+```
+
+Create a new online meeting for the currently logged-in user, with specified end date the current date as the start date.
+
+```sh
+m365 teams meeting add --endTime "2025-09-21T23:55:00Z"
+```
+
+Create a new online meeting for the currently logged-in user, with specified start and end dates.
+
+```sh
+m365 teams meeting add --startTime "2025-09-21T13:30:00Z" --endTime "2025-09-21T23:55:00Z"
+```
+
+Create a new online meeting for the currently logged-in user, with a specified subject.
+
+```sh
+m365 teams meeting add --startTime "2025-09-21T13:30:00Z" --endTime "2025-09-21T23:55:00Z" --subject "Test Subject"
+```
+
+Create a new online meeting for the currently logged-in user, with a specified subject and a list of participantUserNames.
+
+```sh
+m365 teams meeting add --subject "Test Subject" --participantUserNames "john.doe@contoso.com,olga.manager@contoso.com"
+```
+
+Create a new online meeting for the currently logged-in user, with a specified subject, a list of participantUserNames, and automatic meeting recording.
+
+```sh
+m365 teams meeting add --subject "Test Subject" --participantUserNames "john.doe@contoso.com,olga.manager@contoso.com" --recordAutomatically
+```
+
+Create a new online meeting for a selected organizer, with a specified subject, a list of participantUserNames, and automatic meeting recording. This option is available for app-only permissions.
+
+```sh
+m365 teams meeting add --organizerEmail "john.doe@contoso.com" --subject "Test Subject" --participantUserNames "olga.manager@contoso.com" --recordAutomatically
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "abc",
+    "creationDateTime": "2023-07-25T19:29:32.033109Z",
+    "startDateTime": "2023-07-17T03:00:00Z",
+    "endDateTime": "2023-07-17T04:00:00Z",
+    "joinUrl": "https://teams.microsoft.com/l/meetup-join/abc",
+    "joinWebUrl": "https://teams.microsoft.com/l/meetup-join/abc",
+    "meetingCode": "12345",
+    "subject": "Subject",
+    "isBroadcast": false,
+    "autoAdmittedUsers": "unknownFutureValue",
+    "outerMeetingAutoAdmittedUsers": null,
+    "isEntryExitAnnounced": false,
+    "allowedPresenters": "everyone",
+    "allowMeetingChat": "enabled",
+    "shareMeetingChatHistoryDefault": "none",
+    "allowTeamworkReactions": true,
+    "allowAttendeeToEnableMic": true,
+    "allowAttendeeToEnableCamera": true,
+    "recordAutomatically": false,
+    "anonymizeIdentityForRoles": [],
+    "capabilities": [],
+    "videoTeleconferenceId": null,
+    "externalId": null,
+    "iCalUid": null,
+    "meetingType": null,
+    "allowParticipantsToChangeName": false,
+    "allowRecording": true,
+    "allowTranscription": true,
+    "meetingMigrationMode": null,
+    "broadcastSettings": null,
+    "audioConferencing": null,
+    "meetingInfo": null,
+    "participants": {
+      "organizer": {
+        "upn": "john.doe@contoso.com",
+        "role": "presenter",
+        "identity": {
+          "application": null,
+          "device": null,
+          "user": {
+            "id": "12345678-1234-1234-1234-12345678",
+            "displayName": null,
+            "tenantId": "12345678-1234-1234-1234-12345678",
+            "identityProvider": "AAD"
+          }
+        }
+      },
+      "attendees": [
+        {
+          "upn": "adele.vance@contoso.com",
+          "role": "attendee",
+          "identity": {
+            "application": null,
+            "device": null,
+            "user": {
+              "id": "12345678-1234-1234-1234-12345678",
+              "displayName": null,
+              "tenantId": "12345678-1234-1234-1234-12345678,
+              "identityProvider": "AAD"
+            }
+          }
+        }
+      ]
+    },
+    "lobbyBypassSettings": {
+      "scope": "unknownFutureValue",
+      "isDialInBypassEnabled": false
+    },
+    "joinMeetingIdSettings": {
+      "isPasscodeRequired": true,
+      "joinMeetingId": "12345",
+      "passcode": "123456"
+    },
+    "chatInfo": {
+      "threadId": "abc",
+      "messageId": "0",
+      "replyChainMessageId": null
+    },
+    "joinInformation": {
+      "content": "textContent",
+      "contentType": "html"
+    },
+    "watermarkProtection": {
+      "isEnabledForContentSharing": false,
+      "isEnabledForVideo": false
+    }
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  allowAttendeeToEnableCamera   : true   
+  allowAttendeeToEnableMic      : true   
+  allowMeetingChat              : enabled
+  allowParticipantsToChangeName : false  
+  allowRecording                : true
+  allowTeamworkReactions        : true
+  allowTranscription            : true
+  allowedPresenters             : everyone
+  anonymizeIdentityForRoles     : []
+  audioConferencing             : null
+  autoAdmittedUsers             : everyoneInCompany
+  broadcastSettings             : null
+  capabilities                  : []
+  chatInfo                      : {"threadId":"19:meeting_ID@thread.v2","messageId":"0","replyChainMessageId":null}
+  chatRestrictions              : null
+  creationDateTime              : 2023-11-13T16:02:12.5012352Z
+  endDateTime                   : 2023-11-13T17:02:11.9711697Z
+  externalId                    : null
+  iCalUid                       : null
+  id                            : meetingID
+  isBroadcast                   : false
+  isEntryExitAnnounced          : true
+  joinInformation               : {"content":"data:text/html,htmlMessageTemplate","contentType":"html"}
+  joinMeetingIdSettings         : {"isPasscodeRequired":false,"joinMeetingId":"123456789012","passcode":null}
+  joinUrl                       : https://teams.microsoft.com/l/meetup-join/abc
+  joinWebUrl                    : https://teams.microsoft.com/l/meetup-join/abc
+  lobbyBypassSettings           : {"scope":"organization","isDialInBypassEnabled":false}
+  meetingCode                   : 123456789012
+  meetingInfo                   : null
+  meetingMigrationMode          : null
+  meetingType                   : null
+  outerMeetingAutoAdmittedUsers : null
+  participants                  : {"organizer":{"upn":"user@contoso.com","role":"presenter","identity":{"application":null,"device":null,"user":{"id":"12345678-1234-1234-1234-12345678","displayName":null,"tenantId":"12345678-1234-1234-1234-12345678","identityProvider":"AAD"}}},"attendees":[]}
+  recordAutomatically           : false
+  shareMeetingChatHistoryDefault: none
+  startDateTime                 : 2023-11-13T16:02:11.9711697Z
+  subject                       : null
+  videoTeleconferenceId         : null
+  watermarkProtection           : null
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,creationDateTime,startDateTime,endDateTime,joinUrl,meetingCode,isBroadcast,autoAdmittedUsers,joinWebUrl,isEntryExitAnnounced,allowedPresenters,allowAttendeeToEnableMic,allowAttendeeToEnableCamera,allowMeetingChat,shareMeetingChatHistoryDefault,allowTeamworkReactions,recordAutomatically,allowParticipantsToChangeName,allowTranscription,allowRecording
+meetingId,2023-11-13T16:03:03.5669316Z,2023-11-13T16:03:03.2213499Z,2023-11-13T17:03:03.2213499Z,https://teams.microsoft.com/l/meetup-join/abc,123456789012,,everyoneInCompany,https://teams.microsoft.com/l/meetup-join/abc,1,everyone,1,1,enabled,none,1,,,1,1
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # teams meeting add 
+
+  Date: 13/11/2023
+
+  ## meetingId
+
+  Property | Value
+  ---------|-------
+  id | meetingId
+  creationDateTime | 2023-11-13T16:03:57.6531542Z
+  startDateTime | 2023-11-13T16:03:56.8464734Z
+  endDateTime | 2023-11-13T17:03:56.8464734Z
+  joinUrl | https://teams.microsoft.com/l/meetup-join/abc
+  meetingCode | 123456789012
+  isBroadcast | false
+  autoAdmittedUsers | everyoneInCompany
+  joinWebUrl | https://teams.microsoft.com/l/meetup-join/abc
+  isEntryExitAnnounced | true
+  allowedPresenters | everyone
+  allowAttendeeToEnableMic | true
+  allowAttendeeToEnableCamera | true
+  allowMeetingChat | enabled
+  shareMeetingChatHistoryDefault | none
+  allowTeamworkReactions | true
+  recordAutomatically | false
+  allowParticipantsToChangeName | false
+  allowTranscription | true
+  allowRecording | true
+  ```
+
+  </TabItem>
+</Tabs>

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

@@ -17,9 +17,6 @@ m365 teams report deviceusagedistributionusercounts [options]
 ```md definition-list
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-
-`--outputFile [outputFile]`
-: Path to the file where the Microsoft Teams unique users by device type report should be stored in.
 ```
 
 <Global />

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

@@ -17,9 +17,6 @@ m365 teams report deviceusageusercounts [options]
 ```md definition-list
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-
-`--outputFile [outputFile]`
-: Path to the file where the Microsoft Teams daily unique users by device type report should be stored in.
 ```
 
 <Global />

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

@@ -20,9 +20,6 @@ m365 teams report deviceusageuserdetail [options]
 
 `-d, --date [date]`
 : The date for which you would like to view the users who performed any activity. Supported date format is `YYYY-MM-DD`.
-
-`--outputFile [outputFile]`
-: Path to the file where the Microsoft Teams device usage by user report should be stored in.
 ```
 
 <Global />

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

@@ -17,9 +17,6 @@ m365 teams report useractivitycounts [options]
 ```md definition-list
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-
-`--outputFile [outputFile]`
-: Path to the file where the Microsoft Teams activities by activity type report should be stored in.
 ```
 
 <Global />

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

@@ -17,9 +17,6 @@ m365 teams report useractivityusercounts [options]
 ```md definition-list
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-
-`--outputFile [outputFile]`
-: Path to the file where the Microsoft Teams users by activity type report should be stored in.
 ```
 
 <Global />

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

@@ -20,9 +20,6 @@ m365 teams report useractivityuserdetail [options]
 
 `-d, --date [date]`
 : The date for which you would like to view the users who performed any activity. Supported date format is `YYYY-MM-DD`. Specify the `date` or `period`, but not both.
-
-`--outputFile [outputFile]`
-: Path to the file where the Microsoft Teams user activity by user report should be stored in.
 ```
 
 <Global />

package/docs/docs/cmd/teams/user/user-app-remove.mdx

@@ -13,8 +13,11 @@ m365 teams user app remove [options]
 ## Options
 
 ```md definition-list
-`--id <id>`
-: The unique id of the app instance installed for the user.
+`--id [id]`
+: The unique id of the app instance installed for the user. Specify either `id` or `name`.
+
+`--name [name]`
+: Name of the app instance installed for the user. Specify either `id` or `name`.
 
 `--userId [userId]`
 : The ID of the user to uninstall the app for. Specify `userId` or `userName` but not both.
@@ -35,18 +38,24 @@ Do not use the ID from the manifest of the zip app package or the id from the Mi
 
 ## Examples
 
-Uninstall an app for the specified user.
+Uninstall an app by id for the specified user.
 
 ```sh
 m365 teams user app remove --id YzUyN2E0NzAtYTg4Mi00ODFjLTk4MWMtZWU2ZWZhYmE4NWM3IyM0ZDFlYTA0Ny1mMTk2LTQ1MGQtYjJlOS0wZDI4NTViYTA1YTY= --userId 2609af39-7775-4f94-a3dc-0dd67657e900
 ```
 
-Uninstall an app for the specified user using its UPN.
+Uninstall an app by id for the specified user using its UPN.
 
 ```sh
 m365 teams user app remove --id YzUyN2E0NzAtYTg4Mi00ODFjLTk4MWMtZWU2ZWZhYmE4NWM3IyM0ZDFlYTA0Ny1mMTk2LTQ1MGQtYjJlOS0wZDI4NTViYTA1YTY= --userName admin@contoso.com
 ```
 
+Uninstall an app by name for the specified user.
+
+```sh
+m365 teams user app remove --name HelloWorld --userId 2609af39-7775-4f94-a3dc-0dd67657e900
+```
+
 ## Response
 
 The command won't return a response on success.

package/docs/docs/cmd/tenant/report/report-activeusercounts.mdx

@@ -17,9 +17,6 @@ m365 tenant report activeusercounts [options]
 ```md definition-list
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-
-`--outputFile [outputFile]`
-: Path to the file where the Microsoft Teams daily unique users by device type report should be stored in.
 ```
 
 <Global />

package/docs/docs/cmd/tenant/report/report-activeuserdetail.mdx

@@ -20,9 +20,6 @@ m365 tenant report activeuserdetail [options]
 
 `-p, --period [period]`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-
-`--outputFile [outputFile]`
-: Path to the file where the report should be stored in.
 ```
 
 <Global />

package/docs/docs/cmd/tenant/report/report-servicesusercounts.mdx

@@ -17,9 +17,6 @@ m365 tenant report servicesusercounts [options]
 ```md definition-list
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-
-`--outputFile [outputFile]`
-: Path to the file where the report should be stored in.
 ```
 
 <Global />

package/docs/docs/cmd/yammer/report/report-activitycounts.mdx

@@ -17,9 +17,6 @@ m365 yammer report activitycounts [options]
 ```md definition-list
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-
-`--outputFile [outputFile]`
-: Path to the file where the report should be stored in
 ```
 
 <Global />

package/docs/docs/cmd/yammer/report/report-activityusercounts.mdx

@@ -17,9 +17,6 @@ m365 yammer report activityusercounts [options]
 ```md definition-list
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-
-`--outputFile [outputFile]`
-: Path to the file where the report should be stored in
 ```
 
 <Global />

package/docs/docs/cmd/yammer/report/report-activityuserdetail.mdx

@@ -20,9 +20,6 @@ m365 yammer report activityuserdetail [options]
 
 `-p, --period [period]`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-
-`--outputFile [outputFile]`
-: Path to the file where the report should be stored in
 ```
 
 <Global />

package/docs/docs/cmd/yammer/report/report-deviceusagedistributionusercounts.mdx

@@ -17,9 +17,6 @@ m365 yammer report deviceusagedistributionusercounts [options]
 ```md definition-list
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-
-`--outputFile [outputFile]`
-: Path to the file where the report should be stored in
 ```
 
 <Global />

package/docs/docs/cmd/yammer/report/report-deviceusageusercounts.mdx

@@ -17,9 +17,6 @@ m365 yammer report deviceusageusercounts [options]
 ```md definition-list
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-
-`--outputFile [outputFile]`
-: Path to the file where the report should be stored in
 ```
 
 <Global />

package/docs/docs/cmd/yammer/report/report-deviceusageuserdetail.mdx

@@ -20,9 +20,6 @@ m365 yammer report deviceusageuserdetail [options]
 
 `-d, --date [date]`
 : The date for which you would like to view the users who performed any activity. Supported date format is `YYYY-MM-DD`.
-
-`--outputFile [outputFile]`
-: Path to the file where the report should be stored in
 ```
 
 <Global />

package/docs/docs/cmd/yammer/report/report-groupsactivitycounts.mdx

@@ -17,9 +17,6 @@ m365 yammer report groupsactivitycounts [options]
 ```md definition-list
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-
-`--outputFile [outputFile]`
-: Path to the file where the report should be stored in
 ```
 
 <Global />

package/docs/docs/cmd/yammer/report/report-groupsactivitydetail.mdx

@@ -20,9 +20,6 @@ m365 yammer report groupsactivitydetail [options]
 
 `-d, --date [date]`
 : The date for which you would like to view the users who performed any activity. Supported date format is `YYYY-MM-DD`.
-
-`--outputFile [outputFile]`
-: Path to the file where the report should be stored in
 ```
 
 <Global />

package/docs/docs/cmd/yammer/report/report-groupsactivitygroupcounts.mdx

@@ -17,9 +17,6 @@ m365 yammer report groupsactivitygroupcounts [options]
 ```md definition-list
 `-p, --period <period>`
 : The length of time over which the report is aggregated. Supported values `D7`, `D30`, `D90`, `D180`.
-
-`--outputFile [outputFile]`
-: Path to the file where the report should be stored in
 ```
 
 <Global />

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "7.2.0",
+  "version": "7.3.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@pnp/cli-microsoft365",
-      "version": "7.2.0",
+      "version": "7.3.0",
       "license": "MIT",
       "dependencies": {
         "@azure/msal-common": "^13.2.1",
@@ -47,7 +47,7 @@
         "microsoft365": "dist/index.js"
       },
       "devDependencies": {
-        "@microsoft/microsoft-graph-types": "^2.38.0",
+        "@microsoft/microsoft-graph-types": "^2.40.0",
         "@types/adm-zip": "^0.5.4",
         "@types/jmespath": "^0.15.2",
         "@types/json-to-ast": "^2.1.4",
@@ -506,9 +506,9 @@
       "integrity": "sha512-2IHAOaLauc8qaAitvWS+U931T+ze+7MNWrDHY47IENP5y2UA0vqJDu67kWZDdpCN1fFC77sfgfB+HV7SrKshnQ=="
     },
     "node_modules/@microsoft/microsoft-graph-types": {
-      "version": "2.38.0",
-      "resolved": "https://registry.npmjs.org/@microsoft/microsoft-graph-types/-/microsoft-graph-types-2.38.0.tgz",
-      "integrity": "sha512-EXpTf/TFUb0EfBXiQ0rTmZf6fRgBn73lNfYdU2QKvqiMPQD/Cs2Gt+VmWVtK19F9Mf5Mt4bDTu5Ft0TGXOF8rA==",
+      "version": "2.40.0",
+      "resolved": "https://registry.npmjs.org/@microsoft/microsoft-graph-types/-/microsoft-graph-types-2.40.0.tgz",
+      "integrity": "sha512-1fcPVrB/NkbNcGNfCy+Cgnvwxt6/sbIEEFgZHFBJ670zYLegENYJF8qMo7x3LqBjWX2/Eneq5BVVRCLTmlJN+g==",
       "dev": true
     },
     "node_modules/@microsoft/recognizers-text-data-types-timex-expression": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "7.2.0",
+  "version": "7.3.0-beta.01256d2",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",
@@ -235,6 +235,7 @@
     "van Hunen, Erwin <erwin.van.hunen@outlook.com>",
     "van Iersel, Cas <cvaniersel@portiva.nl>",
     "van Rousselt, Rick <rick.vanrousselt@outlook.com>",
+    "Velez, Gustavo <gustavo@gavd.net>",
     "Velliah, Joseph <joseph@sprider.org>",
     "Verbeeck, Mathijs <verbeeckmathijs@gmail.com>",
     "Waegebaert, Jasey <38426621+Jwaegebaert@users.noreply.github.com>",
@@ -276,7 +277,7 @@
     "yaml": "^2.3.4"
   },
   "devDependencies": {
-    "@microsoft/microsoft-graph-types": "^2.38.0",
+    "@microsoft/microsoft-graph-types": "^2.40.0",
     "@types/adm-zip": "^0.5.4",
     "@types/jmespath": "^0.15.2",
     "@types/json-to-ast": "^2.1.4",
@@ -300,4 +301,4 @@
     "sinon": "^15.2.0",
     "source-map-support": "^0.5.21"
   }
-}
+}