(CLI) 安装 Microsoft Graph 命令行接口

Microsoft Graph 命令行接口 (CLI) 在 GitHub 上发布。

安装

Windows

1. 从 GitHub 版本页的“资产”部分下载以 msgraph-cli-win-x64 开头的 .zip 文件。
2. 将文件的内容提取到目录中。

Windows 环境设置 (可选)

1. 打开 “设置>系统”。

2. 选择“ 关于>高级系统设置”。

3. 选择“ 环境变量...”。

4. 找到并选择“ 路径> ”，选择 “编辑”。

   注意

   Path 变量存在于用户变量和系统变量中。 更新 用户变量中的变量 只会更新当前用户的路径。 更新 系统变量中的变量 将更新计算机上的所有用户的路径。

5. 将完整路径添加到包含 mgc.exe的目录。

Linux

1. 从 GitHub 版本页的“资产”部分下载以 msgraph-cli-linux-x64 开头的 .tar.gz 文件。
2. 将文件的内容提取到目录中。

Linux 环境设置

若要更新 PATH 当前会话，请在包含 mgc 的目录中运行以下命令。

export PATH=$PATH:$(PWD)

或者，可以通过编辑 shell 配置文件 (或 ~/.zsh-profile) ~/.bash-profile 来永久更新PATH。 将以下行添加到配置文件。

export PATH=$PATH:[path-to-the-cli-folder]

配置 gnome-keyring

对于没有桌面环境的 Linux 分发版，需要执行以下步骤。

1. 使用以下命令安装 gnome-keyring 和 libsecret 。

   sudo apt-get install --assume-yes gnome-keyring libsecret-1-0
   

2. 使用以下命令运行 gnome-keyring 守护程序进程。 将 替换为 secure-password 你选择的安全密码。

   sudo setcap cap_ipc_lock=+ep $(which gnome-keyring-daemon)
   
   export DBUS_SESSION_BUS_ADDRESS=$(dbus-daemon --session --fork --print-address)
   
   export KEYRING_PASSWORD=secure-password
   
   dbus-run-session -- echo "$KEYRING_PASSWORD" | gnome-keyring-daemon --daemonize --components=secrets --unlock
   

   注意

   每次系统重启时，都必须运行上述命令。

macOS

1. 从 GitHub Releases 页面的“资产”部分，下载以 msgraph-cli-osx-x64 (开头的基于 Intel 的 Mac) 或 msgraph-cli-osx-arm (for M1 或 M2 的 mac) 的 .tar.gz 文件。
2. 将文件的内容提取到目录中。

macOS 环境设置

若要更新 PATH 当前会话，请在包含 mgc 的目录中运行以下命令。

export PATH=$PATH:$(PWD)

或者，可以通过编辑 shell 配置文件 (或 ~/.zsh-profile) ~/.bash-profile 来永久更新PATH。 将以下行添加到配置文件。

export PATH=$PATH:[path-to-the-cli-folder]

验证安装

安装完成后，可以使用以下命令验证已安装的版本。

mgc --version

输出中的版本应与 TBD 上发布的最新版本匹配。 现在，你已准备好使用 SDK。

更新 CLI

若要更新 CLI，请下载较新版本，并将其提取到包含旧版本的目录中。

卸载 CLI

从其位置删除文件。

后续步骤

若要了解如何使用 Microsoft Graph CLI 执行基本任务，请参阅 Microsoft Graph 命令行接口入门 (CLI) 。