Merge pull request #243881 from mikehang-msft/patch-2

Update rooms Azure CLI QuickStart

Author: American-Dipper

articles/communication-services/quickstarts/rooms/includes/rooms-quickstart-az-cli.md

@@ -2,14 +2,14 @@
 title: include file
 description: include file
 services: azure-communication-services
-author: JoannaJiang
-manager: ankita
+author: mikehang-msft
+manager: alexokun
 ms.service: azure-communication-services
 ms.subservice: azure-communication-services
-ms.date: 12/01/2022
+ms.date: 07/01/2023
 ms.topic: include
 ms.custom: include file, devx-track-azurecli
-ms.author: JoannaJiang
+ms.author: mikehang-msft
 ---
 
 ## Prerequisites
@@ -73,24 +73,19 @@ After you add the environment variable, run `source ~/.bash_profile` from your c
 Use the `rooms create` command to create a room. 
 
 ```azurecli-interactive
-az communication rooms create --presenter-participants "<participantId>" --consumer-participants "<participantId>" --attendee-participant "<participantId>" --validFrom "<validFrom>" --validUntil "<validUntil>" --connection-string "<connectionString>"
+az communication rooms create --presenter-participants "<participantId>" --consumer-participants "<participantId>" --attendee-participant "<participantId>" --valid-from "<valid-from>" --valid-until "<valid-until>" --connection-string "<connection-string>"
 ```
 
-- Use `<participantId>` optionally to specify the type of participant as presenter-participants, consumer-participants, or attendee-participants. If you don't specify a value, the default is empty. 
-- Replace `<connectionString>` with your ACS connection string. 
-- Use `<joinPolicy>` optionally to specify the join policy type as either `InviteOnly` or `CommunicationServiceUsers`. If you don't specify a value, the default is `InviteOnly`.   
-- Use `<validFrom>` optionally to specify the timestamp when the room is open for joining, in ISO8601 format, ex: 2022-07-14T10:21. 
-- Use `<validUntil>` optionally to specify the timestamp when the room can no longer be joined, in ISO8601 format, ex: 2022-07-14T10:21. 
+- Use `<participantId>` optionally to specify the type of participant as presenter-participants, consumer-participants, or attendee-participants. If you do not specify a value, the default is empty. 
+- Replace `<connection-string>` with your ACS connection string. 
+- Use `<valid-from>` optionally to specify the timestamp when the room is open for joining, in ISO8601 format, ex: 2022-07-14T10:21. 
+- Use `<valid-until>` optionally to specify the timestamp when the room can no longer be joined, in ISO8601 format, ex: 2022-07-14T10:21. 
 
 If you've stored the connection string in environment variables as stated above, you won't need to pass them to the command.
 
 ```azurecli-interactive
 az communication rooms create 
 ```
-
-- Replace `<connectionString>` with your ACS connection string.
-
-
 ### Get the rooms 
 
 The `rooms get` command returns the attributes of an existing room.
@@ -99,72 +94,72 @@ The `rooms get` command returns the attributes of an existing room.
 az communication rooms get --room "<roomId>" 
 ```
 
-- Use `<roomId>` mandatorily to specify the room
-
+- Replace `<roomId>` with your room ID.
 
-### Update the participant of a room
+### Update the timeframe of a room 
 
-When you create a room, you can update the room by adding and removing participant from it. Before calling the `room update` command, ensure that you've acquired a new user. 
-Use the `identity user create` command to create a new participant, identified by `participantId`.
+You can update the timestamp of a room. Before calling the `room update` command, ensure that you've acquired a new room with a valid timeframe. 
 
 ```azurecli-interactive
-az communication identity user create
+az communication rooms update --valid-from "<valid-from>" --valid-until "<valid-until>" --room "<roomId>"
 ```
 
-Add a user as a participant to the room 
+- Replace `<valid-from>` with the timestamp in ISO8601 format, ex: 2022-07-14T10:21, to specify when the room is open for joining. Should be used together with `--valid-until`.
+- Replace `<valid-until>` with the timestamp in ISO8601 format, ex: 2022-07-14T10:21, to specify when the room can no longer be joined. Should be used together with `--valid-from`.
+- Replace `<roomId>` with your room ID.
+  
+### List all active rooms
+
+The `rooms list` command returns all active rooms belonging to your ACS resource.
 
 ```azurecli-interactive
-az communication rooms update --attendee-participant "<participantId>" --room "<roomId>"
+az communication rooms list
 ```
 
-- Replace `<participantId>` with your participant ID. 
-- Replace `<roomId>` with your room ID.
+### Add new participants or update existing participants
 
+When you create a room, you can update the room by adding new participant or updating an existing participant in it. Before calling the `room participant add-or-update` command, ensure that you've acquired a new user. 
 
-### Update the timeframe of a room 
-
-You can update the timestamp of a room. Before calling the `room update` command, ensure that you've acquired a new room with a valid timeframe. 
+Use the `identity user create` command to create a new participant, identified by `participantId`.
 
 ```azurecli-interactive
-az communication rooms update --validFrom "<validFrom>" --validUntil "<validUntil>" --room "<roomId>"
+az communication identity user create
 ```
 
-- Replace `<validFrom>` with the timestamp in ISO8601 format, ex: 2022-07-14T10:21, to specify when the room is open for joining. Should be used together with `--valid-until`.
-- Replace `<validUntil>` with the timestamp in ISO8601 format, ex: 2022-07-14T10:21, to specify when the room can no longer be joined. Should be used together with `--valid-from`.
-- Replace `<roomId>` with your room ID. 
-
-
-### Update the join policy of a room 
-
-You can update the join policy of a room. Before calling the `room update` command, ensure that you've acquired a new room. 
+Add a user as a participant to the room 
 
 ```azurecli-interactive
-az communication rooms update --join-policy "<joinPolicy>" --room "<roomId>"
+az communication rooms participant add-or-update --attendee-participant "<participantId>" --room "<roomId>"
 ```
 
+- Replace `<participantId>` with your participant ID. If the <participantId> does not exist in the room, the participant will be added to the room as an attendee role. Otherwise, the participant's role is updated to an attendee role.
 - Replace `<roomId>` with your room ID.
-- Use `<joinPolicy>` optionally to specify the type of join policy as either InviteOnly or CommunicationServiceUsers. 
-
 
-### Delete a room 
-
-Similar to creating a room, you can also delete a room. 
+### Get list of participants in a room
+```azurecli-interactive
+az communication rooms participant get --room "<roomId>"
+```
+- Replace `<roomId>` with your room ID.
+  
+### Remove a participant from a room 
 
-Use `room delete` command to delete the existing room. 
+You can remove a room participant from a room by using `rooms participant -remove`.
 
 ```azurecli-interactive
-az communication rooms delete --room "<roomId>"
+az communication rooms participant remove --room "<roomId>" --participants "<participant1>" "<participant2>" "<participant3>"
 ```
 
 - Replace `<roomId>` with your room ID.
+- Replace `<participant1>`, `<participant2>`, `<participant3>` with your user IDs obtained earlier with running `identity user create`command.
 
+### Delete a room 
 
-### Remove a participant from a room 
+Similar to creating a room, you can also delete a room. 
 
-You can remove a room participant from a room by using `identity user delete`
+Use `room delete` command to delete the existing room.
 
 ```azurecli-interactive
-az communication identity user delete --user "<userId>"
+az communication rooms delete --room "<roomId>"
 ```
 
-- Replace `<userId>` with your user ID obtained earlier with running `identity user create`command.
+- Replace `<roomId>` with your room ID.