@pnp/cli-microsoft365 6.0.0-beta.c32757e → 6.0.0-beta.db5e64c

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

@@ -0,0 +1,54 @@
+# spo web roleassignment remove
+
+Removes a role assignment from web permissions.
+
+## Usage
+
+```sh
+m365 spo web roleassignment remove [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site
+
+`--principalId [principalId]`
+: SharePoint ID of principal it may be either user id or group id we want to add permissions to. Specify principalId only when upn or groupName are not used.
+
+`--upn [upn]`
+: Upn/email of user to assign role to. Specify upn only when principalId or groupName are not used.
+
+`--groupName [groupName]`
+: Enter group name of Azure AD or SharePoint group. Specify groupName only when principalId or upn are not used.
+
+`--confirm [confirm]`
+: Don't prompt for confirming removing the roleassignment.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Remove roleassignment from web based on group name
+
+```sh
+m365 spo list roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales"  --groupName "saleGroup"
+```
+
+Remove roleassignment from web based on principal Id
+
+```sh
+m365 spo list roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales"  --principalId 2
+```
+
+Remove roleassignment from web based on upn
+
+```sh
+m365 spo list roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales"  --upn "someaccount@tenant.onmicrosoft.com"
+```
+
+Remove roleassignment from web based on principal Id without prompting for confirmation
+
+```sh
+m365 spo list roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales"  --principalId 2 --confirm
+```

package/docs/docs/cmd/spo/web/web-roleinheritance-reset.md

@@ -0,0 +1,24 @@
+# spo web roleinheritance reset
+
+Restores role inheritance of subsite.
+
+## Usage
+
+```sh
+m365 spo web roleinheritance reset [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Restore role inheritance of subsite _https://contoso.sharepoint.com/sites/project-x_
+
+```sh
+m365 spo web roleinheritance reset --webUrl https://contoso.sharepoint.com/sites/project-x
+```

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

@@ -10,7 +10,7 @@ m365 spo web set [options]
 
 ## Options
 
-`-u, --webUrl <webUrl>`
+`-u, --url <url>`
 : URL of the subsite to update
 
 `-t, --title [title]`
@@ -54,49 +54,49 @@ Next to updating web properties corresponding to the options of this command, yo
 Update subsite title
 
 ```sh
-m365 spo web set --webUrl https://contoso.sharepoint.com/sites/team-a --title Team-a
+m365 spo web set --url https://contoso.sharepoint.com/sites/team-a --title Team-a
 ```
 
 Hide quick launch on the subsite
 
 ```sh
-m365 spo web set --webUrl https://contoso.sharepoint.com/sites/team-a --quickLaunchEnabled false
+m365 spo web set --url https://contoso.sharepoint.com/sites/team-a --quickLaunchEnabled false
 ```
 
 Set site header layout to compact
 
 ```sh
-m365 spo web set --webUrl https://contoso.sharepoint.com/sites/team-a --headerLayout compact
+m365 spo web set --url https://contoso.sharepoint.com/sites/team-a --headerLayout compact
 ```
 
 Set site header color to primary theme background color
 
 ```sh
-m365 spo web set --webUrl https://contoso.sharepoint.com/sites/team-a --headerEmphasis 0
+m365 spo web set --url https://contoso.sharepoint.com/sites/team-a --headerEmphasis 0
 ```
 
 Enable megamenu in the site
 
 ```sh
-m365 spo web set --webUrl https://contoso.sharepoint.com/sites/team-a --megaMenuEnabled true
+m365 spo web set --url https://contoso.sharepoint.com/sites/team-a --megaMenuEnabled true
 ```
 
 Hide footer in the site
 
 ```sh
-m365 spo web set --webUrl https://contoso.sharepoint.com/sites/team-a --footerEnabled false
+m365 spo web set --url https://contoso.sharepoint.com/sites/team-a --footerEnabled false
 ```
 
 Set search scope to tenant scope
 
 ```sh
-m365 spo web set --webUrl https://contoso.sharepoint.com/sites/team-a --searchScope tenant
+m365 spo web set --url https://contoso.sharepoint.com/sites/team-a --searchScope tenant
 ```
 
 Set welcome page for the web
 
 ```sh
-m365 spo web set  --webUrl https://contoso.sharepoint.com/sites/team-a --welcomePage "SitePages/new-home.aspx"
+m365 spo web set  --url https://contoso.sharepoint.com/sites/team-a --welcomePage "SitePages/new-home.aspx"
 ```
 
 ## More information

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

@@ -10,7 +10,7 @@ m365 teams app install [options]
 
 ## Options
 
-`--appId <appId>`
+`--id <id>`
 : The ID of the app to install
 
 `--teamId [teamId]`
@@ -26,24 +26,24 @@ m365 teams app install [options]
 
 ## Remarks
 
-The `appId` has to be the ID of the app from the Microsoft Teams App Catalog. Do not use the ID from the manifest of the zip app package. Use the [teams app list](./app-list.md) command to get this ID instead.
+The `id` has to be the ID of the app from the Microsoft Teams App Catalog. Do not use the ID from the manifest of the zip app package. Use the [teams app list](./app-list.md) command to get this ID instead.
 
 ## Examples
 
 Install an app from the catalog in a Microsoft Teams team
 
 ```sh
-m365 teams app install --appId 4440558e-8c73-4597-abc7-3644a64c4bce --teamId 2609af39-7775-4f94-a3dc-0dd67657e900
+m365 teams app install --id 4440558e-8c73-4597-abc7-3644a64c4bce --teamId 2609af39-7775-4f94-a3dc-0dd67657e900
 ```
 
 Install a personal app for the user specified using their user name
 
 ```sh
-m365 teams app install --appId 4440558e-8c73-4597-abc7-3644a64c4bce --userName steve@contoso.com
+m365 teams app install --id 4440558e-8c73-4597-abc7-3644a64c4bce --userName steve@contoso.com
 ```
 
 Install a personal app for the user specified using their ID
 
 ```sh
-m365 teams app install --appId 4440558e-8c73-4597-abc7-3644a64c4bce --userId 2609af39-7775-4f94-a3dc-0dd67657e900
+m365 teams app install --id 4440558e-8c73-4597-abc7-3644a64c4bce --userId 2609af39-7775-4f94-a3dc-0dd67657e900
 ```

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

@@ -10,7 +10,7 @@ m365 teams app uninstall [options]
 
 ## Options
 
-`--appId <appId>`
+`--id <id>`
 : The unique id of the app instance installed in the Microsoft Teams team
 
 `--teamId <teamId>`
@@ -23,7 +23,7 @@ m365 teams app uninstall [options]
 
 ## Remarks
 
-The `appId` has to be the id the app instance installed in the Microsoft Teams team.
+The `id` has to be the id the app instance installed in the Microsoft Teams team.
 Do not use the ID from the manifest of the zip app package or the id from the Microsoft Teams App Catalog.
 
 ## Examples
@@ -31,5 +31,5 @@ Do not use the ID from the manifest of the zip app package or the id from the Mi
 Uninstall an app from a Microsoft Teams team
 
 ```sh
-m365 teams app uninstall --appId YzUyN2E0NzAtYTg4Mi00ODFjLTk4MWMtZWU2ZWZhYmE4NWM3IyM0ZDFlYTA0Ny1mMTk2LTQ1MGQtYjJlOS0wZDI4NTViYTA1YTY= --teamId 2609af39-7775-4f94-a3dc-0dd67657e900
+m365 teams app uninstall --id YzUyN2E0NzAtYTg4Mi00ODFjLTk4MWMtZWU2ZWZhYmE4NWM3IyM0ZDFlYTA0Ny1mMTk2LTQ1MGQtYjJlOS0wZDI4NTViYTA1YTY= --teamId 2609af39-7775-4f94-a3dc-0dd67657e900
 ```

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

@@ -16,14 +16,14 @@ m365 teams channel get [options]
 `--teamName [teamName]`
 : The display name of the team to which the channel belongs to. Specify either teamId or teamName but not both
 
-`-c, --channelId [channelId]`
-: The ID of the channel for which to retrieve more information. Specify either channelId or channelName but not both
+`-c, --id [id]`
+: The ID of the channel for which to retrieve more information. Specify either id or name but not both
 
-`--channelName [channelName]`
-: The display name of the channel for which to retrieve more information. Specify either channelId or channelName but not both
+`--name [name]`
+: The display name of the channel for which to retrieve more information. Specify either id or name but not both
 
 `--primary`
-: Gets the default channel, General, of a team. If specified, channelId or channelName are not needed
+: Gets the default channel, General, of a team. If specified, id or name are not needed
 
 --8<-- "docs/cmd/_global.md"
 
@@ -32,13 +32,13 @@ m365 teams channel get [options]
 Get information about Microsoft Teams team channel with id _19:493665404ebd4a18adb8a980a31b4986@thread.skype_
 
 ```sh
-m365 teams channel get --teamId 00000000-0000-0000-0000-000000000000 --channelId '19:493665404ebd4a18adb8a980a31b4986@thread.skype'
+m365 teams channel get --teamId 00000000-0000-0000-0000-000000000000 --id '19:493665404ebd4a18adb8a980a31b4986@thread.skype'
 ```
 
 Get information about Microsoft Teams team channel with name _Channel Name_
 
 ```sh
-m365 teams channel get --teamName "Team Name" --channelName "Channel Name"
+m365 teams channel get --teamName "Team Name" --name "Channel Name"
 ```
 
 Get information about Microsoft Teams team primary channel , i.e. General

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

@@ -10,11 +10,11 @@ m365 teams channel remove [options]
 
 ## Options
 
-`-c, --channelId [channelId]`
+`-c, --id [id]`
 : The ID of the channel to remove
 
-`-n, --channelName [channelName]`
-: The name of the channel to remove. Specify channelId or channelName but not both
+`-n, --name [name]`
+: The name of the channel to remove. Specify id or name but not both
 
 `-i, --teamId <teamId>`
 : The ID of the team to which the channel to remove belongs
@@ -33,25 +33,25 @@ When deleted, Microsoft Teams channels are moved to a recycle bin and can be res
 Remove the specified Microsoft Teams channel by Id
 
 ```sh
-m365 teams channel remove --channelId 19:f3dcbb1674574677abcae89cb626f1e6@thread.skype --teamId d66b8110-fcad-49e8-8159-0d488ddb7656
+m365 teams channel remove --id 19:f3dcbb1674574677abcae89cb626f1e6@thread.skype --teamId d66b8110-fcad-49e8-8159-0d488ddb7656
 ```
 
 Remove the specified Microsoft Teams channel by Id without confirmation
 
 ```sh
-m365 teams channel remove --channelId 19:f3dcbb1674574677abcae89cb626f1e6@thread.skype --teamId d66b8110-fcad-49e8-8159-0d488ddb7656 --confirm
+m365 teams channel remove --id 19:f3dcbb1674574677abcae89cb626f1e6@thread.skype --teamId d66b8110-fcad-49e8-8159-0d488ddb7656 --confirm
 ```
 
 Remove the specified Microsoft Teams channel by Name
 
 ```sh
-m365 teams channel remove --channelName 'channelName' --teamId d66b8110-fcad-49e8-8159-0d488ddb7656
+m365 teams channel remove --name 'name' --teamId d66b8110-fcad-49e8-8159-0d488ddb7656
 ```
 
 Remove the specified Microsoft Teams channel by Name without confirmation
 
 ```sh
-m365 teams channel remove --channelName 'channelName' --teamId d66b8110-fcad-49e8-8159-0d488ddb7656 --confirm 
+m365 teams channel remove --name 'name' --teamId d66b8110-fcad-49e8-8159-0d488ddb7656 --confirm 
 ```
 
 ## More information

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

@@ -13,10 +13,10 @@ m365 teams channel set [options]
 `-i, --teamId <teamId>`
 : The ID of the team where the channel to update is located
 
-`--channelName <channelName>`
+`--name <name>`
 : The name of the channel to update
 
-`--newChannelName [newChannelName]`
+`--newName [newName]`
 : The new name of the channel
 
 `--description [description]`
@@ -29,11 +29,11 @@ m365 teams channel set [options]
 Set new description and 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 --description "Channel for new projects"
+m365 teams channel set --teamId "00000000-0000-0000-0000-000000000000" --name Reviews --newName Projects --description "Channel for new projects"
 ```
 
 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
+m365 teams channel set --teamId "00000000-0000-0000-0000-000000000000" --name Reviews --newName Projects
 ```

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

@@ -10,13 +10,13 @@ m365 teams message get [options]
 
 ## Options
 
-`-i, --teamId <teamId>`
+`-t, --teamId <teamId>`
 : The ID of the team where the channel is located
 
 `-c, --channelId <channelId>`
 : The ID of the channel that contains the message
 
-`-m, --messageId <messageId>`
+`-i, --id <id>`
 : The ID of the message to retrieve
 
 --8<-- "docs/cmd/_global.md"
@@ -30,5 +30,5 @@ You can only retrieve a message from a Microsoft Teams team if you are a member
 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
+m365 teams message get --teamId 5f5d7b71-1161-44d8-bcc1-3da710eb4171 --channelId 19:88f7e66a8dfe42be92db19505ae912a8@thread.skype --id 1540747442203
 ```

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

@@ -22,11 +22,11 @@ m365 teams tab get [options]
 `--channelName [channelName]`
 : The display name of the Microsoft Teams channel where the tab is located. Specify either channelId or channelName but not both
 
-`--tabId [tabId]`
-: The ID of the Microsoft Teams tab. Specify either tabId or tabName but not both
+`-i, --id [id]`
+: The ID of the Microsoft Teams tab. Specify either `id` or `name` but not both
 
-`--tabName [tabName]`
-: The display name of the Microsoft Teams tab. Specify either tabId or tabName but not both
+`-n, --name [name]`
+: The display name of the Microsoft Teams tab. Specify either `id` or `name` but not both
 
 --8<-- "docs/cmd/_global.md"
 
@@ -39,11 +39,11 @@ You can only retrieve tabs for teams of which you are a member.
 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 --tabId 1432c9da-8b9c-4602-9248-e0800f3e3f07
+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" --tabName "Tab Name"
+m365 teams tab get --teamName "Team Name" --channelName "Channel Name" --name "Tab Name"
 ```

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

@@ -10,13 +10,13 @@ m365 teams tab remove [options]
 
 ## Options
 
-`-i, --teamId <teamId>`
+`-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
 
-`-t, --tabId <tabId>`
+`-i, --id <id>`
 : The ID of the tab to remove
 
 `--confirm`
@@ -29,13 +29,13 @@ m365 teams tab remove [options]
 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 --tabId 06805b9e-77e3-4b93-ac81-525eb87513b8
+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 --tabId 06805b9e-77e3-4b93-ac81-525eb87513b8 --confirm
+m365 teams tab remove --teamId 00000000-0000-0000-0000-000000000000 --channelId 19:00000000000000000000000000000000@thread.skype --id 06805b9e-77e3-4b93-ac81-525eb87513b8 --confirm
 ```
 
 ## Additional information

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

@@ -10,8 +10,11 @@ m365 teams team archive [options]
 
 ## Options
 
-`-i, --teamId <teamId>`
-: The ID of the Microsoft Teams team to archive
+`-i, --id [id]`
+: The ID of the Microsoft Teams team to archive. Specify either id or name but not both
+
+`-n, --name [name]`
+: The display name of the Microsoft Teams team to archive. Specify either id or name but not both
 
 `--shouldSetSpoSiteReadOnlyForMembers`
 : Sets the permissions for team members to read-only on the SharePoint Online site associated with the team
@@ -22,18 +25,27 @@ m365 teams team archive [options]
 
 Using this command, global admins and Microsoft Teams service admins can access teams that they are not a member of.
 
+If the command finds multiple Microsoft Teams teams with the specified name, it will prompt you to disambiguate which team it should use, listing the discovered team IDs.
+
 When a team is archived, users can no longer send or like messages on any channel in the team, edit the team's name, description, or other settings, or in general make most changes to the team. Membership changes to the team continue to be allowed.
 
+
 ## Examples
 
-Archive the specified Microsoft Teams team
+Archive the specified Microsoft Teams team with id _6f6fd3f7-9ba5-4488-bbe6-a789004d0d55_
+
+```sh
+m365 teams team archive --id 6f6fd3f7-9ba5-4488-bbe6-a789004d0d55
+```
+
+Archive the specified Microsoft Teams team with name _Team Name_
 
 ```sh
-m365 teams team archive --teamId 6f6fd3f7-9ba5-4488-bbe6-a789004d0d55
+m365 teams team archive --name "Team Name"
 ```
 
 Archive the specified Microsoft Teams team and set permissions for team members to read-only on the SharePoint Online site associated with the team
 
 ```sh
-m365 teams team archive --teamId 6f6fd3f7-9ba5-4488-bbe6-a789004d0d55 --shouldSetSpoSiteReadOnlyForMembers
+m365 teams team archive --id 6f6fd3f7-9ba5-4488-bbe6-a789004d0d55 --shouldSetSpoSiteReadOnlyForMembers
 ```

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

@@ -10,11 +10,14 @@ m365 teams team clone [options]
 
 ## Options
 
-`-i, --teamId <teamId>`
+`-i, --id [id]`
 : The ID of the Microsoft Teams team to clone
 
-`-n, --displayName <displayName>`
-: The display name for the new Microsoft Teams Team
+`-n, --name [name]`
+: The display name for the new Microsoft Teams Team to clone
+
+`--displayName [displayName]`
+: (deprecated. Use `name` instead) The display name for the new Microsoft Teams Team to clone
 
 `-p, --partsToClone <partsToClone>`
 : A comma-separated list of the parts to clone. Allowed values are `apps,channels,members,settings,tabs`
@@ -41,11 +44,11 @@ When tabs are cloned, they are put into an unconfigured state. The first time yo
 Creates a clone of a Microsoft Teams team with mandatory parameters
 
 ```sh
-m365 teams team clone --teamId 15d7a78e-fd77-4599-97a5-dbb6372846c5 --displayName "Library Assist" --partsToClone "apps,tabs,settings,channels,members"
+m365 teams team clone --id 15d7a78e-fd77-4599-97a5-dbb6372846c5 --name "Library Assist" --partsToClone "apps,tabs,settings,channels,members"
 ```
 
 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"
+m365 teams team clone --id 15d7a78e-fd77-4599-97a5-dbb6372846c5 --name "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-remove.md

@@ -10,8 +10,11 @@ m365 teams team remove [options]
 
 ## Options
 
-`-i, --teamId <teamId>`
-: The ID of the Teams team to remove
+`-i, --id [id]`
+: The ID of the Microsoft Teams team to remove. Specify either id or name but not both
+
+`-n, --name [name]`
+: The display name of the Microsoft Teams team to remove. Specify either id or name but not both
 
 `--confirm`
 : Don't prompt for confirming removing the specified team
@@ -22,18 +25,26 @@ m365 teams team remove [options]
 
 When deleted, Microsoft 365 groups are moved to a temporary container and can be restored within 30 days. After that time, they are permanently deleted. This applies only to Microsoft 365 groups.
 
+If the command finds multiple Microsoft Teams teams with the specified name, it will prompt you to disambiguate which team it should use, listing the discovered team IDs.
+
 ## Examples
 
-Removes the specified team
+Removes the specified Microsoft Teams team with id _00000000-0000-0000-0000-000000000000_
+
+```sh
+m365 teams team remove --id 00000000-0000-0000-0000-000000000000
+```
+
+Removes the specified Microsoft Teams team with name _Team Name_
 
 ```sh
-m365 teams team remove --teamId '00000000-0000-0000-0000-000000000000'
+m365 teams team remove --name "Team Name"
 ```
 
 Removes the specified team without confirmation
 
 ```sh
-m365 teams team remove --teamId '00000000-0000-0000-0000-000000000000' --confirm
+m365 teams team remove --id 00000000-0000-0000-0000-000000000000 --confirm
 ```
 
 ## More information

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

@@ -10,11 +10,14 @@ m365 teams team set [options]
 
 ## Options
 
-`-i, --teamId <teamId>`
+`-i, --id [id]`
 : The ID of the Microsoft Teams team for which to update settings
 
+`-n, --name [name]`
+: The display name for the Microsoft Teams team for which to update settings
+
 `--displayName [displayName]`
-: The display name for the Microsoft Teams team
+: (deprecated. Use `name` instead) The display name for the Microsoft Teams team for which to update settings
 
 `--description [description]`
 : The description for the Microsoft Teams team
@@ -35,11 +38,11 @@ m365 teams team set [options]
 Set Microsoft Teams team visibility as Private
 
 ```sh
-m365 teams team set --teamId '00000000-0000-0000-0000-000000000000' --visibility Private
+m365 teams team set --id "00000000-0000-0000-0000-000000000000" --visibility Private
 ```
 
 Set Microsoft Teams team classification as MBI
 
 ```sh
-m365 teams team set --teamId '00000000-0000-0000-0000-000000000000' --classification MBI
+m365 teams team set --id "00000000-0000-0000-0000-000000000000" --classification MBI
 ```

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

@@ -10,8 +10,11 @@ m365 teams team unarchive [options]
 
 ## Options
 
-`-i, --teamId <teamId>`
-: The ID of the Microsoft Teams team to restore
+`-i, --id [id]`
+: The ID of the Microsoft Teams team to restore. Specify either id or name but not both
+
+`-n, --name [name]`
+: The display name of the Microsoft Teams team to restore. Specify either id or name but not both
 
 --8<-- "docs/cmd/_global.md"
 
@@ -19,12 +22,20 @@ m365 teams team unarchive [options]
 
 This command supports admin permissions. Global admins and Microsoft Teams service admins can restore teams that they are not a member of.
 
+If the command finds multiple Microsoft Teams teams with the specified name, it will prompt you to disambiguate which team it should use, listing the discovered team IDs.
+
 This command restores users' ability to send messages and edit the team, abiding by tenant and team settings.
 
 ## Examples
 
-Restore an archived Microsoft Teams team
+Restore an archived Microsoft Teams team with id _6f6fd3f7-9ba5-4488-bbe6-a789004d0d55_
+
+```sh
+m365 teams team unarchive --id 6f6fd3f7-9ba5-4488-bbe6-a789004d0d55
+```
+
+Restore an archived Microsoft Teams team with name _Team Name_
 
 ```sh
-m365 teams team unarchive --teamId 6f6fd3f7-9ba5-4488-bbe6-a789004d0d55
+m365 teams team unarchive --name "Team Name"
 ```

package/docs/docs/cmd/teams/user/user-app-add.md

@@ -10,7 +10,7 @@ m365 teams user app add [options]
 
 ## Options
 
-`--appId <appId>`
+`--id <id>`
 : The ID of the app to install
 
 `--userId <userId>`
@@ -20,12 +20,12 @@ m365 teams user app add [options]
 
 ## Remarks
 
-The `appId` has to be the ID of the app from the Microsoft Teams App Catalog. Do not use the ID from the manifest of the zip app package. Use the [teams app list](../app/app-list.md) command to get this ID.
+The `id` has to be the ID of the app from the Microsoft Teams App Catalog. Do not use the ID from the manifest of the zip app package. Use the [teams app list](../app/app-list.md) command to get this ID.
 
 ## Examples
 
 Install an app from the catalog for the specified user
 
 ```sh
-m365 teams user app add --appId 4440558e-8c73-4597-abc7-3644a64c4bce --userId 2609af39-7775-4f94-a3dc-0dd67657e900
+m365 teams user app add --id 4440558e-8c73-4597-abc7-3644a64c4bce --userId 2609af39-7775-4f94-a3dc-0dd67657e900
 ```

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

@@ -10,7 +10,7 @@ m365 teams user app remove [options]
 
 ## Options
 
-`--appId <appId>`
+`--id <id>`
 : The unique id of the app instance installed for the user
 
 `--userId <userId>`
@@ -23,7 +23,7 @@ m365 teams user app remove [options]
 
 ## Remarks
 
-The `appId` has to be the id of the app instance installed for the user.
+The `id` has to be the id of the app instance installed for the user.
 Do not use the ID from the manifest of the zip app package or the id from the Microsoft Teams App Catalog.
 
 ## Examples
@@ -31,5 +31,5 @@ Do not use the ID from the manifest of the zip app package or the id from the Mi
 Uninstall an app for the specified user
 
 ```sh
-m365 teams user app remove --appId YzUyN2E0NzAtYTg4Mi00ODFjLTk4MWMtZWU2ZWZhYmE4NWM3IyM0ZDFlYTA0Ny1mMTk2LTQ1MGQtYjJlOS0wZDI4NTViYTA1YTY= --userId 2609af39-7775-4f94-a3dc-0dd67657e900
+m365 teams user app remove --id YzUyN2E0NzAtYTg4Mi00ODFjLTk4MWMtZWU2ZWZhYmE4NWM3IyM0ZDFlYTA0Ny1mMTk2LTQ1MGQtYjJlOS0wZDI4NTViYTA1YTY= --userId 2609af39-7775-4f94-a3dc-0dd67657e900
 ```