@pnp/cli-microsoft365 9.0.0-beta.e69e8d0 → 9.0.0

package/docs/docs/cmd/setup.mdx

@@ -18,6 +18,9 @@ m365 setup [options]
 
 `--scripting`
 : Configure CLI for Microsoft 365 for use in scripts without prompting for additional information.
+
+`--skipApp`
+: Skip configuring an Entra app for use with CLI for Microsoft 365.
 ```
 
 <Global />
@@ -28,6 +31,10 @@ The `m365 setup` command is a wizard that helps you configure the CLI for Micros
 
 The command will ask you the following questions:
 
+- _CLI for Microsoft 365 requires a Microsoft Entra app. Do you want to create a new app registration or use an existing one?_
+
+  You can choose between using an existing Entra app or creating a new one. If you choose to create a new app, the CLI will ask you to choose between a minimal and a full set of permissions. It then signs in as Azure CLI to your tenant, creates a new app registration, and stores its information in the CLI configuration.
+
 - _How do you plan to use the CLI?_
 
   You can choose between **interactive** and **scripting** use. In interactive mode, the CLI for Microsoft 365 will prompt you for additional information when needed, automatically open links browser, automatically show help on errors and show spinners. In **scripting** mode, the CLI will not use interactivity to prevent blocking your scripts.
@@ -71,24 +78,30 @@ The `m365 setup` command uses the following presets:
 
 ## Examples
 
-Configure CLI for Microsoft based on your preferences interactively
+Configure CLI for Microsoft 365 based on your preferences interactively
 
 ```sh
 m365 setup
 ```
 
-Configure CLI for Microsoft for interactive use without prompting for additional information
+Configure CLI for Microsoft 365 for interactive use without prompting for additional information
 
 ```sh
 m365 setup --interactive
 ```
 
-Configure CLI for Microsoft for use in scripts without prompting for additional information
+Configure CLI for Microsoft 365 for use in scripts without prompting for additional information
 
 ```sh
 m365 setup --scripting
 ```
 
+Configure CLI for Microsoft 365 without setting up an Entra app
+
+```sh
+m365 setup --skipApp
+```
+
 ## Response
 
 The command won't return a response on success.

package/docs/docs/cmd/spfx/project/project-github-workflow-add.mdx

@@ -14,25 +14,28 @@ m365 spfx project github workflow add [options]
 
 ```md definition-list
 `-n, --name [name]`
-: Name of the workflow that will be created. If none is specified a default name will be used 'Deploy Solution ${name of sppkg file}'.
+: Name of the workflow that will be created. If none is specified a default name will be used 'Deploy Solution ${name of sppkg file}'
 
 `-b, --branchName [branchName]`
-: Specify the branch name which should trigger the workflow on push. If none is specified a default will be used which is 'main'.
+: Specify the branch name which should trigger the workflow on push. If none is specified a default will be used which is 'main'
 
 `-m, --manuallyTrigger`
-: When specified a manual trigger option will be added to the workflow: `workflow_dispatch`.
+: When specified a manual trigger option will be added to the workflow: `workflow_dispatch`
 
 `-l, --loginMethod [loginMethod]`
-: Specify the login method used for the login action. Possible options are: `user`, `application`. Default `application`.
+: Specify the login method used for the login action. Possible options are: `user`, `application`. Default `application`'
 
 `-s, --scope [scope]`
-: Scope of the app catalog: `tenant`, `sitecollection`. Default is `tenant`.
+: Scope of the app catalog: `tenant`, `sitecollection`. Default is `tenant`
 
 `-u, --siteUrl [siteUrl]`
-: The URL of the site collection where the solution package will be added. Required if scope is set to `sitecollection`.
+: The URL of the site collection where the solution package will be added. Required if scope is set to `sitecollection`
 
 `--skipFeatureDeployment`
-: When specified and the app supports tenant-wide deployment, deploy it to the whole tenant.
+: When specified and the app supports tenant-wide deployment, deploy it to the whole tenant
+
+`--overwrite`
+: When specified the workflow will overwrite the existing .sppkg if it is already deployed in the app catalog.
 ```
 
 <Global />
@@ -56,8 +59,6 @@ For the `user` login method you will need to create the following secrets in Git
 
 This method is perfect to test your workflow, in a dev context, for personal usage. It will not work for accounts with MFA.
 
-The workflow will overwrite the existing .sppkg if it is already deployed in the app catalog. Overwriting your sppkg file on every deployment is required to make continuous delivery of the latest version of your app which is the aim of the continuous delivery pipeline.
-
 :::info
 
 Run this command in the SPFx solution folder.
@@ -66,7 +67,7 @@ Run this command in the SPFx solution folder.
     
 ## Examples
 
-Adds a GitHub workflow for a SharePoint Framework project with `application` login method triggered on push to main.
+Adds a GitHub workflow for a SharePoint Framework project with `application` login method triggered on push to main
 
 ```sh
 m365 spfx project github workflow add 
@@ -78,7 +79,7 @@ Adds a GitHub workflow for a SharePoint Framework project with `user` login meth
 m365 spfx project github workflow add --manuallyTrigger --loginMethod "user"
 ```
 
-Adds a GitHub workflow for a SharePoint Framework project with deployment to a site collection app catalog.
+Adds a GitHub workflow for a SharePoint Framework project with deployment to a site collection app catalog
 
 ```sh
 m365 spfx project github workflow add --scope "sitecollection" --siteUrl "https://some.sharepoint.com/sites/someSite"

package/docs/docs/cmd/spo/file/file-copy.mdx

@@ -1,6 +1,4 @@
 import Global from '/docs/cmd/_global.mdx';
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
 
 # spo file copy
 
@@ -33,14 +31,11 @@ m365 spo file copy [options]
 `--nameConflictBehavior [nameConflictBehavior]`
 : Behavior when a document with the same name is already present at the destination. Allowed values: `fail`, `replace`, `rename`. Defaults to `fail`.
 
+`--resetAuthorAndCreated`
+: Use this option to clear the author and created date. When not specified, the values from the source file are used.
+
 `--bypassSharedLock`
 : This indicates whether a file with a share lock can still be copied. Use this option to copy a file that is locked.
-
-`--ignoreVersionHistory`
-: Only copy the most recent version of the file and ignore the version history.
-
-`--skipWait`
-: Don't wait for the copy operation to complete.
 ```
 
 <Global />
@@ -48,6 +43,7 @@ m365 spo file copy [options]
 ## Remarks
 
 When you specify a value for `nameConflictBehavior`, consider the following:
+
 - `fail` will throw an error when the destination file already exists.
 - `replace` will replace the destination file if it already exists.
 - `rename` will add a suffix (e.g. Document1.pdf) when the destination file already exists.
@@ -60,16 +56,16 @@ Copy a file by server-relative URL to a document library in another site collect
 m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceUrl "/sites/project/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents"
 ```
 
-Copy a file by site-relative URL to a document library in another site collection and ignore the file history.
+Copy a file by site-relative URL to a document library in another site collection and clear the author and created date.
 
 ```sh
-m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --ignoreVersionHistory
+m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --resetAuthorAndCreated
 ```
 
-Copy file by sourceId (UniqueId) to a document library in another site collection and rename the file (without specifying the file extension).
+Copy file by sourceId (UniqueId) to a document library in another site collection and rename the file.
 
 ```sh
-m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceId "b2307a39-e878-458b-bc90-03bc578531d6" --targetUrl "/sites/IT/Shared Documents" --newName "Report"
+m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceId "b2307a39-e878-458b-bc90-03bc578531d6" --targetUrl "/sites/IT/Shared Documents" --newName "Report.pdf"
 ```
 
 Copy file by sourceId (UniqueId) to a document library in another site collection with a new name, rename the file if it already exists.
@@ -80,111 +76,8 @@ m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourc
 
 ## Response
 
-### Standard Response
-
-<Tabs>
-  <TabItem value="JSON">
-
-  ```json
-  {
-    "CheckInComment": "",
-    "CheckOutType": 2,
-    "ContentTag": "{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1",
-    "CustomizedPageStatus": 0,
-    "ETag": "\"{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1\"",
-    "Exists": true,
-    "IrmEnabled": false,
-    "Length": "5987",
-    "Level": 1,
-    "LinkingUri": null,
-    "LinkingUrl": "",
-    "MajorVersion": 1,
-    "MinorVersion": 0,
-    "Name": "Test1.docx",
-    "ServerRelativeUrl": "/sites/project-x/documents/Test1.docx",
-    "TimeCreated": "2022-10-30T10:16:18Z",
-    "TimeLastModified": "2022-10-30T10:16:18Z",
-    "Title": null,
-    "UIVersion": 512,
-    "UIVersionLabel": "1.0",
-    "UniqueId": "b2307a39-e878-458b-bc90-03bc578531d6"
-  }
-  ```
-
-  </TabItem>
-  <TabItem value="Text">
-
-  ```text
-  CheckInComment      :
-  CheckOutType        : 2
-  ContentTag          : {03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1
-  CustomizedPageStatus: 0
-  ETag                : "{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1"
-  Exists              : true
-  IrmEnabled          : false
-  Length              : 5987
-  Level               : 1
-  LinkingUri          : null
-  LinkingUrl          :
-  MajorVersion        : 1
-  MinorVersion        : 0
-  Name                : Test1.docx
-  ServerRelativeUrl   : /sites/project-x/documents/Test1.docx
-  TimeCreated         : 2022-10-30T10:16:18Z
-  TimeLastModified    : 2022-10-30T10:16:18Z
-  Title               : null
-  UIVersion           : 512
-  UIVersionLabel      : 1.0
-  UniqueId            : b2307a39-e878-458b-bc90-03bc578531d6
-  ```
-
-  </TabItem>
-  <TabItem value="CSV">
-
-  ```csv
-  CheckInComment,CheckOutType,ContentTag,CustomizedPageStatus,ETag,Exists,IrmEnabled,Length,Level,LinkingUri,LinkingUrl,MajorVersion,MinorVersion,Name,ServerRelativeUrl,TimeCreated,TimeLastModified,Title,UIVersion,UIVersionLabel,UniqueId
-  ,2,"{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1",0,"""{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1""",1,,5987,1,,,1,0,Test1.docx,/sites/project-x/documents/Test1.docx,2022-10-30T10:16:18Z,2022-10-30T10:16:18Z,,512,1.0,b2307a39-e878-458b-bc90-03bc578531d6
-  ```
-
-  </TabItem>
-  <TabItem value="Markdown">
-
-  ```md
-  # spo file copy --webUrl "https://contoso.sharepoint.com/sites/IT" --sourceUrl "/Shared Documents/Document.docx" --targetUrl "/sites/project-x/Shared Documents"
-
-  Date: 10/3/2023
-
-  ## b2307a39-e878-458b-bc90-03bc578531d6
-
-  Property | Value
-  ---------|-------
-  CheckInComment |
-  CheckOutType | 2
-  ContentTag | {03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1
-  CustomizedPageStatus | 0
-  ETag | "{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1"
-  Exists | true
-  ExistsAllowThrowForPolicyFailures | true
-  IrmEnabled | false
-  Length | 5987
-  Level | 1
-  LinkingUri | https://contoso.sharepoint.com/sites/project-x/shared%20documents/Document.docx?d=w59d4e6fcf6f94ce78bea0273cedb1a19
-  LinkingUrl | https://contoso.sharepoint.com/sites/project-x/shared documents/Document.docx?d=w59d4e6fcf6f94ce78bea0273cedb1a19
-  MajorVersion | 1
-  MinorVersion | 0
-  Name | Document.docx
-  ServerRelativeUrl | /sites/project-x/shared documents/Document.docx
-  TimeCreated | 2023-05-23T09:51:34Z
-  TimeLastModified | 2023-05-23T10:13:01Z
-  Title |
-  UIVersion | 1536
-  UIVersionLabel | 1.0
-  UniqueId | b2307a39-e878-458b-bc90-03bc578531d6
-  ```
-
-  </TabItem>
-</Tabs>
-
-### `skipWait` response
-
 The command won't return a response on success.
+
+## More information
+
+- Copy items from a SharePoint document library: [https://support.office.com/en-us/article/move-or-copy-items-from-a-sharepoint-document-library-00e2f483-4df3-46be-a861-1f5f0c1a87bc](https://support.office.com/en-us/article/move-or-copy-items-from-a-sharepoint-document-library-00e2f483-4df3-46be-a861-1f5f0c1a87bc)

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

@@ -10,6 +10,12 @@ Updates a folder
 m365 spo folder set [options]
 ```
 
+## Alias
+
+```sh
+m365 spo folder rename [options]
+```
+
 ## Options
 
 ```md definition-list

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

@@ -126,7 +126,8 @@ m365 spo list list --webUrl https://contoso.sharepoint.com/sites/project-x --fil
       "ParserDisabled": false,
       "ServerTemplateCanCreateFolders": false,
       "TemplateFeatureId": "00000000-0000-0000-0000-000000000000",
-      "Title": "Theme Gallery"
+      "Title": "Theme Gallery",
+      "Url": "/_catalogs/theme"
     }
   ]
   ```
@@ -135,17 +136,17 @@ m365 spo list list --webUrl https://contoso.sharepoint.com/sites/project-x --fil
   <TabItem value="Text">
 
   ```text
-  Id                                    Title
+  Id                                    Url
   ------------------------------------  ----------------
-  66e5148c-7060-4479-88e7-636d79579148  Theme Gallery
+  66e5148c-7060-4479-88e7-636d79579148  /_catalogs/theme
   ```
 
   </TabItem>
   <TabItem value="CSV">
 
   ```csv
-  Id,Title
-  66e5148c-7060-4479-88e7-636d79579148,Theme Gallery
+  Id,Url
+  Theme Gallery,/_catalogs/theme,66e5148c-7060-4479-88e7-636d79579148
   ```
 
   </TabItem>
@@ -210,6 +211,7 @@ m365 spo list list --webUrl https://contoso.sharepoint.com/sites/project-x --fil
   ServerTemplateCanCreateFolders | true
   TemplateFeatureId | 00000000-0000-0000-0000-000000000000
   Title | Theme Gallery
+  Url | //\_catalogs/theme
   ```
 
   </TabItem>

package/docs/docs/cmd/spo/site/site-appcatalog-remove.mdx

@@ -14,10 +14,7 @@ m365 spo site appcatalog remove [options]
 
 ```md definition-list
 `-u, --siteUrl <siteUrl>`
-: URL of the site collection containing the app catalog to disable.
-
-`-f, --force`
-: Don't prompt for confirmation.
+: URL of the site collection containing the app catalog to disable
 ```
 
 <Global />
@@ -34,18 +31,12 @@ To use this command you have to have permissions to access the tenant admin site
     
 ## Examples
 
-Remove the site collection app catalog from specified site.
+Remove the site collection app catalog from specified site
 
 ```sh
 m365 spo site appcatalog remove --siteUrl https://contoso.sharepoint/sites/site
 ```
 
-Remove the site collection app catalog from specified site without prompting for confirmation.
-
-```sh
-m365 spo site appcatalog remove --siteUrl https://contoso.sharepoint/sites/site --force
-```
-
 ## Response
 
 The command won't return a response on success.

package/docs/docs/cmd/spo/site/site-remove.mdx

@@ -22,6 +22,9 @@ m365 spo site remove [options]
 `--fromRecycleBin`
 : Set to remove the site from the recycle bin.
 
+`--wait`
+: (deprecated) Wait for the site to be removed before completing the command.
+
 `-f, --force`
 : Don't prompt for confirmation.
 ```

package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-restore.mdx

@@ -17,6 +17,9 @@ m365 spo tenant recyclebinitem restore [options]
 ```md definition-list
 `-u, --siteUrl <siteUrl>`
 : URL of the site.
+
+`--wait`
+: (deprecated) Wait for the site collection to be restored before completing the command.
 ```
 
 <Global />
@@ -31,7 +34,7 @@ To use this command you must be a Global or SharePoint administrator.
     
 ## Examples
 
-Restores a deleted site collection from tenant recycle bin.
+Restore a deleted site collection from tenant recycle bin
 
 ```sh
 m365 spo tenant recyclebinitem restore --siteUrl https://contoso.sharepoint.com/sites/team
@@ -39,4 +42,48 @@ m365 spo tenant recyclebinitem restore --siteUrl https://contoso.sharepoint.com/
 
 ## Response
 
-The command won't return a response on success.
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "HasTimedout": false,
+    "IsComplete": true,
+    "PollingInterval": 15000
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  HasTimedout    : false
+  IsComplete     : true
+  PollingInterval: 15000
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  HasTimedout,IsComplete,PollingInterval
+  ,1,15000
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # spo tenant recyclebinitem restore --siteUrl "https://contoso.sharepoint.com/teams/team1"
+
+  Date: 2023-06-22
+
+  Property | Value
+  ---------|-------
+  HasTimedout | false
+  IsComplete | true
+  PollingInterval | 15000
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/teams/message/message-remove.mdx

@@ -36,7 +36,6 @@ m365 teams message remove [options]
 
 ## Remarks
 
-You can only remove Microsoft Teams messages that you created yourself.  
 
 :::info
 
@@ -44,6 +43,8 @@ This command does only support delegated permissions.
 
 :::
 
+You can only remove Microsoft Teams messages that you created yourself.
+
 ## Examples
 
 Remove a message by using IDs

package/docs/docs/cmd/teams/message/message-restore.mdx

@@ -0,0 +1,62 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# teams message restore
+
+Restores a deleted message from a channel in a Microsoft Teams team
+
+## Usage
+
+```sh
+m365 teams message restore [options]
+```
+
+## Options
+
+```md definition-list
+`--teamId [teamId]`
+: ID of the Microsoft Teams team. Specify either `teamId` or `teamName` but not both.
+
+`--teamName [teamName]`
+:	Name of the Microsoft Teams team. Specify either `teamId` or `teamName` but not both.
+
+`--channelId [channelId]`
+:	Channel ID of the Microsoft Teams team. Specify either `channelId` or `channelName` but not both.
+
+`--channelName [channelName]`
+:	Channel name of the Microsoft Teams team. Specify either `channelId` or `channelName` but not both.
+
+`-i, --id <id>`
+:	The ID of the Teams message.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+This command does only support delegated permissions.
+
+:::
+
+You can only restore Microsoft Teams messages that you created yourself.
+
+## Examples
+
+Restore a deleted message by using IDs
+
+```sh
+m365 teams message restore --teamId 5f5d7b71-1161-44d8-bcc1-3da710eb4171 --channelId 19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2 --id 1540747442203
+```
+
+Restore a deleted message by using display names
+
+```sh
+m365 teams message restore --teamName Marketing --channelName Branding --id 1540747442203
+```
+
+## Response
+
+The command won't return a response on success.

package/npm-shrinkwrap.json

@@ -28,7 +28,6 @@
         "easy-table": "^1.2.0",
         "jmespath": "^0.16.0",
         "json-to-ast": "^2.1.0",
-        "minimist": "^1.2.8",
         "node-forge": "^1.3.1",
         "omelette": "^0.4.17",
         "open": "^10.1.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "9.0.0-beta.e69e8d0",
+  "version": "9.0.0",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",
@@ -271,7 +271,6 @@
     "easy-table": "^1.2.0",
     "jmespath": "^0.16.0",
     "json-to-ast": "^2.1.0",
-    "minimist": "^1.2.8",
     "node-forge": "^1.3.1",
     "omelette": "^0.4.17",
     "open": "^10.1.0",
@@ -312,4 +311,4 @@
     "sinon": "^18.0.0",
     "source-map-support": "^0.5.21"
   }
-}
+}