@pnp/cli-microsoft365 6.8.0-beta.f473be5 → 6.9.0-beta.1cd2525

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

@@ -0,0 +1,120 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# teams tab add
+
+Add a tab to the specified channel
+
+## Usage
+
+```sh
+m365 teams tab add [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --teamId <teamId>`
+: The ID of the team to where the channel exists
+
+`-c, --channelId <channelId>`
+: The ID of the channel to add a tab to
+
+`--appId <appId>`
+: The ID of the Teams app that contains the Tab
+
+`--appName <appName>`
+: The name of the Teams app that contains the Tab
+
+`--contentUrl <contentUrl>`
+: The URL used for rendering Tab contents
+
+`--entityId [entityId]`
+: A unique identifier for the Tab
+
+`--removeUrl [removeUrl]`
+: The URL displayed when a Tab is removed
+
+`--websiteUrl [websiteUrl]`
+: The URL for showing tab contents outside of Teams
+```
+
+<Global />
+
+## Remarks
+
+The corresponding app must already be installed in the team.
+
+## Examples
+  
+Add teams tab for website
+
+```sh
+m365 teams tab add --teamId 00000000-0000-0000-0000-000000000000 --channelId 19:00000000000000000000000000000000@thread.skype --appId 06805b9e-77e3-4b93-ac81-525eb87513b8 --appName 'My Contoso Tab' --contentUrl 'https://www.contoso.com/Orders/2DCA2E6C7A10415CAF6B8AB6661B3154/tabView'
+```
+
+Add teams tab for website with additional configuration which is unknown
+
+```sh
+m365 teams tab add --teamId 00000000-0000-0000-0000-000000000000 --channelId 19:00000000000000000000000000000000@thread.skype --appId 06805b9e-77e3-4b93-ac81-525eb87513b8 --appName 'My Contoso Tab' --contentUrl 'https://www.contoso.com/Orders/2DCA2E6C7A10415CAF6B8AB6661B3154/tabView' --test1 'value for test1'
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ``` json
+  {
+    "id": "8e454194-04c9-40aa-a9f3-7ab42d9541b5",
+    "displayName": "'My Contoso Tab'",
+    "webUrl": "https://teams.microsoft.com/l/channel/19%3aB3nCnLKwwCoGDEADyUgQ5kJ5Pkekujyjmwxp7uhQeAE1%40thread.tacv2/tab%3a%3a8e454194-04c9-40aa-a9f3-7ab42d9541b5?label=%My/20Contoso%20Tab%27&groupId=aee5a2c9-b1df-45ac-9964-c708e760a045&tenantId=92e59666-257b-49c3-b1fa-1bae8107f6ba",
+    "configuration": {
+      "entityId": null,
+      "contentUrl": "https://www.contoso.com/Orders/2DCA2E6C7A10415CAF6B8AB6661B3154/tabView",
+      "removeUrl": null,
+      "websiteUrl": null
+    }
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ``` text
+  configuration: {"entityId":null,"contentUrl":"https://www.contoso.com/Orders/2DCA2E6C7A10415CAF6B8AB6661B3154/tabView","removeUrl":null,"websiteUrl":null}
+  displayName  : 'My Contoso Tab'
+  id           : 37d2294f-6dc0-4232-8718-d388f25ee696
+  webUrl       : https://teams.microsoft.com/l/channel/19%3aB3nCnLKwwCoGDEADyUgQ5kJ5Pkekujyjmwxp7uhQeAE1%40thread.tacv2/tab%3a%3a37d2294f-6dc0-4232-8718-d388f25ee696?label=%My%20Contoso%20Tab%27&groupId=aee5a2c9-b1df-45ac-9964-c708e760a045&tenantId=92e59666-257b-49c3-b1fa-1bae8107f6ba
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ``` text
+  id,displayName,webUrl,configuration
+  0d7e343d-b233-4039-ae77-88928d4b275b,'My Contoso Tab',https://teams.microsoft.com/l/channel/19%3aB3nCnLKwwCoGDEADyUgQ5kJ5Pkekujyjmwxp7uhQeAE1%40thread.tacv2/tab%3a%3a0d7e343d-b233-4039-ae77-88928d4b275b?label=%My%20Contoso%20Tab%27&groupId=aee5a2c9-b1df-45ac-9964-c708e760a045&tenantId=92e59666-257b-49c3-b1fa-1bae8107f6ba,"{""entityId"":null,""contentUrl"":""https://www.contoso.com/Orders/2DCA2E6C7A10415CAF6B8AB6661B3154/tabView"",""removeUrl"":null,""websiteUrl"":null}"
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # teams tab add --teamId "aee5a2c9-b1df-45ac-9964-c708e760a045" --channelId "19:B3nCnLKwwCoGDEADyUgQ5kJ5Pkekujyjmwxp7uhQeAE1@thread.tacv2" --appId "com.microsoft.teamspace.tab.web" --appName "My Contoso Tab" --contentUrl "https://www.contoso.com/Orders/2DCA2E6C7A10415CAF6B8AB6661B3154/tabView"
+
+  Date: 1/3/2023
+
+  ## My Contoso Tab (37d2294f-6dc0-4232-8718-d388f25ee696)
+
+  Property | Value
+  ---------|-------
+  id | 37d2294f-6dc0-4232-8718-d388f25ee696
+  displayName | My Contoso Tab
+  webUrl | https://teams.microsoft.com/l/channel/19%3aB3nCnLKwwCoGDEADyUgQ5kJ5Pkekujyjmwxp7uhQeAE1%40thread.tacv2/tab%3a%3a37d2294f-6dc0-4232-8718-d388f25ee696?label=%My%20Contoso%20Tab%27&groupId=aee5a2c9-b1df-45ac-9964-c708e760a045&tenantId=92e59666-257b-49c3-b1fa-1bae8107f6ba
+  configuration | {"entityId":null,"contentUrl":"https://www.contoso.com/Orders/2DCA2E6C7A10415CAF6B8AB6661B3154/tabView","removeUrl":null,"websiteUrl":null}
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/teams/tab/tab-get.mdx

@@ -0,0 +1,115 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# teams tab get
+
+Gets information about the specified Microsoft Teams tab
+
+## Usage
+
+```sh
+m365 teams tab get [options]
+```
+
+## Options
+
+```md definition-list
+`--teamId [teamId]`
+: The ID of the Microsoft Teams team where the tab is located. Specify either teamId or teamName but not both
+
+`--teamName [teamName]`
+: The display name of the Microsoft Teams team where the tab is located. Specify either teamId or teamName but not both
+
+`--channelId [channelId]`
+: The ID of the Microsoft Teams channel where the tab is located. Specify either channelId or channelName but not both
+
+`--channelName [channelName]`
+: The display name of the Microsoft Teams channel where the tab is located. Specify either channelId or channelName but not both
+
+`-i, --id [id]`
+: The ID of the Microsoft Teams tab. Specify either `id` or `name` but not both
+
+`-n, --name [name]`
+: The display name of the Microsoft Teams tab. Specify either `id` or `name` but not both
+```
+
+<Global />
+
+## Remarks
+
+You can only retrieve tabs for teams of which you are a member.
+
+## Examples
+
+Get a Microsoft Teams Tab with ID _1432c9da-8b9c-4602-9248-e0800f3e3f07_
+
+```sh
+m365 teams tab get --teamId 00000000-0000-0000-0000-000000000000 --channelId 19:00000000000000000000000000000000@thread.skype --id 1432c9da-8b9c-4602-9248-e0800f3e3f07
+```
+
+Get a Microsoft Teams Tab with name _Tab Name_
+
+```sh
+m365 teams tab get --teamName "Team Name" --channelName "Channel Name" --name "Tab Name"
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ``` json
+  {
+    "id": "34991fbf-59f4-48d9-b094-b9d64d550e23",
+    "displayName": "Tab Name",
+    "webUrl": "https://teams.microsoft.com/l/entity/1542629c-01b3-4a6d-8f76-1938b779e48d/_djb2_msteams_prefix_34991fbf-59f4-48d9-b094-b9d64d550e23?webUrl=https%3a%2f%2fteams.contoso.ai%2fmsteams%2fcontent%2ftab%2fteam%3ftheme%3d%7btheme%7d&label=My%20Contoso%20Tab&context=%7b%0d%0a++%22canvasUrl%22%3a+%22https%3a%2f%2fteams.contoso.ai%2fmsteams%2fcontent%2ftab%2fteam%3ftheme%3d%7btheme%7d%22%2c%0d%0a++%22channelId%22%3a+%2219%3aB3nCnLKwwCoGDEADyUgQ5kJ5Pkekujyjmwxp7uhQeAE1%40thread.tacv2%22%2c%0d%0a++%22subEntityId%22%3a+null%0d%0a%7d&groupId=aee5a2c9-b1df-45ac-9964-c708e760a045&tenantId=92e59666-257b-49c3-b1fa-1bae8107f6ba",
+    "configuration": {
+      "entityId": "surveys_list:19:B3nCnLKwwCoGDEADyUgQ5kJ5Pkekujyjmwxp7uhQeAE1@thread.tacv2:ps67c9jyf3a30j2j5eum72",
+      "contentUrl": "https://teams.contoso.ai/msteams/content/tab/team?theme={theme}",
+      "removeUrl": "https://teams.contoso.ai/msteams/content/tabdelete?theme={theme}",
+      "websiteUrl": "https://teams.contoso.ai/msteams/content/tab/team?theme={theme}",
+      "dateAdded": "2022-10-31T12:17:58.632Z"
+    }
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ``` text
+  configuration: {"entityId":"surveys_list:19:B3nCnLKwwCoGDEADyUgQ5kJ5Pkekujyjmwxp7uhQeAE1@thread.tacv2:ps67c9jyf3a30j2j5eum72","contentUrl":"https://teams.contoso.ai/msteams/content/tab/team?theme={theme}","removeUrl":"https://teams.contoso.ai/msteams/content/tabdelete?theme={theme}","websiteUrl":"https://teams.contoso.ai/msteams/content/tab/team?theme={theme}","dateAdded":"2022-10-31T12:17:58.632Z"}
+  displayName  : Tab Name
+  id           : 34991fbf-59f4-48d9-b094-b9d64d550e23
+  webUrl       : https://teams.microsoft.com/l/entity/1542629c-01b3-4a6d-8f76-1938b779e48d/_djb2_msteams_prefix_34991fbf-59f4-48d9-b094-b9d64d550e23?webUrl=https%3a%2f%2fteams.contoso.ai%2fmsteams%2fcontent%2ftab%2fteam%3ftheme%3d%7btheme%7d&label=contoso&context=%7b%0d%0a++%22canvasUrl%22%3a+%22https%3a%2f%2fteams.contoso.ai%2fmsteams%2fcontent%2ftab%2fteam%3ftheme%3d%7btheme%7d%22%2c%0d%0a++%22channelId%22%3a+%2219%3aB3nCnLKwwCoGDEADyUgQ5kJ5Pkekujyjmwxp7uhQeAE1%40thread.tacv2%22%2c%0d%0a++%22subEntityId%22%3a+null%0d%0a%7d&groupId=aee5a2c9-b1df-45ac-9964-c708e760a045&tenantId=92e59666-257b-49c3-b1fa-1bae8107f6ba
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ``` text
+  id,displayName,webUrl,configuration
+  34991fbf-59f4-48d9-b094-b9d64d550e23,Tab Name,https://teams.microsoft.com/l/entity/1542629c-01b3-4a6d-8f76-1938b779e48d/_djb2_msteams_prefix_34991fbf-59f4-48d9-b094-b9d64d550e23?webUrl=https%3a%2f%2fteams.contoso.ai%2fmsteams%2fcontent%2ftab%2fteam%3ftheme%3d%7btheme%7d&label=My%20Contoso%20Tab&context=%7b%0d%0a++%22canvasUrl%22%3a+%22https%3a%2f%2fteams.contoso.ai%2fmsteams%2fcontent%2ftab%2fteam%3ftheme%3d%7btheme%7d%22%2c%0d%0a++%22channelId%22%3a+%2219%3aB3nCnLKwwCoGDEADyUgQ5kJ5Pkekujyjmwxp7uhQeAE1%40thread.tacv2%22%2c%0d%0a++%22subEntityId%22%3a+null%0d%0a%7d&groupId=aee5a2c9-b1df-45ac-9964-c708e760a045&tenantId=92e59666-257b-49c3-b1fa-1bae8107f6ba,"{""entityId"":""surveys_list:19:B3nCnLKwwCoGDEADyUgQ5kJ5Pkekujyjmwxp7uhQeAE1@thread.tacv2:ps67c9jyf3a30j2j5eum72"",""contentUrl"":""https://teams.contoso.ai/msteams/content/tab/team?theme={theme}"",""removeUrl"":""https://teams.contoso.ai/msteams/content/tabdelete?theme={theme}"",""websiteUrl"":""https://teams.contoso.ai/msteams/content/tab/team?theme={theme}"",""dateAdded"":""2022-10-31T12:17:58.632Z""}"
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # teams tab get --teamId "aee5a2c9-b1df-45ac-9964-c708e760a045" --channelId "19:B3nCnLKwwCoGDEADyUgQ5kJ5Pkekujyjmwxp7uhQeAE1@thread.tacv2" --id "34991fbf-59f4-48d9-b094-b9d64d550e23"
+
+  Date: 1/3/2023
+
+  ## Tab Name (34991fbf-59f4-48d9-b094-b9d64d550e23)
+
+  Property | Value
+  ---------|-------
+  id | 34991fbf-59f4-48d9-b094-b9d64d550e23
+  displayName | Tab Name
+  webUrl | https://teams.microsoft.com/l/entity/1542629c-01b3-4a6d-8f76-1938b779e48d/_djb2_msteams_prefix_34991fbf-59f4-48d9-b094-b9d64d550e23?webUrl=https%3a%2f%2fteams.contoso.ai%2fmsteams%2fcontent%2ftab%2fteam%3ftheme%3d%7btheme%7d&label=My%20Contoso%20Tab&context=%7b%0d%0a++%22canvasUrl%22%3a+%22https%3a%2f%2fteams.contoso.ai%2fmsteams%2fcontent%2ftab%2fteam%3ftheme%3d%7btheme%7d%22%2c%0d%0a++%22channelId%22%3a+%2219%3aB3nCnLKwwCoGDEADyUgQ5kJ5Pkekujyjmwxp7uhQeAE1%40thread.tacv2%22%2c%0d%0a++%22subEntityId%22%3a+null%0d%0a%7d&groupId=aee5a2c9-b1df-45ac-9964-c708e760a045&tenantId=92e59666-257b-49c3-b1fa-1bae8107f6ba
+  configuration | {"entityId":surveys_list:19:B3nCnLKwwCoGDEADyUgQ5kJ5Pkekujyjmwxp7uhQeAE1@thread.tacv2:ps67c9jyf3a30j2j5eum72,"contentUrl":https://teams.contoso.ai/msteams/content/tab/team?theme={theme},"removeUrl":https://teams.contoso.ai/msteams/content/tabdelete?theme={theme},"websiteUrl":https://teams.contoso.ai/msteams/content/tab/team?theme={theme},"dateAdded":2022-10-31T12:17:58.632Z}
+  ```
+
+  </TabItem>
+</Tabs>
+

package/docs/docs/cmd/teams/tab/tab-list.mdx

@@ -0,0 +1,115 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# teams tab list
+
+Lists tabs in the specified Microsoft Teams channel
+
+## Usage
+
+```sh
+m365 teams tab list [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --teamId <teamId>`
+: The ID of the Microsoft Teams team where the channel is located
+
+`-c, --channelId <channelId>`
+: The ID of the channel for which to list tabs
+```
+
+<Global />
+
+## Remarks
+
+You can only retrieve tabs for teams of which you are a member.
+
+Tabs _Conversations_ and _Files_ are present in every team and therefore not included in the list of available tabs.
+
+## Examples
+  
+List all tabs in a Microsoft Teams channel
+
+```sh
+m365 teams tab list --teamId 00000000-0000-0000-0000-000000000000 --channelId 19:00000000000000000000000000000000@thread.skype
+```
+
+Include all the values from the tab configuration and associated teams app
+
+```sh
+m365 teams tab list --teamId 00000000-0000-0000-0000-000000000000 --channelId 19:00000000000000000000000000000000@thread.skype --output json
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ``` json
+  [
+    {
+      "id": "34991fbf-59f4-48d9-b094-b9d64d550e23",
+      "displayName": "My Contoso Tab",
+      "webUrl": "https://teams.microsoft.com/l/entity/1542629c-01b3-4a6d-8f76-1938b779e48d/_djb2_msteams_prefix_34991fbf-59f4-48d9-b094-b9d64d550e23?webUrl=https%3a%2f%2fteams.contoso.ai%2fmsteams%2fcontent%2ftab%2fteam%3ftheme%3d%7btheme%7d&label=My%20Contoso%20Tab&context=%7b%0d%0a++%22canvasUrl%22%3a+%22https%3a%2f%2fteams.contoso.ai%2fmsteams%2fcontent%2ftab%2fteam%3ftheme%3d%7btheme%7d%22%2c%0d%0a++%22channelId%22%3a+%2219%3aB3nCnLKwwCoGDEADyUgQ5kJ5Pkekujyjmwxp7uhQeAE1%40thread.tacv2%22%2c%0d%0a++%22subEntityId%22%3a+null%0d%0a%7d&groupId=aee5a2c9-b1df-45ac-9964-c708e760a045&tenantId=92e59666-257b-49c3-b1fa-1bae8107f6ba",
+      "configuration": {
+        "entityId": "surveys_list:19:B3nCnLKwwCoGDEADyUgQ5kJ5Pkekujyjmwxp7uhQeAE1@thread.tacv2:ps67c9jyf3a30j2j5eum72",
+        "contentUrl": "https://teams.contoso.ai/msteams/content/tab/team?theme={theme}",
+        "removeUrl": "https://teams.contoso.ai/msteams/content/tabdelete?theme={theme}",
+        "websiteUrl": "https://teams.contoso.ai/msteams/content/tab/team?theme={theme}",
+        "dateAdded": "2022-10-31T12:17:58.632Z"
+      },
+      "teamsApp": {
+        "id": "1542629c-01b3-4a6d-8f76-1938b779e48d",
+        "externalId": null,
+        "displayName": "My Contoso Tab",
+        "distributionMethod": "store"
+      },
+      "teamsAppTabId": "1542629c-01b3-4a6d-8f76-1938b779e48d"
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ``` text
+  displayName  : My Contoso Tab
+  id           : 34991fbf-59f4-48d9-b094-b9d64d550e23
+  teamsAppTabId: 1542629c-01b3-4a6d-8f76-1938b779e48d
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ``` text
+  id,displayName,teamsAppTabId
+  34991fbf-59f4-48d9-b094-b9d64d550e23,My Contoso Tab,1542629c-01b3-4a6d-8f76-1938b779e48d
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # teams tab list --teamId "aee5a2c9-b1df-45ac-9964-c708e760a045" --channelId "19:B3nCnLKwwCoGDEADyUgQ5kJ5Pkekujyjmwxp7uhQeAE1@thread.tacv2"
+
+  Date: 1/3/2023
+
+  ## Wiki (34991fbf-59f4-48d9-b094-b9d64d550e23)
+
+  Property | Value
+  ---------|-------
+  id | 34991fbf-59f4-48d9-b094-b9d64d550e23
+  displayName | My Contoso Tab
+  webUrl | https://teams.microsoft.com/l/entity/1542629c-01b3-4a6d-8f76-1938b779e48d/_djb2_msteams_prefix_34991fbf-59f4-48d9-b094-b9d64d550e23?webUrl=https%3a%2f%2fteams.contoso.ai%2fmsteams%2fcontent%2ftab%2fteam%3ftheme%3d%7btheme%7d&label=My%20Contoso%20Tab&context=%7b%0d%0a++%22canvasUrl%22%3a+%22https%3a%2f%2fteams.contoso.ai%2fmsteams%2fcontent%2ftab%2fteam%3ftheme%3d%7btheme%7d%22%2c%0d%0a++%22channelId%22%3a+%2219%3aB3nCnLKwwCoGDEADyUgQ5kJ5Pkekujyjmwxp7uhQeAE1%40thread.tacv2%22%2c%0d%0a++%22subEntityId%22%3a+null%0d%0a%7d&groupId=aee5a2c9-b1df-45ac-9964-c708e760a045&tenantId=92e59666-257b-49c3-b1fa-1bae8107f6ba
+  configuration | {"entityId":surveys_list:19:B3nCnLKwwCoGDEADyUgQ5kJ5Pkekujyjmwxp7uhQeAE1@thread.tacv2:ps67c9jyf3a30j2j5eum72,"contentUrl":https://teams.contoso.ai/msteams/content/tab/team?theme={theme},"removeUrl":https://teams.contoso.ai/msteams/content/tabdelete?theme={theme},"websiteUrl":https://teams.contoso.ai/msteams/content/tab/team?theme={theme},"dateAdded":2022-10-31T12:17:58.632Z}
+  teamsApp | {"id":"1542629c-01b3-4a6d-8f76-1938b779e48d","externalId":null,"displayName":"My Contoso Tab","distributionMethod":"store"}
+  teamsAppTabId | 1542629c-01b3-4a6d-8f76-1938b779e48d
+  ```
+
+  </TabItem>
+</Tabs>
+

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

@@ -0,0 +1,51 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# teams tab remove
+
+Removes a tab from the specified channel
+
+## Usage
+
+```sh
+m365 teams tab remove [options]
+```
+
+## Options
+
+```md definition-list
+`-t, --teamId <teamId>`
+: The ID of the team where the tab exists
+
+`-c, --channelId <channelId>`
+: The ID of the channel to remove the tab from
+
+`-i, --id <id>`
+: The ID of the tab to remove
+
+`--confirm`
+: Don't prompt for confirmation
+```
+
+<Global />
+
+## Examples
+
+Removes a tab from the specified channel. Will prompt for confirmation
+
+```sh
+m365 teams tab remove --teamId 00000000-0000-0000-0000-000000000000 --channelId 19:00000000000000000000000000000000@thread.skype --id 06805b9e-77e3-4b93-ac81-525eb87513b8
+```
+
+Removes a tab from the specified channel without prompting for confirmation
+
+```sh
+m365 teams tab remove --teamId 00000000-0000-0000-0000-000000000000 --channelId 19:00000000000000000000000000000000@thread.skype --id 06805b9e-77e3-4b93-ac81-525eb87513b8 --confirm
+```
+
+## Response
+
+The command won't return a response on success.
+
+## More information
+
+- Delete tab from channel: [https://docs.microsoft.com/en-us/graph/api/teamstab-delete?view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/teamstab-delete?view=graph-rest-1.0)