Common Flags

All commands accept a predefined list os flags. Of course flags related with output format are only applicable to commands that output some result.

Flag

 

Flag

 

--json

Return the result in JSON format

--yaml

Return the result in YAML format

--csv

Returns the result in CSV format

--table

Return the result in tabular format (default)

--columns

Only applicable to tablular format. Comma separated list of columns that should be returned. Useful if number of default columns is high and columns are truncated. If a column name contains space, specify the column between ““ characters.

Example: --columns=Id,Key,Summary

--sort

Only applicable to tablular format. Sort the result table using the value of specified columns. Separate multiple columns with “,”. If a column name contains space, specify the column between ““ characters.

Example: --sort=”Display Name”

This filtering is done after the results are returned. If you use this flag together with --startAt, --maxResults flags, result may be different than you expect. Example:

user get-all --sort=”Display Name” --maxResults=10

Above command will not fetch first 10 users whose “Display Name” comes before the other users alphabetically. It will fetch first 10 users and sort the resulting users alphabetically.

--filter

Only applicable to tablular format. Filter the results by partial string matching.

Example: --filter="Display Name=Deniz"

This filtering is done after the results are returned. If you use this flag for a command that accepts --startAt, --maxResults flags, result may be different than you expect. The command is first executed with --startAt, and --maxResults flag and only the returned results are filtered. Example:

user get-all --filter="Display Name=Deniz" --maxResults=10

This command first retrieves 10 users from he server and only shows the ones that contains the string “Deniz”. It doesn’t fetch first 10 users that has the string “Deniz”.

 

--no-truncate

Only applicable to tablular format. Don’t truncate the output to fit the screen.

--no-header

Only applicable to tablular format. Hide table header from the output.

--extended

Only applicable to tablular format. Some columns from the results are hidden by defaults to save screen space. To include these columns use --extended flag.

--startAt

The index of the first item to return in a page of results (page offset)

--maxResults

[default: 20] The maximum number of items to return per page