@pnp/cli-microsoft365 5.2.0-beta.0f1c454 → 5.2.0-beta.6dee8b6

package/docs/docs/cmd/spo/theme/theme-get.md

@@ -28,4 +28,4 @@ m365 spo theme get --name Contoso-Blue
 
 ## More information
 
-- SharePoint site theming: [https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-theming/sharepoint-site-theming-overview](https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-theming/sharepoint-site-theming-overview)
+- SharePoint site theming: [https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-theming/sharepoint-site-theming-overview](https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-theming/sharepoint-site-theming-overview)

package/docs/docs/cmd/spo/theme/theme-list.md

@@ -25,4 +25,4 @@ m365 spo theme list
 
 ## More information
 
-- SharePoint site theming: [https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-theming/sharepoint-site-theming-overview](https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-theming/sharepoint-site-theming-overview)
+- SharePoint site theming: [https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-theming/sharepoint-site-theming-overview](https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-theming/sharepoint-site-theming-overview)

package/docs/docs/cmd/spo/theme/theme-remove.md

@@ -37,4 +37,4 @@ m365 spo theme remove --name Contoso-Blue --confirm
 
 ## More information
 
-- SharePoint site theming: [https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-theming/sharepoint-site-theming-overview](https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-theming/sharepoint-site-theming-overview)
+- SharePoint site theming: [https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-theming/sharepoint-site-theming-overview](https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-theming/sharepoint-site-theming-overview)

package/docs/docs/cmd/spo/user/user-remove.md

@@ -44,4 +44,4 @@ m365 spo user remove --webUrl "https://contoso.sharepoint.com/sites/HR" --loginN
 
 ## More information
 
-- Remove-PnPUser - [https://docs.microsoft.com/en-us/powershell/module/sharepoint-pnp/remove-pnpuser?view=sharepoint-ps](https://docs.microsoft.com/en-us/powershell/module/sharepoint-pnp/remove-pnpuser?view=sharepoint-ps)
+- Remove-PnPUser - [https://docs.microsoft.com/en-us/powershell/module/sharepoint-pnp/remove-pnpuser?view=sharepoint-ps](https://docs.microsoft.com/en-us/powershell/module/sharepoint-pnp/remove-pnpuser?view=sharepoint-ps)

package/docs/docs/cmd/spo/web/web-add.md

@@ -54,4 +54,4 @@ Create subsite with the same navigation as the parent site
 
 ```sh
 m365 spo web add --title Subsite --webUrl subsite --webTemplate STS#0 --parentWebUrl https://contoso.sharepoint.com --inheritNavigation
-```
+```

package/docs/docs/cmd/spo/web/web-clientsidewebpart-list.md

@@ -21,4 +21,4 @@ Lists all the available client-side web parts for the specified site
 
 ```sh
 m365 spo web clientsidewebpart list --webUrl https://contoso.sharepoint.com
-```
+```

package/docs/docs/cmd/spo/web/web-get.md

@@ -30,4 +30,4 @@ Retrieve information about the site _https://contoso.sharepoint.com/subsite_ alo
 
 ```sh
 m365 spo web get --webUrl https://contoso.sharepoint.com/subsite --withGroups
-```
+```

package/docs/docs/cmd/spo/web/web-list.md

@@ -21,4 +21,4 @@ Return all subsites from site _https://contoso.sharepoint.com/_
 
 ```sh
 m365 spo web list -u https://contoso.sharepoint.com
-```
+```

package/docs/docs/cmd/spo/web/web-reindex.md

@@ -25,4 +25,4 @@ Request reindexing the subsite _https://contoso.sharepoint.com/subsite_
 
 ```sh
 m365 spo web reindex --webUrl https://contoso.sharepoint.com/subsite
-```
+```

package/docs/docs/cmd/spo/web/web-remove.md

@@ -24,4 +24,4 @@ Delete subsite without prompting for confirmation
 
 ```sh
 m365 spo web remove --webUrl https://contoso.sharepoint.com/subsite --confirm
-```
+```

package/docs/docs/cmd/teams/app/app-publish.md

@@ -25,4 +25,4 @@ Add the _teams-manifest.zip_ file to the organization's app catalog
 
 ```sh
 m365 teams app publish --filePath ./teams-manifest.zip
-```
+```

package/docs/docs/cmd/teams/app/app-remove.md

@@ -34,4 +34,4 @@ Remove the Teams app with ID _83cece1e-938d-44a1-8b86-918cf6151957_ from the org
 
 ```sh
 m365 teams app remove --id 83cece1e-938d-44a1-8b86-918cf6151957 --confirm
-```
+```

package/docs/docs/cmd/teams/app/app-uninstall.md

@@ -32,4 +32,4 @@ Uninstall an app from a Microsoft Teams team
 
 ```sh
 m365 teams app uninstall --appId YzUyN2E0NzAtYTg4Mi00ODFjLTk4MWMtZWU2ZWZhYmE4NWM3IyM0ZDFlYTA0Ny1mMTk2LTQ1MGQtYjJlOS0wZDI4NTViYTA1YTY= --teamId 2609af39-7775-4f94-a3dc-0dd67657e900
-```
+```

package/docs/docs/cmd/teams/channel/channel-add.md

@@ -22,6 +22,12 @@ m365 teams channel add [options]
 `-d, --description [description]`
 : The description of the channel to add
 
+`--type [type]`
+: Type of channel to create: `standard,private`. Default `standard`.
+
+`--owner [owner]`
+: User with this ID or UPN will be added as owner of the private channel. This option is required when type is `private`.
+
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
@@ -41,3 +47,15 @@ Add channel to the specified Microsoft Teams team with name _Team Name_
 ```sh
 m365 teams channel add --teamName "Team Name" --name climicrosoft365 --description development
 ```
+
+Add private channel to the specified Microsoft Teams team with owner UPN
+
+```sh
+m365 teams channel add --teamName "Team Name" --name climicrosoft365 --type private --owner john.doe@contoso.com
+```
+
+Add private channel to the specified Microsoft Teams team with owner ID
+
+```sh
+m365 teams channel add --teamId 6703ac8a-c49b-4fd4-8223-28f0ac3a6402 --name climicrosoft365 --type private --owner cc693a7d-4833-4911-a89a-f0fe6e49bf69
+```

package/docs/docs/cmd/teams/channel/channel-list.md

@@ -16,18 +16,27 @@ m365 teams channel list [options]
 `--teamName [teamName]`
 : The display name of the team to list the channels of. Specify either `teamId` or `teamName` but not both
 
+`--type [type]`
+: Filter the results to only channels of a given type: `standard, private`. By default all channels are listed.
+
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
   
-List the channels in a specified Microsoft Teams team with id 00000000-0000-0000-0000-000000000000
+List all channels in a specified Microsoft Teams team with id 00000000-0000-0000-0000-000000000000
 
 ```sh
 m365 teams channel list --teamId 00000000-0000-0000-0000-000000000000
 ```
 
-List the channels in a specified Microsoft Teams team with name _Team Name_
+List all channels in a specified Microsoft Teams team with name _Team Name_
 
 ```sh
 m365 teams channel list --teamName "Team Name"
-```
+```
+
+List private channels in a specified Microsoft Teams team with id 00000000-0000-0000-0000-000000000000
+
+```sh
+m365 teams channel list --teamId 00000000-0000-0000-0000-000000000000 --type private
+```

package/docs/docs/cmd/teams/channel/channel-member-set.md

@@ -0,0 +1,51 @@
+# teams channel member set
+
+Updates the role of the specified member in the specified Microsoft Teams private team channel
+
+## Usage
+
+```sh
+m365 teams channel member set [options]
+```
+
+## Options
+
+`--teamId [teamId]`
+: The Id of the Microsoft Teams team. Specify either `teamId` or `teamName` but not both
+
+`--teamName [teamName]`
+: The display name of the Microsoft Teams team. Specify either `teamId` or `teamName` but not both
+
+`--channelId [channelId]`
+: The Id of the Microsoft Teams team channel. Specify either `channelId` or `channelName` but not both
+
+`--channelName [channelName]`
+: The display name of the Microsoft Teams team channel. Specify either `channelId` or `channelName` but not both
+
+`--userName [userName]`
+: User's UPN (user principal name, e.g. johndoe@example.com). Specify either userName, userId or id but not multiple.
+
+`--userId [userId]`
+: User's Azure AD Id. Specify either userName, userId or id but not multiple.
+
+`--id [id]`
+: Channel member Id of a user. Specify either userName, userId or id but not multiple.
+
+`-r, --role <role>`
+: The role to be assigned to the user: owner, member.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+  
+Updates the role of the user _johndoe@example.com_ to owner in the Microsoft Teams team with id 00000000-0000-0000-0000-000000000000 and channel id 00:00000000000000000000000000000000@thread.skype
+
+```sh
+m365 teams channel member set --teamId 00000000-0000-0000-0000-000000000000 --channelId 00:00000000000000000000000000000000@thread.skype --userName "johndoe@example.com" --role owner
+```
+
+Updates the role of the user with id 00000000-0000-0000-0000-000000000000 to member in the Microsoft Teams team with name _Team Name_ and channel with name _Channel Name_
+
+```sh
+m365 teams channel member set --teamName "Team Name" --channelName "Channel Name" --userId 00000000-0000-0000-0000-000000000000 --role member
+```

package/docs/docs/cmd/teams/channel/channel-membership-list.md

@@ -0,0 +1,48 @@
+# teams channel membership list
+
+Lists memberships in the specified Microsoft Teams team channel
+
+## Usage
+
+```sh
+m365 teams channel membership list [options]
+```
+
+## Options
+
+`--teamId [teamId]`
+: The Id of the Microsoft Teams team. Specify either `teamId` or `teamName` but not both
+
+`--teamName [teamName]`
+: The display name of the Microsoft Teams team. Specify either `teamId` or `teamName` but not both
+
+`--channelId [channelId]`
+: The Id of the Microsoft Teams team channel. Specify either `channelId` or `channelName` but not both
+
+`--channelName [channelName]`
+: The display name of the Microsoft Teams team channel. Specify either `channelId` or `channelName` but not both
+
+`-r, --role [role]`
+: Filter the results to only users with the given role: owner, member, guest
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+  
+List the memberships in a specified Microsoft Teams team with id 00000000-0000-0000-0000-000000000000 and channel id 00:00000000000000000000000000000000@thread.skype
+
+```sh
+m365 teams channel membership list --teamId 00000000-0000-0000-0000-000000000000 --channelId 00:00000000000000000000000000000000@thread.skype
+```
+
+List the memberships in a specified Microsoft Teams team with name _Team Name_ and channel with name _Channel Name_
+
+```sh
+m365 teams channel membership list --teamName "Team Name" --channelName "Channel Name"
+```
+
+List all owner memberships in the specified Microsoft Teams team with id 00000000-0000-0000-0000-000000000000 and channel id 00:00000000000000000000000000000000@thread.skype
+
+```sh
+m365 teams channel membership list --teamId 00000000-0000-0000-0000-000000000000 --channelId 00:00000000000000000000000000000000@thread.skype --role owner
+```

package/docs/docs/cmd/teams/channel/channel-set.md

@@ -36,4 +36,4 @@ Set new display name for the specified channel in the given Microsoft Teams team
 
 ```sh
 m365 teams channel set --teamId "00000000-0000-0000-0000-000000000000" --channelName Reviews --newChannelName Projects
-```
+```

package/docs/docs/cmd/teams/chat/chat-get.md

@@ -0,0 +1,53 @@
+# teams chat get
+
+Get a Microsoft Teams chat conversation by id, participants or chat name.
+
+## Usage
+
+```sh
+m365 teams chat get [options]
+```
+
+## Options
+
+`-i, --id [id]`
+: The ID of the chat conversation. Specify either `id`, `name` or `participants`, but not multiple.
+
+`-n, --name [name]`
+: The display name of the chat conversation. Specify either `id`, `name` or `participants`, but not multiple.
+
+`-p, --participants [participants]`
+: A comma-separated list of one or more e-mail addresses. Specify either `id`, `name` or `participants`, but not multiple.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+The output will not include the chat conversation members or messages. It will just retrieve the conversation details.
+When using the `participants` option, the signed-in user will automatically be included as a participant. There's no need to add it to the list manually.
+
+## Examples
+
+Get a Microsoft Teams chat conversation by id
+
+```sh
+m365 teams chat get --id 19:2da4c29f6d7041eca70b638b43d45437@thread.v2
+```
+
+Get a Microsoft Teams one on one chat conversation, finding it by participant.
+
+```sh
+m365 teams chat get --participants alexw@contoso.com
+```
+
+Get a Microsoft Teams group chat conversation, finding it by participants.
+
+```sh
+m365 teams chat get --participants alexw@contoso.com,meganb@contoso.com
+```
+
+Get a Microsoft Teams chat conversation, finding it by display name
+
+```sh
+m365 teams chat get --name "Just a conversation"
+```

package/docs/docs/cmd/teams/conversationmember/conversationmember-list.md

@@ -36,4 +36,4 @@ List all members of a channel based on their names
 
 ```sh
 m365 teams conversationmember list --teamName "Human Resources" --channelName "Private Channel"
-```
+```

package/docs/docs/cmd/teams/guestsettings/guestsettings-list.md

@@ -21,4 +21,4 @@ Get guest settings for a Microsoft Teams team
 
 ```sh
 m365 teams guestsettings list --teamId 2609af39-7775-4f94-a3dc-0dd67657e900
-```
+```

package/docs/docs/cmd/teams/guestsettings/guestsettings-set.md

@@ -33,4 +33,4 @@ Disallow guests to delete channels
 
 ```sh
 m365 teams guestsettings set --teamId '00000000-0000-0000-0000-000000000000' --allowDeleteChannels false
-```
+```

package/docs/docs/cmd/teams/membersettings/membersettings-list.md

@@ -21,4 +21,4 @@ Get member settings for a Microsoft Teams team
 
 ```sh
 m365 teams membersettings list --teamId 2609af39-7775-4f94-a3dc-0dd67657e900
-```
+```

package/docs/docs/cmd/teams/membersettings/membersettings-set.md

@@ -42,4 +42,4 @@ Disallow members to add and remove apps
 
 ```sh
 m365 teams membersettings set --teamId '00000000-0000-0000-0000-000000000000' --allowAddRemoveApps false
-```
+```

package/docs/docs/cmd/teams/message/message-get.md

@@ -31,4 +31,4 @@ Retrieve the specified message from a channel of the Microsoft Teams team
 
 ```sh
 m365 teams message get --teamId 5f5d7b71-1161-44d8-bcc1-3da710eb4171 --channelId 19:88f7e66a8dfe42be92db19505ae912a8@thread.skype --messageId 1540747442203
-```
+```

package/docs/docs/cmd/teams/message/message-reply-list.md

@@ -31,4 +31,4 @@ Retrieve the replies from a specified message from a channel of the Microsoft Te
 
 ```sh
 m365 teams message reply list --teamId 5f5d7b71-1161-44d8-bcc1-3da710eb4171 --channelId 19:88f7e66a8dfe42be92db19505ae912a8@thread.skype --messageId 1540747442203
-```
+```

package/docs/docs/cmd/teams/messagingsettings/messagingsettings-list.md

@@ -21,4 +21,4 @@ Get messaging settings for a Microsoft Teams team
 
 ```sh
 m365 teams messagingsettings list --teamId 2609af39-7775-4f94-a3dc-0dd67657e900
-```
+```

package/docs/docs/cmd/teams/messagingsettings/messagingsettings-set.md

@@ -42,4 +42,4 @@ Disallow users to delete messages in channels
 
 ```sh
 m365 teams messagingsettings set --teamId '00000000-0000-0000-0000-000000000000' --allowUserDeleteMessages false
-```
+```

package/docs/docs/cmd/teams/report/report-pstncalls.md

@@ -46,4 +46,4 @@ m365 teams report pstncalls --fromDateTime 2020-10-31 --toDateTime 2020-12-31 --
 
 ## More information
 
-- List PSTN calls: [https://docs.microsoft.com/en-us/graph/api/callrecords-callrecord-getpstncalls?view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/callrecords-callrecord-getpstncalls?view=graph-rest-1.0)
+- List PSTN calls: [https://docs.microsoft.com/en-us/graph/api/callrecords-callrecord-getpstncalls?view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/callrecords-callrecord-getpstncalls?view=graph-rest-1.0)

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

@@ -36,4 +36,4 @@ 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
-```
+```

package/docs/docs/cmd/teams/team/team-archive.md

@@ -36,4 +36,4 @@ Archive the specified Microsoft Teams team and set permissions for team members
 
 ```sh
 m365 teams team archive --teamId 6f6fd3f7-9ba5-4488-bbe6-a789004d0d55 --shouldSetSpoSiteReadOnlyForMembers
-```
+```

package/docs/docs/cmd/teams/team/team-clone.md

@@ -48,4 +48,4 @@ Creates a clone of a Microsoft Teams team with mandatory and optional parameters
 
 ```sh
 m365 teams team clone --teamId 15d7a78e-fd77-4599-97a5-dbb6372846c5 --displayName "Library Assist" --partsToClone "apps,tabs,settings,channels,members" --description "Self help community for library" --classification "Library" --visibility "public"
-```
+```

package/docs/docs/cmd/teams/team/team-get.md

@@ -30,4 +30,4 @@ Get information about Microsoft Teams team with name _Team Name_
 
 ```sh
 m365 teams team get --name "Team Name"
-```
+```

package/docs/docs/cmd/teams/team/team-list.md

@@ -31,4 +31,4 @@ List all Microsoft Teams in the tenant you are a member of
 
 ```sh
 m365 teams team list --joined
-```
+```

package/docs/docs/cmd/teams/team/team-remove.md

@@ -38,4 +38,4 @@ m365 teams team remove --teamId '00000000-0000-0000-0000-000000000000' --confirm
 
 ## More information
 
-- directory resource type (deleted items): [https://docs.microsoft.com/en-us/graph/api/resources/directory?view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/resources/directory?view=graph-rest-1.0)
+- directory resource type (deleted items): [https://docs.microsoft.com/en-us/graph/api/resources/directory?view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/resources/directory?view=graph-rest-1.0)

package/docs/docs/cmd/teams/team/team-set.md

@@ -42,4 +42,4 @@ Set Microsoft Teams team classification as MBI
 
 ```sh
 m365 teams team set --teamId '00000000-0000-0000-0000-000000000000' --classification MBI
-```
+```

package/docs/docs/cmd/teams/team/team-unarchive.md

@@ -27,4 +27,4 @@ Restore an archived Microsoft Teams team
 
 ```sh
 m365 teams team unarchive --teamId 6f6fd3f7-9ba5-4488-bbe6-a789004d0d55
-```
+```

package/docs/docs/cmd/todo/task/task-list.md

@@ -30,4 +30,4 @@ List tasks from Microsoft To Do tasks list with the id AQMkAGYzNjMxYTU4LTJjZjYtN
 
 ```sh
 m365 todo task list --listId "AQMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MAAuAAADMN-7V4K8g0q_adetip1DygEAxMBBaLl1lk_dAn8KkjfXKQABF-BAgwAAAA=="
-```
+```

package/docs/docs/cmd/todo/task/task-set.md

@@ -39,4 +39,4 @@ Update a task with status from _notStarted_ to _inProgress_ in Microsoft To Do t
 
 ```sh
 m365 todo task set --id "AAMkADU3Y2E0OTMxLTllYTQtNGFlZS1hZGM0LWI1NjZjY2FhM2RhMABGAAAAAADhr7P77n9xS6PdtDemRwpHBwCin1tvQMXzRKN1hQDz2S3VAAAXXsleAACin1tvQMXzRKN1hQDz2S3VAAAXXzr9AAA=" --status "inProgress" --listName "My task list"
-```
+```