@pnp/cli-microsoft365 7.5.0-beta.23612bc → 7.5.0-beta.940b241

package/docs/docs/cmd/entra/group/group-add.mdx

@@ -0,0 +1,231 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# entra group add
+
+Creates a Microsoft Entra group
+
+## Usage
+
+```sh
+m365 entra group add [options]
+```
+
+## Alias
+
+```sh
+m365 aad group add [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --displayName <displayName>`
+: The name for the group. The maximum length is 256 characters.
+
+`-d, --description [description]`
+: The description for the group.
+
+`-t, --type <type>`
+: The group type. Valid values: `microsoft365` or `security`.
+
+`-m, --mailNickname [mailNickname]`
+: The mail alias for the group (part before the @). Maximum length is 64 characters.
+
+`--ownerIds [ownerIds]`
+: Comma-separated list of IDs of Microsoft Entra ID users that will be group owners. Specify either `ownerIds` or `ownerUserNames`, but not both.
+
+`--ownerUserNames [ownerUserNames]`
+: Comma-separated list of UPNs of Microsoft Entra ID users that will be group owners. Specify either `ownerIds` or `ownerUserNames`, but not both.
+
+`--memberIds [memberIds]`
+: Comma-separated list of IDs of Microsoft Entra ID users that will be group members. Specify either `memberIds` or `memberUserNames`, but not both.
+
+`--memberUserNames [memberUserNames]`
+: Comma-separated list of UPNs of Microsoft Entra ID users that will be group members. Specify either `memberIds` or `memberUserNames`, but not both.
+
+`--visibility [visibility]`
+: Specifies the group join policy and group content visibility for Microsoft 365 groups. Possible values are: `Private`, `Public`, or `HiddenMembership`. Defaults to `Public`. Specify only when creating a group of type `microsoft365`.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+The `visibility` option affects the behavior of the group.
+
+With the `Public` visibility:
+- Anyone can join the group without needing owner permission. 
+- Anyone can view the attributes of the group. 
+- Anyone can see the members of the group.
+
+With the `Private` visibilty:
+- Owner permission is needed to join the group.
+- Anyone can view the attributes of the group.
+- Anyone can see the members of the group.
+
+With the `HiddenMembership` visibility:
+- Owner permission is needed to join the group.
+- Guest users cannot view the attributes of the group.
+- Non-members cannot see the members of the group. This setting doesn't affect visibility of group owners.
+- Administrators (global, company, user, and helpdesk) can view the membership of the group.
+- The group appears in the global address book (GAL).
+
+:::
+
+:::note
+
+The `HiddenMembership` visibility can be set only for Microsoft 365 groups when the groups are created. It can't be updated later.
+
+:::
+
+This command allows using unknown options. For a comprehensive list of group properties, please refer to the [Graph documentation page](https://learn.microsoft.com/graph/api/resources/group?view=graph-rest-1.0#properties).
+
+If the specified option is not found, you will receive a `Resource 'xyz' does not exist or one of its queried reference-property objects are not present.` error.
+
+## Examples
+
+Create a security group without any owners or members
+
+```sh
+m365 entra group add --displayName Developers --type security
+```
+
+Create a private Microsoft 365 group with owners and members and a custom mail address
+
+```sh
+m365 entra group add --displayName Developers --type microsoft365 --mailNickname devs --ownerUserNames john.doe@contoso.com --memberUserNames "john.doe@contoso.com,adele.vance@contoso.com" --visibility Private
+```
+
+Create a public Microsoft 365 group without any owners or members
+
+```sh
+m365 entra group add --displayName Developers --type microsoft365 --description "This group is for all developers in the company." --visibility Public
+```
+
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "ae0e8388-cd70-427f-9503-c57498ee3337",
+    "deletedDateTime": null,
+    "classification": null,
+    "createdDateTime": "2024-01-10T11:33:18Z",
+    "creationOptions": [],
+    "description": "This group is for all developers in the company.",
+    "displayName": "Developers",
+    "expirationDateTime": null,
+    "groupTypes": [
+      "Unified"
+    ],
+    "isAssignableToRole": null,
+    "mail": "devs@contoso.com",
+    "mailEnabled": true,
+    "mailNickname": "devs",
+    "membershipRule": null,
+    "membershipRuleProcessingState": null,
+    "onPremisesDomainName": null,
+    "onPremisesLastSyncDateTime": null,
+    "onPremisesNetBiosName": null,
+    "onPremisesSamAccountName": null,
+    "onPremisesSecurityIdentifier": null,
+    "onPremisesSyncEnabled": null,
+    "preferredDataLocation": null,
+    "preferredLanguage": null,
+    "proxyAddresses": [
+      "SMTP:devs@contoso.com"
+    ],
+    "renewedDateTime": "2024-01-10T11:33:18Z",
+    "resourceBehaviorOptions": [],
+    "resourceProvisioningOptions": [],
+    "securityEnabled": true,
+    "securityIdentifier": "S-1-12-1-2920186760-1115671920-1959068565-926150296",
+    "theme": null,
+    "visibility": "Public",
+    "onPremisesProvisioningErrors": [],
+    "serviceProvisioningErrors": []
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  classification               : null
+  createdDateTime              : 2024-01-10T11:36:31Z
+  creationOptions              : []
+  deletedDateTime              : null
+  description                  : This group is for all developers in the company.
+  displayName                  : Developers
+  expirationDateTime           : null
+  groupTypes                   : ["Unified"]
+  id                           : f7bce6b2-c017-4a00-ba0c-fbbe458364aa
+  isAssignableToRole           : null
+  mail                         : dev@contoso.com
+  mailEnabled                  : true
+  mailNickname                 : devs
+  membershipRule               : null
+  membershipRuleProcessingState: null
+  onPremisesDomainName         : null
+  onPremisesLastSyncDateTime   : null
+  onPremisesNetBiosName        : null
+  onPremisesProvisioningErrors : []
+  onPremisesSamAccountName     : null
+  onPremisesSecurityIdentifier : null
+  onPremisesSyncEnabled        : null
+  preferredDataLocation        : null
+  preferredLanguage            : null
+  proxyAddresses               : ["SMTP:devs@contoso.com"]
+  renewedDateTime              : 2024-01-10T11:36:31Z
+  resourceBehaviorOptions      : []
+  resourceProvisioningOptions  : []
+  securityEnabled              : true
+  securityIdentifier           : S-1-12-1-4156352178-1241563159-3204123834-2858713925
+  serviceProvisioningErrors    : []
+  theme                        : null
+  visibility                   : Public
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,deletedDateTime,classification,createdDateTime,description,displayName,expirationDateTime,isAssignableToRole,mail,mailEnabled,mailNickname,membershipRule,membershipRuleProcessingState,onPremisesDomainName,onPremisesLastSyncDateTime,onPremisesNetBiosName,onPremisesSamAccountName,onPremisesSecurityIdentifier,onPremisesSyncEnabled,preferredDataLocation,preferredLanguage,renewedDateTime,securityEnabled,securityIdentifier,theme,visibility
+  4c63e8cd-eb2b-4b0d-9251-d709cc75cf5e,,,2024-01-10T11:37:02Z,This group is for all developers in the company.,Developers,,,devs@contoso.com,1,devs,,,,,,,,,,,2024-01-10T11:37:02Z,1,S-1-12-1-1281616077-1259203371-165106066-1590654412,,Public
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # entra group add --displayName "Developers" --type "microsoft365" --description "This group is for all developers in the company." --visibility "Public" --mailNickname "devs"
+
+  Date: 1/10/2024
+
+  ## Developers (b3fd8e8f-eced-45c7-a366-178bc5c1db37)
+
+  Property | Value
+  ---------|-------
+  id | b3fd8e8f-eced-45c7-a366-178bc5c1db37
+  createdDateTime | 2024-01-10T11:37:39Z
+  description | This group is for all developers in the company.
+  displayName | Developers
+  mail | devs@contoso.com
+  mailEnabled | true
+  mailNickname | devs
+  renewedDateTime | 2024-01-10T11:37:39Z
+  securityEnabled | true
+  securityIdentifier | S-1-12-1-3019738767-1170730221-2333566627-937148869
+  visibility | Public
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/entra/m365group/m365group-report-activitygroupcounts.mdx

@@ -4,7 +4,7 @@ import TabItem from '@theme/TabItem';
 
 # entra m365group report activitygroupcounts
 
-Get the daily total number of groups and how many of them were active based on email conversations, Yammer posts, and SharePoint file activities.
+Get the daily total number of groups and how many of them were active based on email conversations, Viva Engage posts, and SharePoint file activities.
 
 ## Usage
 

package/docs/docs/cmd/entra/oauth2grant/oauth2grant-add.mdx

@@ -33,11 +33,11 @@ m365 aad oauth2grant add [options]
 
 ## Remarks
 
-Before you can grant service principal OAuth2 permissions, you need its `objectId`. You can retrieve it using the [entra sp get](../sp/sp-get.mdx) command.
+Before you can grant service principal OAuth2 permissions, you need its `objectId`. You can retrieve it using the [entra enterpriseapp get](../enterpriseapp/enterpriseapp-get.mdx) command.
 
-The resource for which you want to grant permissions is designated using its `objectId`. You can retrieve it using the [entra sp get](../sp/sp-get.mdx) command, the same way you would retrieve the `objectId` of the service principal.
+The resource for which you want to grant permissions is designated using its `objectId`. You can retrieve it using the [entra enterpriseapp get](../enterpriseapp/enterpriseapp-get.mdx) command, the same way you would retrieve the `objectId` of the service principal.
 
-When granting OAuth2 permissions, you have to specify which permission scopes you want to grant the service principal. You can get the list of available permission scopes either from the resource documentation or from the `appRoles` property when retrieving information about the service principal using the [entra sp get](../sp/sp-get.mdx) command. Multiple permission scopes can be specified separated by a space.
+When granting OAuth2 permissions, you have to specify which permission scopes you want to grant the service principal. You can get the list of available permission scopes either from the resource documentation or from the `appRoles` property when retrieving information about the service principal using the [entra enterpriseapp get](../enterpriseapp/enterpriseapp-get.mdx) command. Multiple permission scopes can be specified separated by a space.
 
 When granting OAuth2 permissions, the values of the `clientId` and `resourceId` properties form a unique key. If a grant for the same `clientId`-`resourceId` pair already exists, running the `entra oauth2grant add` command will fail with an error. If you want to change permissions on an existing OAuth2 grant use the [entra oauth2grant set](./oauth2grant-set.mdx) command instead.
 

package/docs/docs/cmd/entra/oauth2grant/oauth2grant-list.mdx

@@ -29,7 +29,7 @@ m365 aad oauth2grant list [options]
 
 ## Remarks
 
-In order to list existing OAuth2 permissions granted to a service principal, you need its `objectId`. You can retrieve it using the [entra sp get](../sp/sp-get.mdx) command.
+In order to list existing OAuth2 permissions granted to a service principal, you need its `objectId`. You can retrieve it using the [entra enterpriseapp get](../enterpriseapp/enterpriseapp-get.mdx) command.
 
 When using the text output type (default), the command lists only the values of the `objectId`, `resourceId` and `scope` properties of the OAuth grant. When setting the output type to JSON, all available properties are included in the command output.
 

package/docs/docs/cmd/entra/user/user-registrationdetails-list.mdx

@@ -0,0 +1,246 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# entra user registrationdetails list
+
+Retrieves a list of the authentication methods registered for users
+
+## Usage
+
+```sh
+m365 entra user registrationdetails list [options]
+```
+
+## Alias
+
+```sh
+m365 aad user registrationdetails list [options]
+```
+
+## Options
+
+```md definition-list
+`--isAdmin [isAdmin]`
+: Filter for users who are admins. Allowed values are `true` or `false`. If not specified, returns all users.
+
+`--userType [userType]`
+: Filter for members or guest users. Allowed values are `member` or `guest`. If not specified, returns all users.
+
+`--userPreferredMethodForSecondaryAuthentication [userPreferredMethodForSecondaryAuthentication]`
+: Filter users by selected method as default second-factor authentication. Allowed values are `push`, `oath`, `voiceMobile`, `voiceAlternateMobile`, `voiceOffice`, `sms` or `none`. Specify either one method or more methods separated by a comma.
+
+`--systemPreferredAuthenticationMethods [systemPreferredAuthenticationMethods]`
+: Filter users by most secure authentication methods registered for second-factor authentication. Allowed values are `push`, `oath`, `voiceMobile`, `voiceAlternateMobile`, `voiceOffice`, `sms` or `none`. Specify either one method or more methods separated by a comma.
+
+`--isSelfServicePasswordResetRegistered [isSelfServicePasswordResetRegistered]`
+: Filter for users who have registered for self-service password reset. Allowed values are `true` or `false`. If not specified, returns all users.
+
+`--isSelfServicePasswordResetEnabled [isSelfServicePasswordResetEnabled]`
+: Filter for users who have been enabled for self-service password reset. Allowed values are `true` or `false`. If not specified, returns all users.
+
+`--isSelfServicePasswordResetCapable [isSelfServicePasswordResetCapable]`
+: Filter for users who are ready to perform self-service password reset. Allowed values are `true` or `false`. If not specified, returns all users.
+
+`--isMfaRegistered [isMfaRegistered]`
+: Filter for users who are registered for multi-factor authentication. Allowed values are `true` or `false`. If not specified, returns all users.
+
+`--isMfaCapable [isMfaCapable]`
+: Filter for users who are ready to perform password reset or multi-factor authentication. Allowed values are `true` or `false`. If not specified, returns all users.
+
+`--isPasswordlessCapable [isPasswordlessCapable]`
+: Filter for user who have registered a password less strong authentication method. Allowed values are `true` or `false`. If not specified, returns all users.
+
+`--isSystemPreferredAuthenticationMethodEnabled [isSystemPreferredAuthenticationMethodEnabled]`
+: Filter for users who have enabled system preferred authentication method. Allowed values are `true` or `false`. If not specified, returns all users.
+
+`--methodsRegistered [methodsRegistered]`
+: Filter users by registered methods used during registration. Allowed values are `mobilePhone`, `email`, `fido2`, `microsoftAuthenticatorPush` or `softwareOneTimePasscode`. Specify either one method or more methods separated by a comma.
+
+`--userIds [userIds]`
+: Filter users by ids. Specify at most 20 ids separated by a comma.
+
+`--userPrincipalNames [userPrincipalNames]`
+: Filter users by user principal names. Specify at most 20 UPN separated by a comma.
+
+`-p, --properties [properties]`
+: Comma-separated list of properties to retrieve.
+```
+
+<Global />
+
+## Remarks
+
+Using the `--properties` option, you can specify a comma-separated list of registration details properties to retrieve from the Microsoft Graph. If you don't specify any properties, the command will retrieve user's account name, registered methods and timestamp of last update.
+
+:::info
+
+When multiple values are specified for `--userPreferredMethodForSecondaryAuthentication` option, the command returns registration details with at least one specified selected method as default second-factor authentication.
+
+When multiple values are specified for `--systemPreferredAuthenticationMethods` option, the command returns registration details with at least one specified most secure authentication methods registered for second-factor authentication.
+
+When multiple values are specified for `--registeredMethods` option, the command returns registration details with at least one specified registered methods used during registration.
+
+:::
+
+## Examples
+
+Retrieve registration details for all users
+
+```sh
+m365 entra user registrationdetails list
+```
+
+Retrieve user registration details and returns only specific properties
+
+```sh
+m365 entra user registrationdetails list --properties 'id,isAdmin'
+```
+
+Retrieve registration details for admins
+
+```sh
+m365 entra user registrationdetails list --isAdmin true
+```
+
+Retrieve registration details for guest users
+
+```sh
+m365 entra user registrationdetails list --userType guest
+```
+
+Retrieve registration details for users who selected either sms or push authentication method as the default second-factor for performing multifactor authentication
+
+```sh
+m365 entra user registrationdetails list --userPreferredMethodForSecondaryAuthentication 'sms,push'
+```
+
+Retrieve registration details for users with push authentication method as the most secure authentication method among the registered methods for second factor authentication determined by the system
+
+```sh
+m365 entra user registrationdetails list --systemPreferredAuthenticationMethods push
+```
+
+Retrieve registration details for users who have used either Microsoft Authenticator app or mobile phone during registration
+
+```sh
+m365 entra user registrationdetails list --methodsRegistered 'microsoftAuthenticatorPush,mobilePhone'
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "id": "61b0c52f-a902-4769-9a09-c6628335b00a",
+      "userPrincipalName": "AdeleV@contoso.onmicrosoft.com",
+      "userDisplayName": "Adele Vance",
+      "userType": "member",
+      "isAdmin": false,
+      "isSsprRegistered": false,
+      "isSsprEnabled": false,
+      "isSsprCapable": false,
+      "isMfaRegistered": false,
+      "isMfaCapable": false,
+      "isPasswordlessCapable": false,
+      "methodsRegistered": [],
+      "isSystemPreferredAuthenticationMethodEnabled": false,
+      "systemPreferredAuthenticationMethods": [],
+      "userPreferredMethodForSecondaryAuthentication": "none",
+      "lastUpdatedDateTime": "2024-01-23T19:37:43.7170699Z"
+    },
+    {
+      "id": "ebd27dbd-75f2-4ef8-bd51-102c3faf62ec",
+      "userPrincipalName": "john.doe@contoso.onmicrosoft.com",
+      "userDisplayName": "John Doe",
+      "userType": "member",
+      "isAdmin": false,
+      "isSsprRegistered": false,
+      "isSsprEnabled": false,
+      "isSsprCapable": false,
+      "isMfaRegistered": true,
+      "isMfaCapable": true,
+      "isPasswordlessCapable": false,
+      "methodsRegistered": [
+        "microsoftAuthenticatorPush",
+        "softwareOneTimePasscode"
+      ],
+      "isSystemPreferredAuthenticationMethodEnabled": false,
+      "systemPreferredAuthenticationMethods": [],
+      "userPreferredMethodForSecondaryAuthentication": "push",
+      "lastUpdatedDateTime": "2024-01-23T19:37:43.7165489Z"
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  userPrincipalName                                methodsRegistered                                                     lastUpdatedDateTime
+  -----------------------------------------------  --------------------------------------------------------------------  ----------------------------
+  AdeleV@contoso.onmicrosoft.com                                                                                          2024-01-23T19:37:43.7170699Z
+  john.doe@contoso.onmicrosoft.com                  microsoftAuthenticatorPush,softwareOneTimePasscode                    2024-01-23T19:37:43.7165489Z
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,userPrincipalName,userDisplayName,userType,isAdmin,isSsprRegistered,isSsprEnabled,isSsprCapable,isMfaRegistered,isMfaCapable,isPasswordlessCapable,isSystemPreferredAuthenticationMethodEnabled,userPreferredMethodForSecondaryAuthentication,lastUpdatedDateTime
+  61b0c52f-a902-4769-9a09-c6628335b00a,AdeleV@contoso.onmicrosoft.com,Adele Vance,member,,,,,,,,,none,2024-01-23T19:37:43.7170699Z
+  ebd27dbd-75f2-4ef8-bd51-102c3faf62ec,john.doe@contoso.onmicrosoft.com,John Doe,member,,,,,1,1,,,push,2024-01-23T19:37:43.7165489Z
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # entra user registrationdetails list
+
+  Date: 1/27/2024
+
+  ## 61b0c52f-a902-4769-9a09-c6628335b00a
+
+  Property | Value
+  ---------|-------
+  id | 61b0c52f-a902-4769-9a09-c6628335b00a
+  userPrincipalName | AdeleV@contoso.onmicrosoft.com
+  userDisplayName | Adele Vance
+  userType | member
+  isAdmin | false
+  isSsprRegistered | false
+  isSsprEnabled | false
+  isSsprCapable | false
+  isMfaRegistered | false
+  isMfaCapable | false
+  isPasswordlessCapable | false
+  isSystemPreferredAuthenticationMethodEnabled | false
+  userPreferredMethodForSecondaryAuthentication | none
+  lastUpdatedDateTime | 2024-01-23T19:37:43.7170699Z
+
+  ## ebd27dbd-75f2-4ef8-bd51-102c3faf62ec
+
+  Property | Value
+  ---------|-------
+  id | ebd27dbd-75f2-4ef8-bd51-102c3faf62ec
+  userPrincipalName | john.doe@contoso.onmicrosoft.com
+  userDisplayName | John Doe
+  userType | member
+  isAdmin | false
+  isSsprRegistered | false
+  isSsprEnabled | false
+  isSsprCapable | false
+  isMfaRegistered | true
+  isMfaCapable | true
+  isPasswordlessCapable | false
+  isSystemPreferredAuthenticationMethodEnabled | false
+  userPreferredMethodForSecondaryAuthentication | push
+  lastUpdatedDateTime | 2024-01-23T19:37:43.7165489Z
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/external/item/item-add.mdx

@@ -18,7 +18,7 @@ m365 external item add [options]
 `-i, --id <id>`
 : The ID of the item to create
 
-`--externalConnectionId <name>`
+`--externalConnectionId <externalConnectionId>`
 : The ID of the external connection on which to create the item
 
 `--content <content>`

package/docs/docs/cmd/file/convert/convert-pdf.mdx

@@ -55,3 +55,7 @@ Converts file from a document library to PDF and saves the converted file to the
 ```sh
 m365 file convert pdf --sourceFile "https://contoso.sharepoint.com/Shared Documents/file.docx" --targetFile "https://contoso.sharepoint.com/Shared Documents/file.pdf"
 ```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/file/file-add.mdx

@@ -62,3 +62,7 @@ Uploads file from the current folder to a document library in the specified site
 ```sh
 m365 file add --filePath file.pdf --folderUrl "https://contoso.sharepoint.com/sites/Contoso/Shared Documents" --siteUrl "https://contoso.sharepoint.com/sites/Contoso"
 ```
+
+## Response
+
+The command won't return a response on success.

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

@@ -0,0 +1,68 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# file copy
+
+Copies a file to another location using the Microsoft Graph
+
+## Usage
+
+```sh
+m365 file copy [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The URL of the site where the file is located.
+
+`-s, --sourceUrl <sourceUrl>`
+: Server-relative or absolute URL of the file.
+
+`-t, --targetUrl <targetUrl>`
+: Server-relative or absolute URL of the location.
+
+`--newName [newName]`
+: New name of the destination file.
+
+`--nameConflictBehavior [nameConflictBehavior]`
+: Behavior when a document with the same name is already present at the destination. Possible values: `fail`, `replace`, `rename`. Default is `fail`.
+```
+
+<Global />
+
+## Examples
+
+Copy a file by server-relative URL to a document library in another site collection with server relative URL
+
+```sh
+m365 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 absolute URL to a document library in another site collection with absolute URL
+
+```sh
+m365 file copy --webUrl https://contoso.sharepoint.com --sourceUrl "https://contoso.sharepoint.com/Shared Documents/Document.pdf" --targetUrl "https://contoso.sharepoint.com/sites/IT/Shared Documents"
+```
+
+Copy a file to a document library in another site collection and rename the file
+
+```sh
+m365 file copy --webUrl https://contoso.sharepoint.com --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --newName "newName"
+```
+
+Copy a file to a document library in another site collection and rename the file if a file with the same name already exists.
+
+```sh
+m365 file copy --webUrl https://contoso.sharepoint.com --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --nameConflictBehavior rename
+```
+
+Copy a file to Onedrive for business 
+
+```sh
+m365 file copy --webUrl https://contoso.sharepoint.com --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "https://contoso-my.sharepoint.com/personal/john_contoso_onmicrosoft_com/documents"
+```
+
+## Response
+
+The command won't return a response on success.