Configure CLI for Microsoft 365
You can configure CLI for Microsoft 365 to your personal preferences using its settings. Settings are stored on the disk in the current user's folder: C:\Users\user\.config\configstore\cli-m365-config.json on Windows and /Users/user/.config/configstore/cli-m365-config.json on macOS. The configuration file is created when you set the settings for the first time.
To reset settings to their default values, remove them from the configuration file or remove the whole configuration file.
Configuring settings
You can configure the specific setting using the cli config set command. For example, to configure CLI to automatically show help when executing a command failed, execute:
m365 cli config set --key showHelpOnFailure --value true
Available settings
Following is the list of configuration settings available in CLI for Microsoft 365.
| Setting name | Definition | Default value |
|---|---|---|
autoOpenLinksInBrowser | Automatically open the browser for all commands which return a url and expect the user to copy paste this to the browser. For example when logging in, using m365 login in device code mode. | false |
copyDeviceCodeToClipboard | Automatically copy the device code to the clipboard when running m365 login command in device code mode | false |
csvEscape | Single character used for escaping; only apply to characters matching the quote and the escape options | " |
csvHeader | Display the column names on the first line | true |
csvQuote | The quote characters surrounding a field. An empty quote value will preserve the original field, whether it contains quotation marks or not. | |
csvQuoted | Quote all the non-empty fields even if not required | false |
csvQuotedEmpty | Quote empty strings and overrides quoted_string on empty strings when defined | false |
disableTelemetry | Disables sending of telemetry data | false |
errorOutput | Defines if errors should be written to stdout or stderr | stderr |
helpMode | Defines what part of command's help to display. Allowed values are options, examples, remarks, response, full | options |
output | Defines the default output when issuing a command. Allowed values are json, text, csv, md, none | json |
printErrorsAsPlainText | When output mode is set to json, print error messages as plain-text rather than JSON | true |
prompt | Prompts for missing values in required options and enables interactive selection when multiple values are available for a command that requires a specific value to be retrieved. | true |
showHelpOnFailure | Automatically display help when executing a command failed | true |
showSpinner | Display spinner when executing commands | true |