Microsoft Graph CLI Preview 8

What's New

• Added documentation content for non-terminal sub-commands
• MacOS binaries are now signed and notarized.
• Logout now clears tokens from the cache.
• Header command options can now be called multiple times. The header values will now be additive.
• Bug fixes. See CHANGELOG.md for more detailed changes
• Commands generated for all endpoints in the graph API's openapi.yaml file

Known Issues

Install instructions

1. Download from assets below and extract the application archive for your OS
2. Run the login command e.g. ./mgc login --scopes User.ReadWrite Mail.ReadWrite
3. Run any other commands. For a list of available commands, run ./mgc -h

Full Changelog: https://github.com/microsoftgraph/msgraph-cli/blob/b1433d32b5594b1267da92c60a75fca7db4a88d6/CHANGELOG.md#010-preview8---2023-02-10

Microsoft Graph CLI Preview 7

What's New

• Added certificate login (mgc login --strategy ClientCertificate)
• Added --debug option
• Bug fixes. See CHANGELOG.md for more detailed changes
• Commands generated for all endpoints in the graph API's openapi.yaml file

Known Issues

• Some of the new count commands e.g. mgc users count get require the ConsistencyLevel header set. However, the endpoint definitions don't document it and so the command doesn't have an option generated to allow the user to provide a value for it.

Install instructions

1. Download from assets below and extract the application archive for your OS
2. Run the login command e.g. ./mgc login --scopes User.ReadWrite Mail.ReadWrite
3. Run any other commands. For a list of available commands, run ./mgc -h

Full Changelog: https://github.com/microsoftgraph/msgraph-cli/blob/278813e8d4fe58f9bcc36c49febbb60daa379b16/CHANGELOG.md#010-preview7---2022-09-28

Microsoft Graph CLI Preview 6

What's New

• Add interactive browser login mgc login --strategy InteractiveBrowser
• Bug fixes. See CHANGELOG.md for more detailed changes
• Commands generated for all endpoints in the graph API's openapi.yaml file

Known Issues

• Some of the new count commands e.g. mgc users count get require the ConsistencyLevel header set. However, the endpoint definitions don't document it and so the command doesn't have an option generated to allow the user to provide a value for it.

Install instructions

1. Download from assets below and extract the application archive for your OS
2. Run the login command e.g. ./mgc login --scopes User.ReadWrite Mail.ReadWrite
3. Run any other commands. For a list of available commands, run ./mgc -h

Full Changelog: https://github.com/microsoftgraph/msgraph-cli/blob/150f98c046e8cbd4df9b930cce552a3b9f635b11/CHANGELOG.md#010-preview6---2022-08-18

Microsoft Graph CLI Preview 5

What's New

• Add item sub-command for indexer paths (paths with id). GET /users/{user-id} changes from mgc users get --user-id to mgc users item get --user-id
• Add command samples.
• Add automatic page iteration via the --all command option.
• Bug fixes. See CHANGELOG.md for more detailed changes
• Commands generated for all endpoints in the graph API's openapi.yaml file

Known Issues

• Some of the new count commands e.g. mgc users count get require the ConsistencyLevel header set. However, the endpoint definitions don't document it and so the command doesn't have an option generated to allow the user to provide a value for it.

Install instructions

1. Download from assets below and extract the application archive for your OS
2. Run the login command e.g. ./mgc login --scopes User.ReadWrite --scopes Mail.ReadWrite
3. Run any other commands. For a list of available commands, run ./mgc -h

Full Changelog: https://github.com/microsoftgraph/msgraph-cli/blob/03317b2b2c14957b1d3ce5258f0239a2070f4cd6/CHANGELOG.md#010-preview5---2022-06-10

Microsoft Graph CLI Preview 4

What's New

• Default values for client id and tenant id.
• Add documented headers as command options.
• Make config file optional.
• Bug fixes. See CHANGELOG.md for more detailed changes
• Commands generated for all endpoints in the graph API's openapi.yaml file

Known Issues

• Some of the new count commands e.g. mgc users count get require the ConsistencyLevel header set. However, the endpoint definitions don't document it and so the command doesn't have an option generated to allow the user to provide a value for it.

Install instructions

1. Download and extract the application archive for your OS
2. Run the login command e.g. ./mgc login --scopes User.ReadWrite --scopes Mail.ReadWrite
3. Run any other commands. For a list of available commands, run ./mgc -h

Full Changelog: https://github.com/microsoftgraph/msgraph-cli/blob/87bbcdea2b9383b7e441feeecf9cdea888509421/CHANGELOG.md#010-preview4---2022-04-19

Microsoft Graph CLI Preview 3

What's New

• JMESPath query support via the --query option
• Indent JSON responses by default. This option can be turned off via the --json-no-indent argument.
• Allow setting clientId and tenantId parameters via the login command. Editing configuration files is no longer required.
• Bug fixes. See CHANGELOG.md for more detailed changes
• Commands generated for all endpoints in the graph API's openapi.yaml file

Known Issues

Install instructions

1. Download and extract the application archive for your OS
2. Run the login command e.g. ./mgc login --client-id <clientid> --tenant-id <tenantid> --scopes User.ReadWrite --scopes Mail.ReadWrite
3. Run any other commands. For a list of available commands, run ./mgc -h

Full Changelog: https://github.com/microsoftgraph/msgraph-cli/blob/v0.1.0-preview.3/CHANGELOG.md#010-preview3---2022-03-17

Microsoft Graph CLI Preview 2

What's New

• Table output format
• Commands generated for all endpoints in the graph API's openapi.yaml file

Known Issues

• Requests fail when we add --select or --expand options to a command
• When the API responds with an error, the application crashes.

Install instructions

1. Download and extract the application archive for your OS
2. Update the app-settings.json file adding a tenant id and client id. Look at the app-settings.sample.json file for a sample.
3. Run the login command e.g. ./mgc login --scopes User.ReadWrite --scopes Mail.ReadWrite
4. Run any other commands. For a list of available commands, run ./mgc -h

Full Changelog: https://github.com/microsoftgraph/msgraph-cli/commits/v0.1.0-preview.2

Microsoft Graph CLI Preview 1

What's New

• Login and logout
• Configuration file support. See app-settings.sample.json for an example configuration
• Commands generated for all endpoints in the graph API's openapi.yaml file

Known Issues

• Requests fail when we add --select or --expand options to a command
• When the API responds with an error, the application crashes.
• If a user isn't logged in, the application prompts them to log in but no scopes are requested.

Install instructions

1. Download and extract the application archive for your OS
2. Update the app-settings.json file adding a tenant id and client id. Look at the app-settings.sample.json file for a sample.
3. Run the login command e.g. ./mgc login --scopes User.ReadWrite --scopes Mail.ReadWrite
4. Run any other commands. For a list of available commands, run ./mgc -h

Full Changelog: https://github.com/microsoftgraph/msgraph-cli/commits/0.1.0-preview.1