Releases: microsoftgraph/msgraph-cli
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
- Download from assets below and extract the application archive for your OS
- Run the login command e.g.
./mgc login --scopes User.ReadWrite Mail.ReadWrite
- 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 theConsistencyLevel
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
- Download from assets below and extract the application archive for your OS
- Run the login command e.g.
./mgc login --scopes User.ReadWrite Mail.ReadWrite
- 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 theConsistencyLevel
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
- Download from assets below and extract the application archive for your OS
- Run the login command e.g.
./mgc login --scopes User.ReadWrite Mail.ReadWrite
- 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 frommgc users get --user-id
tomgc 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 theConsistencyLevel
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
- Download from assets below and extract the application archive for your OS
- Run the login command e.g.
./mgc login --scopes User.ReadWrite --scopes Mail.ReadWrite
- 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 theConsistencyLevel
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
- Download and extract the application archive for your OS
- Run the login command e.g.
./mgc login --scopes User.ReadWrite --scopes Mail.ReadWrite
- 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
- Download and extract the application archive for your OS
- Run the login command e.g.
./mgc login --client-id <clientid> --tenant-id <tenantid> --scopes User.ReadWrite --scopes Mail.ReadWrite
- 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
- Download and extract the application archive for your OS
- Update the
app-settings.json
file adding a tenant id and client id. Look at the app-settings.sample.json file for a sample. - Run the login command e.g.
./mgc login --scopes User.ReadWrite --scopes Mail.ReadWrite
- 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
- Download and extract the application archive for your OS
- Update the
app-settings.json
file adding a tenant id and client id. Look at the app-settings.sample.json file for a sample. - Run the login command e.g.
./mgc login --scopes User.ReadWrite --scopes Mail.ReadWrite
- 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