@pnp/cli-microsoft365 7.0.0-beta.4ebf3ad → 7.0.0-beta.669444a

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

@@ -14,16 +14,28 @@ m365 spo folder copy [options]
 
 ```md definition-list
 `-u, --webUrl <webUrl>`
-: The URL of the site where the folder is located
+: The URL of the site where the folder is located.
 
-`-s, --sourceUrl <sourceUrl>`
-: The server- or site-relative URL of the folder to copy
+`-s, --sourceUrl [sourceUrl]`
+: The server-, site-relative or absolute decoded URL of the folder to copy. Specify either `sourceUrl` or `sourceId` but not both.
+
+`-i, --sourceId [sourceId]`
+: The UniqueId (GUID) of the folder. Specify either `sourceUrl` or `sourceId` but not both.
 
 `-t, --targetUrl <targetUrl>`
-: Server-relative URL where to copy the folder
+: Server-relative or absolute decoded URL where to copy the folder.
+
+`--newName [newName]`
+: New name of the destination folder.
+
+`--nameConflictBehavior [nameConflictBehavior]`
+: Behavior when a file or folder with the same name is already present at the destination. Possible values: `fail`, `rename`. The default is `fail`.
 
-`--allowSchemaMismatch`
-: Ignores any missing fields in the target document library and copies the folder anyway
+`--resetAuthorAndCreated`
+: Use this option to clear the author and created date. When not specified, the values from the source folder are used.
+
+`--bypassSharedLock`
+: This indicates whether a folder with a shared lock can still be moved. Use this option to copy a folder that is locked.
 ```
 
 <Global />
@@ -32,26 +44,41 @@ m365 spo folder copy [options]
 
 When you copy a folder with documents that have version history, only the latest document version is copied.
 
+When you specify a value for `nameConflictBehavior`, consider the following:
+
+- `fail` will throw an error when the destination folder already exists.
+- `rename` will add a suffix (e.g. Folder1) when the destination folder already exists.
+
 ## Examples
 
-Copies folder from a document library located in one site collection to another site collection
+Copy a folder a folder to another location using server-relative URLs
 
 ```sh
-m365 spo folder copy --webUrl https://contoso.sharepoint.com/sites/test1 --sourceUrl /Shared%20Documents/MyFolder --targetUrl /sites/test2/Shared%20Documents/
+m365 spo folder copy --webUrl https://contoso.sharepoint.com/sites/project-x --sourceUrl "/sites/project-x/Shared Documents/Reports" --targetUrl "/sites/project-y/Shared Documents/Project files"
 ```
 
-Copies folder from a document library to another site in the same site collection
+Copy a folder a folder to another location using site-relative URLs and rename it
 
 ```sh
-m365 spo folder copy --webUrl https://contoso.sharepoint.com/sites/test1 --sourceUrl /Shared%20Documents/MyFolder --targetUrl /sites/test1/HRDocuments/
+m365 spo folder copy --webUrl https://contoso.sharepoint.com/sites/project-x --sourceUrl "/Shared Documents/Reports" --targetUrl "/sites/project-y/Shared Documents" --newName "Reports January"
 ```
 
-Copies folder to a document library in another site collection. Allow for schema mismatch
+Copy a folder to another location and use new name on conflict
 
 ```sh
-m365 spo folder copy --webUrl https://contoso.sharepoint.com/sites/test1 --sourceUrl /Shared%20Documents/MyFolder --targetUrl /sites/test2/Shared%20Documents/ --allowSchemaMismatch
+m365 spo folder copy --webUrl https://contoso.sharepoint.com/sites/project-x --sourceUrl "/sites/project-x/Shared Documents/Reports" --targetUrl "/sites/project-y/Shared Documents/Project files" --nameConflictBehavior rename
 ```
 
+Copy a folder referenced by its ID to another document library and reset author and created date
+
+```sh
+m365 spo folder copy --webUrl https://contoso.sharepoint.com/sites/project-x --sourceId b8cc341b-9c11-4f2d-aa2b-0ce9c18bcba2 --targetUrl "/sites/project-x/Project files" --retainEditorAndModified
+```
+
+## 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-get.mdx

@@ -17,7 +17,7 @@ m365 spo folder get [options]
 : The URL of the site where the folder is located.
 
 `--url [url]`
-: The server- or site-relative URL of the folder to retrieve. Specify either `folderUrl` or `id` but not both.
+: The server- or site-relative decoded URL of the folder to retrieve. Specify either `folderUrl` or `id` but not both.
 
 `-i, --id [id]`
 : The UniqueId (GUID) of the folder to retrieve. Specify either `url` or `id` but not both.

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

@@ -19,7 +19,7 @@ m365 spo folder list [options]
 : The URL of the site where the folders to list are located.
 
 `-p, --parentFolderUrl <parentFolderUrl>`
-: The server- or site-relative URL of the parent folder.
+: The server- or site-relative decoded URL of the parent folder.
 
 `--fields [fields]`
 : Comma-separated list of fields to retrieve. Will retrieve all fields if not specified and json output is requested.

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

@@ -14,44 +14,71 @@ m365 spo folder move [options]
 
 ```md definition-list
 `-u, --webUrl <webUrl>`
-: The URL of the site where the folder is located
+: The URL of the site where the folder is located.
 
-`-s, --sourceUrl <sourceUrl>`
-: The server- or site-relative URL of the folder to move
+`-s, --sourceUrl [sourceUrl]`
+: The server-, site-relative or absolute decoded URL of the folder to move. Specify either `sourceUrl` or `sourceId` but not both.
+
+`-i, --sourceId [sourceId]`
+: The ID of the folder to move. Specify either `sourceUrl` or `sourceId` but not both.
 
 `-t, --targetUrl <targetUrl>`
-: Server-relative URL where to move the folder
+: Server-relative or absolute decoded URL where to move the folder.
+
+`--newName [newName]`
+: The new name of the destination folder.
+
+`--nameConflictBehavior [nameConflictBehavior]`
+: Behavior when a file or folder with the same name is already present at the destination. Possible values: `fail`, `rename`. The default is `fail`.
 
-`--allowSchemaMismatch`
-: Ignores any missing fields in the target destination and moves the folder anyway
+`--retainEditorAndModified`
+: Use this option to retain the editor and modified date. When not specified, these values are reset.
+
+`--bypassSharedLock`
+: This indicates whether a folder with a share lock can still be moved. Use this option to move a folder that is locked.
 ```
 
 <Global />
 
 ## Remarks
 
-When you move a folder using the `spo folder move` command, all of the document versions are moved.
+All folder versions are retained while moving a folder.
+
+When you specify a value for `nameConflictBehavior`, consider the following:
+
+- `fail` will throw an error when the destination folder already exists.
+- `rename` will add a suffix (e.g. folder1) when the destination folder already exists.
 
 ## Examples
 
-Move folder to a document library in another site collection
+Move a folder to a document library in another site collection by server-relative URL
 
 ```sh
-m365 spo folder move --webUrl https://contoso.sharepoint.com/sites/test1 --sourceUrl /Shared%20Documents/MyFolder --targetUrl /sites/test2/Shared%20Documents/
+m365 spo folder move --webUrl https://contoso.sharepoint.com/sites/project-x --sourceUrl "/sites/project-x/Shared Documents/Reports" --targetUrl "/sites/project-y/Shared Documents/Reports January"
 ```
 
-Move folder to a document library in the same site collection
+Move a folder to another location using site-relative URLs and rename it
 
 ```sh
-m365 spo folder move --webUrl https://contoso.sharepoint.com/sites/test1 --sourceUrl /Shared%20Documents/MyFolder --targetUrl /sites/test1/HRDocuments/
+m365 spo folder move --webUrl https://contoso.sharepoint.com/sites/project-x --sourceUrl "/Shared Documents/Reports" --targetUrl "/sites/project-y/Shared Documents" --newName "Reports January"
 ```
 
-Move folder to a document library in another site collection. Allow for schema mismatch
+Move a folder to another location and use a new name on conflict
 
 ```sh
-m365 spo file move --webUrl https://contoso.sharepoint.com/sites/test1 --sourceUrl /Shared%20Documents/sp1.pdf --targetUrl /sites/test2/Shared%20Documents/ --allowSchemaMismatch
+m365 spo folder move --webUrl https://contoso.sharepoint.com/sites/project-x --sourceUrl "/sites/project-x/Shared Documents/Reports" --targetUrl "/sites/project-y/Shared Documents/Project files" --nameConflictBehavior rename
 ```
 
+Move a folder referenced by its ID to another document library and retain editor and modified date
+
+```sh
+m365 spo folder move --webUrl https://contoso.sharepoint.com/sites/project-x --sourceId b8cc341b-9c11-4f2d-aa2b-0ce9c18bcba2 --targetUrl "/sites/project-x/Project files" --retainEditorAndModified
+```
+
+## Response
+
+The command won't return a response on success.
+
 ## More information
 
 - Move 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-remove.mdx

@@ -17,7 +17,7 @@ m365 spo folder remove [options]
 : The URL of the site where the folder to be deleted is located.
 
 `--url <url>`
-: The server- or site-relative URL of the folder to delete.
+: The server- or site-relative decoded URL of the folder to delete.
 
 `--recycle`
 : Recycles the folder instead of actually deleting it.

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

@@ -17,7 +17,7 @@ m365 spo folder rename [options]
 : The URL of the site where the folder to be renamed is located.
 
 `--url <url>`
-: The server- or site-relative URL of the folder (including the folder).
+: The server- or site-relative decoded URL of the folder (including the folder).
 
 `-n, --name <name>`
 : New name for the target folder.
@@ -38,3 +38,7 @@ Renames a folder with a specific server-relative URL
 ```sh
 m365 spo folder rename --webUrl https://contoso.sharepoint.com/sites/project-x --url '/sites/project-x/Shared Documents/My Folder 1' --name 'My Folder 2'
 ```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/folder/folder-retentionlabel-ensure.mdx

@@ -17,7 +17,7 @@ m365 spo folder retentionlabel ensure [options]
 : URL of the site where the retention label from a file to apply is located
 
 `--folderUrl [folderUrl]`
-: The server- or site-relative URL of the folder that should be labelled. Specify either `folderUrl` or `folderId` but not both.
+: The server- or site-relative decoded URL of the folder that should be labelled. Specify either `folderUrl` or `folderId` but not both.
 
 `i, --folderId [folderId]`
 : The UniqueId (GUID) of the folder that should be labelled. Specify either `folderUrl` or `folderId` but not both.

package/docs/docs/cmd/spo/folder/folder-retentionlabel-remove.mdx

@@ -17,7 +17,7 @@ m365 spo folder retentionlabel remove [options]
 : The url of the web.
 
 `--folderUrl [folderUrl]`
-: The server- or site-relative URL of the folder of which the label should be removed. Specify either `folderUrl` or `folderId` but not both.
+: The server- or site-relative decoded URL of the folder of which the label should be removed. Specify either `folderUrl` or `folderId` but not both.
 
 `-i, --folderId [folderId]`
 : The UniqueId (GUID) of the folder of which the label should be removed. Specify either `folderUrl` or `folderId` but not both.

package/docs/docs/cmd/spo/folder/folder-roleassignment-add.mdx

@@ -17,7 +17,7 @@ m365 spo folder roleassignment add [options]
 : The URL of the site where the folder is located.
 
 `--folderUrl <folderUrl>`
-: The server- or site-relative URL of the folder.
+: The server- or site-relative decoded URL of the folder.
 
 `--principalId [principalId]`
 : The SharePoint principal id. It may be either an user id or group id for which the role assignment will be addd. Specify either upn, groupName or principalId but not multiple.
@@ -32,7 +32,7 @@ m365 spo folder roleassignment add [options]
 : ID of the role definition. Specify either roleDefinitionId or roleDefinitionName but not both.
 
 `--roleDefinitionName [roleDefinitionName]`
-: The name of the role definition. E.g. 'Contribute', 'Read'. Specify either roleDefinitionId or roleDefinitionName but not both
+: The name of the role definition. E.g. 'Contribute', 'Read'. Specify either roleDefinitionId or roleDefinitionName but not both.
 ```
 
 <Global />

package/docs/docs/cmd/spo/folder/folder-roleassignment-remove.mdx

@@ -17,7 +17,7 @@ m365 spo folder roleassignment remove [options]
 : The URL of the site where the folder is located.
 
 `--folderUrl <folderUrl>`
-: The server- or site-relative URL of the folder.
+: The server- or site-relative decoded URL of the folder.
 
 `--principalId [principalId]`
 : The SharePoint principal id. It may be either an user id or group id for which the role assignment will be removed. Specify either upn, groupName or principalId but not multiple.

package/docs/docs/cmd/spo/folder/folder-roleinheritance-break.mdx

@@ -17,7 +17,7 @@ m365 spo folder roleinheritance break [options]
 : URL of the site where the folder is located.
 
 `--folderUrl <folderUrl>`
-: The server- or site-relative URL of the folder.
+: The server- or site-relative decoded URL of the folder.
 
 `-c, --clearExistingPermissions`
 : Clear all existing permissions from the folder.

package/docs/docs/cmd/spo/folder/folder-roleinheritance-reset.mdx

@@ -17,7 +17,7 @@ m365 spo folder roleinheritance reset [options]
 : URL of the site where the folder is located.
 
 `--folderUrl <folderUrl>`
-: The server- or site-relative URL of the folder.
+: The server- or site-relative decoded URL of the folder.
 
 `-f, --force`
 : Don't prompt for confirmation to reset role inheritance of the folder.

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

@@ -28,7 +28,7 @@ m365 spo listitem attachment list [options]
 : Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`
 
 `--listItemId <listItemId>`
-: ID of the list item to in question
+: ID of the list item
 ```
 
 <Global />

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

@@ -98,7 +98,7 @@ Deleting and creating classic site collections is by default asynchronous and de
 
 The `--owners` option is mandatory for creating `CommunicationSite` sites with app-only permissions.
 
-When trying to create a team site using app-only permissions, you will get an _Insufficient privileges to complete the operation._ error. As a workaround, you can use the [`aad o365group add`](../../aad/o365group/o365group-add.mdx) command, followed by [`spo site set`](./site-set.mdx) to further configure the Team site.
+When trying to create a team site using app-only permissions, you will get an _Insufficient privileges to complete the operation._ error. As a workaround, you can use the [`aad m365group add`](../../aad/m365group/m365group-add.mdx) command, followed by [`spo site set`](./site-set.mdx) to further configure the Team site.
 
 ## Examples
 

package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-add.mdx

@@ -2,7 +2,7 @@ import Global from '/docs/cmd/_global.mdx';
 
 # spo tenant applicationcustomizer add
 
-Add an application customizer as a tenant wide extension.
+Add an application customizer as a tenant wide extension
 
 ## Usage
 

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

@@ -4,7 +4,7 @@ import TabItem from '@theme/TabItem';
 
 # spo tenant applicationcustomizer list
 
-Retrieves a list of application customizers that are installed tenant-wide.
+Retrieves a list of application customizers that are installed tenant-wide
 
 ## Usage
 

package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-remove.mdx

@@ -2,7 +2,7 @@ import Global from '/docs/cmd/_global.mdx';
 
 # spo tenant applicationcustomizer remove
 
-Removes an application customizer that is installed tenant wide.
+Removes an application customizer that is installed tenant wide
 
 ## Usage
 

package/docs/docs/cmd/spo/tenant/tenant-commandset-add.mdx

@@ -4,7 +4,7 @@ import TabItem from '@theme/TabItem';
 
 # spo tenant commandset add
 
-Add a ListView Command Set as a tenant-wide extension.
+Add a ListView Command Set as a tenant-wide extension
 
 ## Usage
 

package/docs/docs/cmd/spo/tenant/tenant-commandset-remove.mdx

@@ -2,7 +2,7 @@ import Global from '/docs/cmd/_global.mdx';
 
 # spo tenant commandset remove
 
-Removes a ListView Command Set that is installed tenant wide.
+Removes a ListView Command Set that is installed tenant wide
 
 ## Usage
 

package/docs/docs/cmd/spo/tenant/tenant-commandset-set.mdx

@@ -2,7 +2,7 @@ import Global from '/docs/cmd/_global.mdx';
 
 # spo tenant commandset set
 
-Updates a ListView Command Set that is installed tenant wide.
+Updates a ListView Command Set that is installed tenant wide
 
 ## Usage
 

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

@@ -32,7 +32,7 @@ m365 teams team add [options]
 
 ## Remarks
 
-If you want to add a Team to an existing Microsoft 365 Group use the [aad o365group teamify](../../aad/o365group/o365group-teamify.mdx) command instead.
+If you want to add a Team to an existing Microsoft 365 Group use the [aad m365group teamify](../../aad/m365group/m365group-teamify.mdx) command instead.
 
 This command will return different responses based on the presence of the `--wait` option. If present, the command will return a `group` resource in the response. If not present, the command will return a `teamsAsyncOperation` resource in the response.
 

package/docs/docs/cmd/yammer/network/network-list.mdx

@@ -2,7 +2,7 @@ import Global from '/docs/cmd/_global.mdx';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# Yammer network list
+# yammer network list
 
 Returns a list of networks to which the current user has access