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

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) 。