@pnp/cli-microsoft365 6.9.0-beta.289ab69 → 6.9.0-beta.6a23aba

package/docs/docs/cmd/aad/user/user-recyclebinitem-list.mdx

@@ -0,0 +1,94 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# aad user recyclebinitem list
+
+Lists users from the recycle bin in the current tenant
+
+## Usage
+
+```sh
+m365 aad user recyclebinitem list [options]
+```
+
+## Options
+
+<Global />
+
+## Examples
+
+List all removed users
+
+```sh
+m365 aad user recyclebinitem list
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "businessPhones": [],
+      "displayName": "John Doe",
+      "givenName": "John Doe",
+      "jobTitle": "Developer",
+      "mail": "john@contoso.com",
+      "mobilePhone": "0476345130",
+      "officeLocation": "Washington",
+      "preferredLanguage": "nl-BE",
+      "surname": "John",
+      "userPrincipalName": "7e06b56615f340138bf879874d52e68ajohn@contoso.com",
+      "id": "7e06b566-15f3-4013-8bf8-79874d52e68a"
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  id                                    displayName  userPrincipalName
+  ------------------------------------  -----------  -----------------------------------------------
+  7e06b566-15f3-4013-8bf8-79874d52e68a  John Doe     7e06b56615f340138bf879874d52e68ajohn@contoso.com
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,displayName,userPrincipalName
+  7e06b566-15f3-4013-8bf8-79874d52e68a,John Doe,7e06b56615f340138bf879874d52e68ajohn@contoso.com
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # aad user recyclebinitem list
+
+  Date: 14/02/2023
+
+  ## John Doe (7e06b566-15f3-4013-8bf8-79874d52e68a)
+
+  Property | Value
+  ---------|-------
+  businessPhones | []
+  displayName | John Doe
+  givenName | John Doe
+  jobTitle | Developer
+  mail | john@contoso.com
+  mobilePhone | 0476345130
+  officeLocation | Washington
+  preferredLanguage | nl-BE
+  surname | John
+  userPrincipalName | 7e06b56615f340138bf879874d52e68ajohn@contoso.com
+  id | 7e06b566-15f3-4013-8bf8-79874d52e68a
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/aad/user/user-recyclebinitem-remove.mdx

@@ -0,0 +1,55 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# aad user recyclebinitem remove
+
+Removes a user from the recycle bin in the current tenant
+
+## Usage
+
+```sh
+m365 aad user recyclebinitem remove [options]
+```
+
+## Options
+
+```md definition-list
+`--id <id>`
+: ID of the deleted user.
+
+`--confirm`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command you must be a Global administrator, User administrator or Privileged Authentication administrator.
+
+:::
+
+:::note
+
+After running this command, it may take a minute before the deleted user is effectively removed from the tenant.
+
+:::
+
+## Examples
+
+Removes a specific user from the recycle bin
+
+```sh
+m365 aad user recyclebinitem remove --id 59f80e08-24b1-41f8-8586-16765fd830d3
+```
+
+Removes a specific user from the recycle bin without confirmation prompt
+
+```sh
+m365 aad user recyclebinitem remove --id 59f80e08-24b1-41f8-8586-16765fd830d3 --confirm
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/aad/user/user-recyclebinitem-restore.mdx

@@ -0,0 +1,119 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# aad user recyclebinitem restore
+
+Restores a user from the recycle bin in the current tenant
+
+## Usage
+
+```sh
+m365 aad user recyclebinitem restore [options]
+```
+
+## Options
+
+```md definition-list
+`--id <id>`
+: ID of the deleted user.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command you must be a Global administrator, User administrator or Privileged Authentication administrator
+
+:::
+
+:::note
+
+After running this command, it may take a minute before the user will reappear in the active users.
+
+:::
+
+## Examples
+
+Restore user from the recycle bin
+
+```sh
+m365 aad user recyclebinitem restore --id 990e2425-f595-43bc-85ed-b89a44093793
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "990e2425-f595-43bc-85ed-b89a44093793",
+    "businessPhones": [],
+    "displayName": "John Doe",
+    "givenName": "John",
+    "jobTitle": "Sales Manager",
+    "mail": null,
+    "mobilePhone": null,
+    "officeLocation": null,
+    "preferredLanguage": "nl-BE",
+    "surname": "Doe",
+    "userPrincipalName": "john.doe@contoso.com",
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  businessPhones   : []
+  displayName      : John Doe
+  givenName        : John
+  id               : 990e2425-f595-43bc-85ed-b89a44093793
+  jobTitle         : Sales Manager
+  mail             : null
+  mobilePhone      : null
+  officeLocation   : null
+  preferredLanguage: nl-BE
+  surname          : Doe
+  userPrincipalName: john.doe@contoso.com
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,businessPhones,displayName,givenName,jobTitle,mail,mobilePhone,officeLocation,preferredLanguage,surname,userPrincipalName
+  990e2425-f595-43bc-85ed-b89a44093793,[],John Doe,John,Sales Manager,,,,nl-BE,Doe,john.doe@contoso.com
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # user recyclebin restore --id 990e2425-f595-43bc-85ed-b89a44093793
+
+  Date: 16/02/2023
+
+  ## John Doe (990e2425-f595-43bc-85ed-b89a44093793)
+
+  Property | Value
+  ---------|-------
+  id | 990e2425-f595-43bc-85ed-b89a44093793
+  businessPhones | []
+  displayName | John Doe
+  givenName | John
+  jobTitle | Sales Manager
+  mail | null
+  mobilePhone | null
+  officeLocation | null
+  preferredLanguage | nl-BE
+  surname | Doe
+  userPrincipalName | john.doe@contoso.com
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/aad/user/user-remove.mdx

@@ -0,0 +1,64 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# aad user remove
+
+Removes a specific user
+
+## Usage
+
+```sh
+m365 aad user remove [options]
+```
+
+## Options
+
+```md definition-list
+`--id [id]`
+: The ID of the user. Specify either `id` or `userName` but not both.
+
+`--userName [userName]`
+:	User principal name of the user. Specify either `id` or `userName` but not both.
+
+`--confirm`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+If the user with the specified id or user name doesn't exist, you will get a `Resource 'xyz' does not exist or one of its queried reference-property objects are not present.` error.
+
+:::
+
+:::info
+
+To use this command you must be a Global administrator, User administrator or Privileged Authentication administrator.
+
+:::
+
+:::note
+
+After running this command, it may take a minute before the user is effectively moved to the recycle bin.
+
+:::
+
+## Examples
+
+Removes a specific user by id
+
+```sh
+m365 aad user remove --id a33bd401-9117-4e0e-bb7b-3f61c1539e10
+```
+
+Removes a specific user by its UPN
+
+```sh
+m365 aad user remove --userName john.doe@contoso.com
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/aad/user/user-set.mdx

@@ -0,0 +1,136 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# aad user set
+
+Updates information of the specified user
+
+## Usage
+
+```sh
+m365 aad user set [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --objectId [objectId]`
+: The object ID of the user to update. Specify `objectId` or `userPrincipalName` but not both.
+
+`-n, --userPrincipalName [userPrincipalName]`
+: User principal name of the user to update. Specify `objectId` or `userPrincipalName` but not both.
+
+`--accountEnabled [accountEnabled]`
+: Boolean value specifying whether the account is enabled. Valid values are `true` or `false`.
+
+`--resetPassword`
+: If specified, the password of the user will be reset. This will make the parameter `newPassword` required.
+
+`--forceChangePasswordNextSignIn`
+: If specified, the user will have to change his password the next time they log in. Can only be set in combination with `resetPassword`.
+
+`--forceChangePasswordNextSignInWithMfa`
+: Whether the user should change his/her password on the next login and setup MFA. Can only be set in combination with `resetPassword`.
+
+`--currentPassword [currentPassword]`
+: Current password of the user that is signed in. If this parameter is set, `newPassword` is mandatory. Can't be combined with `resetPassword`.
+
+`--newPassword [newPassword]`
+: New password to be set. Must be set when specifying either `resetPassword` or `currentPassword`.
+
+`--displayName [displayName]`
+: The name to display in the address book for the user.
+
+`--firstName [firstName]`
+: The given name (first name) of the user. Maximum length is 64 characters.
+
+`--lastName [lastName]`
+: The user's surname (family name or last name). Maximum length is 64 characters.
+
+`--usageLocation [usageLocation]`
+: A two letter [country code](https://learn.microsoft.com/en-us/partner-center/commercial-marketplace-co-sell-location-codes#country-and-region-codes) (ISO standard 3166). Required for users that will be assigned licenses.
+
+`--officeLocation [officeLocation]` 
+: The office location in the user's place of business.
+
+`--jobTitle [jobTitle]`
+: The user's job title. Maximum length is 128 characters.
+
+`--companyName [companyName]`
+: The company name which the user is associated. The maximum length is 64 characters.
+
+`--department [department]`
+: The name for the department in which the user works. Maximum length is 64 characters.
+
+`--preferredLanguage [preferredLanguage]`
+: The preferred language for the user. Should follow [ISO 639-1 Code](https://learn.microsoft.com/en-us/openspecs/office_standards/ms-oe376/6c085406-a698-4e12-9d4d-c3b0ee3dbc4a). Example: `en-US`.
+
+`--managerUserId [managerUserId]`
+: User ID of the user's manager. Specify `managerUserId`, `managerUserName` or `removeManager` but not both.
+
+`--managerUserName [managerUserName]`
+: User principal name of the manager. Specify `managerUserId`, `managerUserName` or `removeManager` but not both.
+
+`--removeManager`
+: Remove currently set manager. The user will have no manager when this flag is set. Specify `managerUserId`, `managerUserName` or `removeManager` but not both.
+```
+
+<Global />
+
+## Remarks
+
+This command allows using unknown options. For a comprehensive list of user properties, please refer to the [Graph documentation page](https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0#properties).
+
+If the user with the specified ID or username doesn't exist, or 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
+
+Update specific property _department_ of user with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_
+
+```sh
+m365 aad user set --objectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --Department IT
+```
+
+Update multiple properties of user by name
+```sh
+m365 aad user set --userPrincipalName steve@contoso.onmicrosoft.com --firstName John --lastName Doe --jobTitle "Sales Manager" --companyName Contoso --department Sales --officeLocation "New York"
+```
+
+Enable user with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_
+
+```sh
+m365 aad user set --objectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --accountEnabled true
+```
+
+Disable user with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_
+
+```sh
+m365 aad user set --objectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --accountEnabled false
+```
+
+Reset password of a given user by userPrincipalName and require the user to change the password on the next sign in
+
+```sh
+m365 aad user set --userPrincipalName steve@contoso.onmicrosoft.com --resetPassword --newPassword 6NLUId79Lc24 --forceChangePasswordNextSignIn
+```
+
+Change password of the currently logged in user
+
+```sh
+m365 aad user set --objectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --currentPassword SLBF5gnRtyYc --newPassword 6NLUId79Lc24
+```
+
+Updates a user with a manager
+
+```sh
+m365 aad user set --displayName "John Doe" --userName "john.doe@contoso.com" --managerUserName "adele@contoso.com"
+```
+
+Updates a user by removing its manager
+
+```sh
+m365 aad user set --userName "john.doe@contoso.com" --removeManager
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/aad/user/user-signin-list.mdx

@@ -0,0 +1,85 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# aad user signin list
+
+Retrieves the Azure AD user sign-ins for the tenant
+
+## Usage
+
+```sh
+m365 aad user signin list [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --userName [userName]`
+: Filter the user sign-ins by given User's UPN (user principal name), eg. `johndoe@example.com`. Specify either userName or userId
+
+`--userId [userId]`
+: Filter the user sign-ins by given User's Id. Specify either userName or userId
+
+`--appDisplayName [appDisplayName]`
+: Filter the user sign-ins by the given application display name. Specify either appDisplayName or appId
+
+`--appId [appId]`
+: Filter the user sign-ins by the given application identifier. Specify either appDisplayName or appId
+```
+
+<Global />
+
+## Examples
+
+Get all user's sign-ins in your tenant
+
+```sh
+m365 aad user signin list
+```
+
+Get all user's sign-ins filter by given user's UPN in the tenant
+
+```sh
+m365 aad user signin list --userName 'johndoe@example.com'
+```
+
+Get all user's sign-ins filter by given user's Id in the tenant
+
+```sh
+m365 aad user signin list --userId '11111111-1111-1111-1111-111111111111'
+```
+
+Get all user's sign-ins filter by given application display name in the tenant
+
+```sh
+m365 aad user signin list --appDisplayName 'Graph explorer'
+```
+
+Get all user's sign-ins filter by given application identifier in the tenant
+
+```sh
+m365 aad user signin list --appId '00000000-0000-0000-0000-000000000000'
+```
+
+Get all user's sign-ins filter by given user's UPN and application display name in the tenant
+
+```sh
+m365 aad user signin list --userName 'johndoe@example.com' --appDisplayName 'Graph explorer'
+```
+
+Get all user's sign-ins filter by given user's Id and application display name in the tenant
+
+```sh
+m365 aad user signin list --userId '11111111-1111-1111-1111-111111111111' --appDisplayName 'Graph explorer'
+```
+
+Get all user's sign-ins filter by given user's UPN and application identifier in the tenant
+
+```sh
+m365 aad user signin list --userName 'johndoe@example.com' --appId '00000000-0000-0000-0000-000000000000'
+```
+
+Get all user's sign-ins filter by given user's Id and application identifier in the tenant
+
+```sh
+m365 aad user signin list --userId '11111111-1111-1111-1111-111111111111' --appId '00000000-0000-0000-0000-000000000000'
+```

package/docs/docs/cmd/adaptivecard/adaptivecard-send.mdx

@@ -0,0 +1,132 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# adaptivecard send
+
+Sends adaptive card to the specified URL
+
+## Usage
+
+```sh
+m365 adaptivecard send [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --url <url>`
+: URL where to send the card to.
+
+`-t, --title [title]`
+: Title of the card. Specify either `title` or `card` but not both.
+
+`-d, --description [description]`
+: Contents of the card.
+
+`-i, --imageUrl [imageUrl]`
+: URL of the image to include on the card.
+
+`-a, --actionUrl [actionUrl]`
+: URL that users should be sent to after clicking the **View** button on the card.
+
+`--card [card]`
+: Card definition. Specify either `title` or `card` but not both.
+
+`--cardData [cardData]`
+: Card data. If your card is a card template, using cardData you can apply data to it. If you specify cardData, unknown options will be ignored.
+```
+
+<Global />
+
+## Remarks
+
+Using this command you can send either a predefined or a custom adaptive card to the specified URL. To send a predefined adaptive card, specify one or more options: `title`, `description`, `imageUrl`, `actionUrl`. To specify a custom card, specify the card's JSON contents using the `card` option.
+
+When sending both predefined and custom cards, you can specify arbitrary options. With predefined cards, these options will be listed in a FactSet. With custom card, you control how the data will be presented on the card.
+
+The predefined card is automatically adjusted based on which options have been specified (`title`, `description`, `imageUrl`, `actionUrl`). If you don't specify a particular option, that portion of the card will not be included in the sent card.
+
+If your custom card is a card template (card with placeholders like `${title}`), you can fill it with data either by specifying the complete data object using the `cardData` option, or by passing any number of arbitrary options that will be mapped onto the card. The arbitrary properties should not match any of the global options like `output`, `query`, `debug`, etc. Data options like `title`, `description`, `imageUrl` and `actionUrl` will be mapped onto the card as well.
+
+:::caution Escaping JSON in PowerShell
+
+When using the `--card` and `--cardData` options it's possible to enter a JSON string. In PowerShell 5 to 7.2 [specific escaping rules](./../../user-guide/using-cli.mdx#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../user-guide/using-cli.mdx#passing-complex-content-into-cli-options) instead.
+
+:::
+
+## Examples
+
+Send a predefined adaptive card with just title.
+
+```sh
+m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --title "CLI for Microsoft 365 v3.4"
+```
+
+Send a predefined adaptive card with just description.
+
+```sh
+m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --description "New release of CLI for Microsoft 365"
+```
+
+Send card with title and description.
+
+```sh
+m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --title "CLI for Microsoft 365 v3.4" --description "New release of CLI for Microsoft 365"
+```
+
+Send card with title, description, and image.
+
+```sh
+m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --title "CLI for Microsoft 365 v3.4" --description "New release of CLI for Microsoft 365" --imageUrl "https://contoso.com/image.gif"
+```
+
+Send card with title, description, and action.
+
+```sh
+m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --title "CLI for Microsoft 365 v3.4" --description "New release of CLI for Microsoft 365" --actionUrl "https://aka.ms/cli-m365"
+```
+
+Send card with title, description, image, and action.
+
+```sh
+m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --title "CLI for Microsoft 365 v3.4" --description "New release of CLI for Microsoft 365" --imageUrl "https://contoso.com/image.gif" --actionUrl "https://aka.ms/cli-m365"
+```
+
+Send card with title, description, action, and unknown options.
+
+```sh
+m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --title "CLI for Microsoft 365 v3.4" --description "New release of CLI for Microsoft 365" --actionUrl "https://aka.ms/cli-m365" --Version "v3.4.0" --ReleaseNotes "https://pnp.github.io/cli-microsoft365/about/release-notes/#v340"
+```
+
+Send custom card without any data.
+
+```sh
+m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --card '{"type":"AdaptiveCard","body":[{"type":"TextBlock","size":"Medium","weight":"Bolder","text":"CLI for Microsoft 365 v3.4"},{"type":"TextBlock","text":"New release of CLI for Microsoft 365","wrap":true}],"actions":[{"type":"Action.OpenUrl","title":"View","url":"https://aka.ms/cli-m365"}],"$schema":"http://adaptivecards.io/schemas/adaptive-card.json","version":"1.2"}'
+```
+
+Send custom card with just title merged.
+
+```sh
+m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --card '{"type":"AdaptiveCard","body":[{"type":"TextBlock","size":"Medium","weight":"Bolder","text":"${title}"}],"$schema":"http://adaptivecards.io/schemas/adaptive-card.json","version":"1.2"}' --title "CLI for Microsoft 365 v3.4"
+```
+
+Send custom card with all known options merged.
+
+```sh
+m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --card '{"type":"AdaptiveCard","body":[{"type":"TextBlock","size":"Medium","weight":"Bolder","text":"${title}"},{"type":"TextBlock","text":"${description}","wrap":true},{"type":"FactSet","facts":[{"$data":"${properties}","title":"${key}:","value":"${value}"}]}],"actions":[{"type":"Action.OpenUrl","title":"View","url":"${actionUrl}"}],"$schema":"http://adaptivecards.io/schemas/adaptive-card.json","version":"1.2"}' --title "CLI for Microsoft 365 v3.4" --description "New release of CLI for Microsoft 365" --imageUrl "https://contoso.com/image.gif" --actionUrl "https://aka.ms/cli-m365"
+```
+
+Send custom card with unknown option merged.
+
+```sh
+m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --card '{"type":"AdaptiveCard","body":[{"type":"TextBlock","size":"Medium","weight":"Bolder","text":"${Title}"}],"$schema":"http://adaptivecards.io/schemas/adaptive-card.json","version":"1.2"}' --Title "CLI for Microsoft 365 v3.4"
+```
+
+Send custom card with card data.
+
+```sh
+m365 adaptivecard send --url https://contoso.webhook.office.com/webhookb2/892e8ed3-997c-4b6e-8f8a-7f32728a8a87@f7322380-f203-42ff-93e8-66e266f6d2e4/IncomingWebhook/fcc6565ec7a944928bd43d6fc193b258/4f0482d4-b147-4f67-8a61-11f0a5019547 --card '{"type":"AdaptiveCard","body":[{"type":"TextBlock","size":"Medium","weight":"Bolder","text":"${title}"},{"type":"TextBlock","text":"${description}","wrap":true},{"type":"FactSet","facts":[{"$data":"${properties}","title":"${key}:","value":"${value}"}]}],"actions":[{"type":"Action.OpenUrl","title":"View","url":"${viewUrl}"}],"$schema":"http://adaptivecards.io/schemas/adaptive-card.json","version":"1.2"}' --cardData '{"title":"Publish Adaptive Card Schema","description":"Now that we have defined the main rules and features of the format, we need to produce a schema and publish it to GitHub. The schema will be the starting point of our reference documentation.","creator":{"name":"Matt Hidinger","profileImage":"https://pbs.twimg.com/profile_images/3647943215/d7f12830b3c17a5a9e4afcc370e3a37e_400x400.jpeg"},"createdUtc":"2017-02-14T06:08:39Z","viewUrl":"https://adaptivecards.io","properties":[{"key":"Board","value":"Adaptive Cards"},{"key":"List","value":"Backlog"},{"key":"Assigned to","value":"Matt Hidinger"},{"key":"Due date","value":"Not set"}]}'
+```
+
+## Response
+
+If the response is successful, it will return the body of the response.