@pnp/cli-microsoft365 5.5.0-beta.4e973d9 → 5.5.0-beta.9774606

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

@@ -0,0 +1,46 @@
+# teams cache remove
+
+Removes the Microsoft Teams client cache
+
+## Usage
+
+```sh
+m365 teams cache remove [options]
+```
+
+## Options
+
+`--confirm`
+: Don't prompt for confirmation
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+This command will execute the following steps.
+
+- Stop the Microsoft Teams client. This will kill all the running `Teams.exe` tasks.
+
+- Clear the Microsoft Teams cached files. For Windows it will delete all files and folders in the %appdata%\Microsoft\Teams directory. For macOS it will delete all files and folders in the  ~/Library/Application Support/Microsoft/Teams directory.
+
+!!! important
+    - You won't lose any user data by clearing the cache.
+    - Restarting Teams after you clear the cache might take longer than usual because the Teams cache files have to be rebuilt.
+
+If you run the command in the CLI Docker container, you will get the following error message:
+
+> Because you're running CLI for Microsoft 365 in a Docker container, we can't clear the cache on your host. Instead run this command on your host using 'npx ...'.
+
+The command works only on Windows and macOS. If you run it on a different operating system, you will get the `'abc' platform is unsupported for this command` error.
+
+## Examples
+
+Removes the Microsoft Teams client cache
+
+```sh
+m365 teams cache remove
+```
+
+## More information
+
+- [Clear the Teams client cache guidance](https://docs.microsoft.com/microsoftteams/troubleshoot/teams-administration/clear-teams-cache)

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

@@ -10,8 +10,14 @@ 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
+
+`--teamId [teamId]`
+: (deprecated. Use `id` instead) The ID of the Microsoft Teams team to archive
 
 `--shouldSetSpoSiteReadOnlyForMembers`
 : Sets the permissions for team members to read-only on the SharePoint Online site associated with the team
@@ -22,18 +28,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,17 @@ 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
+`--teamId [teamId]`
+: (deprecated. Use `id` instead) The ID of the Microsoft Teams team to clone
+
+`-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 +47,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,14 @@ 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
+
+`--teamId [teamId]`
+: (deprecated. Use `id` instead) The ID of the Teams team to remove
 
 `--confirm`
 : Don't prompt for confirming removing the specified team
@@ -22,18 +28,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,17 @@ m365 teams team set [options]
 
 ## Options
 
-`-i, --teamId <teamId>`
+`-i, --id [id]`
 : The ID of the Microsoft Teams team for which to update settings
 
+`--teamId [teamId]`
+: (deprecated. Use `id` instead) 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 +41,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,14 @@ 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
+
+`--teamId [teamId]`
+: (deprecated. Use `id` instead) The ID of the Microsoft Teams team to restore
 
 --8<-- "docs/cmd/_global.md"
 
@@ -19,12 +25,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/tenant/serviceannouncement/serviceannouncement-health-get.md

@@ -16,7 +16,7 @@ m365 tenant serviceannouncement health get [options]
 `-i, --issues`
 : Return the collection of issues that happened on the service, with detailed information for each issue. Is only returned in JSON output mode.
 
---8<-- "docs/cmd/\_global.md"
+--8<-- "docs/cmd/_global.md"
 
 ## Examples
 

package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-healthissue-list.md

@@ -13,7 +13,7 @@ m365 tenant serviceannouncement healthissue list [options]
 `-s, --service [service]`
 : Retrieve service health issues for the particular service. If not provided, retrieves health issues for all services
 
---8<-- "docs/cmd/\_global.md"
+--8<-- "docs/cmd/_global.md"
 
 ## Examples
 

package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-message-list.md

@@ -13,7 +13,7 @@ m365 tenant serviceannouncement message list [options]
 `-s, --service [service]`
 : Retrieve service update messages for the particular service. If not provided, retrieves messages for all services
 
---8<-- "docs/cmd/\_global.md"
+--8<-- "docs/cmd/_global.md"
 
 ## Examples