@pnp/cli-microsoft365 8.1.0-beta.a4eba60 → 9.0.0-beta.0d94b15

package/docs/docs/cmd/spo/app/app-uninstall.mdx

@@ -43,7 +43,7 @@ m365 spo app uninstall --id b2307a39-e878-458b-bc90-03bc578531d6 --siteUrl https
 Uninstall the app with the specified ID from the specified site without prompting for confirmation.
 
 ```sh
-m365 spo app uninstall --id b2307a39-e878-458b-bc90-03bc578531d6 --siteUrl https://contoso.sharepoint.com
+m365 spo app uninstall --id b2307a39-e878-458b-bc90-03bc578531d6 --siteUrl https://contoso.sharepoint.com --force
 ```
 
 Uninstall the app with the specified ID from the specified site where the app is deployed to the site collection app catalog.

package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-get.mdx

@@ -93,7 +93,10 @@ m365 spo applicationcustomizer get --id 14125658-a9bc-4ddf-9c75-1b5767c9a337 --w
     "Name": "{4a428b32-08cf-45c7-9986-17585af38806}",
     "RegistrationId": null,
     "RegistrationType": 0,
-    "Rights": "{\"High\":\"0\",\"Low\":\"0\"}",
+    "Rights": {
+      "High": 0,
+      "Low": 0
+    },
     "Scope": "Web",
     "ScriptBlock": null,
     "ScriptSrc": null,
@@ -120,7 +123,6 @@ m365 spo applicationcustomizer get --id 14125658-a9bc-4ddf-9c75-1b5767c9a337 --w
   Name                         : {4a428b32-08cf-45c7-9986-17585af38806}
   RegistrationId               : null
   RegistrationType             : 0
-  Rights                       : {"High":"0","Low":"0"}
   Scope                        : Web
   ScriptBlock                  : null
   ScriptSrc                    : null
@@ -134,8 +136,8 @@ m365 spo applicationcustomizer get --id 14125658-a9bc-4ddf-9c75-1b5767c9a337 --w
   <TabItem value="CSV">
 
   ```csv
-  ClientSideComponentId,ClientSideComponentProperties,CommandUIExtension,Description,Group,HostProperties,Id,ImageUrl,Location,Name,RegistrationId,RegistrationType,Rights,Scope,ScriptBlock,ScriptSrc,Sequence,Title,Url,VersionOfUserCustomAction
-  9a8b100c-246b-4592-9454-67826523e159,"{""testMessage"":""Test message""}",,,,,4a428b32-08cf-45c7-9986-17585af38806,,ClientSideExtension.ApplicationCustomizer,{4a428b32-08cf-45c7-9986-17585af38806},,0,"{""High"":""0"",""Low"":""0""}",Web,,,65536,HelloWorld,,1.0.1.0
+  ClientSideComponentId,ClientSideComponentProperties,CommandUIExtension,Description,Group,Id,ImageUrl,Location,Name,RegistrationId,RegistrationType,Scope,ScriptBlock,ScriptSrc,Sequence,Title,Url,VersionOfUserCustomAction
+  9a8b100c-246b-4592-9454-67826523e159,"{""testMessage"":""Test message""}",,,,4a428b32-08cf-45c7-9986-17585af38806,,ClientSideExtension.ApplicationCustomizer,Some customizer,,0,Web,,,0,Some customizer,,16.0.1.0
   ```
 
   </TabItem>
@@ -157,7 +159,6 @@ m365 spo applicationcustomizer get --id 14125658-a9bc-4ddf-9c75-1b5767c9a337 --w
   Location | ClientSideExtension.ApplicationCustomizer
   Name | {4a428b32-08cf-45c7-9986-17585af38806}
   RegistrationType | 0
-  Rights | {"High":"0","Low":"0"}
   Scope | Web
   Sequence | 65536
   Title | HelloWorld

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

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spo file copy
 
@@ -31,11 +33,14 @@ 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 />
@@ -43,7 +48,6 @@ 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.
@@ -56,16 +60,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 clear the author and created date.
+Copy a file by site-relative URL to a document library in another site collection and ignore the file history.
 
 ```sh
-m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --resetAuthorAndCreated
+m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --ignoreVersionHistory
 ```
 
-Copy file by sourceId (UniqueId) to a document library in another site collection and rename the file.
+Copy file by sourceId (UniqueId) to a document library in another site collection and rename the file (without specifying the file extension).
 
 ```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.pdf"
+m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceId "b2307a39-e878-458b-bc90-03bc578531d6" --targetUrl "/sites/IT/Shared Documents" --newName "Report"
 ```
 
 Copy file by sourceId (UniqueId) to a document library in another site collection with a new name, rename the file if it already exists.
@@ -76,8 +80,111 @@ m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourc
 
 ## Response
 
-The command won't return a response on success.
-
-## More information
+### 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
 
-- 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)
+The command won't return a response on success.

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

@@ -10,12 +10,6 @@ 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,8 +126,7 @@ 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",
-      "Url": "/_catalogs/theme"
+      "Title": "Theme Gallery"
     }
   ]
   ```
@@ -136,17 +135,17 @@ m365 spo list list --webUrl https://contoso.sharepoint.com/sites/project-x --fil
   <TabItem value="Text">
 
   ```text
-  Id                                    Url
+  Id                                    Title
   ------------------------------------  ----------------
-  66e5148c-7060-4479-88e7-636d79579148  /_catalogs/theme
+  66e5148c-7060-4479-88e7-636d79579148  Theme Gallery
   ```
 
   </TabItem>
   <TabItem value="CSV">
 
   ```csv
-  Id,Url
-  Theme Gallery,/_catalogs/theme,66e5148c-7060-4479-88e7-636d79579148
+  Id,Title
+  66e5148c-7060-4479-88e7-636d79579148,Theme Gallery
   ```
 
   </TabItem>
@@ -211,7 +210,6 @@ 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,7 +14,10 @@ m365 spo site appcatalog remove [options]
 
 ```md definition-list
 `-u, --siteUrl <siteUrl>`
-: URL of the site collection containing the app catalog to disable
+: URL of the site collection containing the app catalog to disable.
+
+`-f, --force`
+: Don't prompt for confirmation.
 ```
 
 <Global />
@@ -31,12 +34,18 @@ 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,9 +22,6 @@ 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,9 +17,6 @@ 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 />
@@ -34,7 +31,7 @@ To use this command you must be a Global or SharePoint administrator.
     
 ## Examples
 
-Restore a deleted site collection from tenant recycle bin
+Restores a deleted site collection from tenant recycle bin.
 
 ```sh
 m365 spo tenant recyclebinitem restore --siteUrl https://contoso.sharepoint.com/sites/team
@@ -42,48 +39,4 @@ m365 spo tenant recyclebinitem restore --siteUrl https://contoso.sharepoint.com/
 
 ## Response
 
-<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>
+The command won't return a response on success.

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.