Share via

az communication chat participant

  • Preview

Note

This reference is part of the communication extension for the Azure CLI (version 2.67.0 or higher). The extension will automatically install the first time you run an az communication chat participant command. Learn more about extensions.

Command group 'communication chat' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Commands to manage participants in a chat thread of a Communication Service resource.

Commands

Name Description Type Status
az communication chat participant add

Adds a participant to a chat thread.

 Extension Preview
az communication chat participant list

Gets the participants of a chat thread.

 Extension Preview
az communication chat participant remove

Removes a participant from a chat thread.

 Extension Preview

az communication chat participant add

Preview

Command group 'communication chat participant' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Adds a participant to a chat thread.

az communication chat participant add --thread
                                      --user
                                      [--access-token]
                                      [--display-name]
                                      [--endpoint]
                                      [--start-time]

Examples

Add participant

az communication chat participant add --thread "19:a-bcd=xyz" --user "8:acs:xxxxxx" --display-name "John Doe" --start-time "2022-07-14T10:21"

Required Parameters

--thread -t

Thread id.

--user

Chat participant identifier.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--access-token

Communication access token. Environment variable: AZURE_COMMUNICATION_ACCESS_TOKEN.

Property Value
Parameter group: Communication Arguments
--display-name

Chat participant display name.

--endpoint

Communication endpoint. Environment variable: AZURE_COMMUNICATION_ENDPOINT.

Property Value
Parameter group: Communication Arguments
--start-time

Start time to share history in ISO8601 format, ex: 2022-07-14T10:21.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property Value
Default value: False

az communication chat participant list

Preview

Command group 'communication chat participant' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Gets the participants of a chat thread.

az communication chat participant list --thread
                                       [--access-token]
                                       [--endpoint]
                                       [--skip]

Examples

List participants

az communication chat participant list --thread "19:a-bcd=xyz" --skip "4"

Required Parameters

--thread -t

Thread id.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--access-token

Communication access token. Environment variable: AZURE_COMMUNICATION_ACCESS_TOKEN.

Property Value
Parameter group: Communication Arguments
--endpoint

Communication endpoint. Environment variable: AZURE_COMMUNICATION_ENDPOINT.

Property Value
Parameter group: Communication Arguments
--skip

Number of participants to skip.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property Value
Default value: False

az communication chat participant remove

Preview

Command group 'communication chat participant' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Removes a participant from a chat thread.

az communication chat participant remove --thread
                                         --user
                                         [--access-token]
                                         [--endpoint]
                                         [--yes]

Examples

Remove participant

az communication chat participant remove --thread "19:a-bcd=xyz" --user "8:acs:xxxxxx"

Required Parameters

--thread -t

Thread id.

--user

Chat participant identifier.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--access-token

Communication access token. Environment variable: AZURE_COMMUNICATION_ACCESS_TOKEN.

Property Value
Parameter group: Communication Arguments
--endpoint

Communication endpoint. Environment variable: AZURE_COMMUNICATION_ENDPOINT.

Property Value
Parameter group: Communication Arguments
--yes -y

Do not prompt for confirmation.

Property Value
Default value: False
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property Value
Default value: False