Установка интерфейса командной строки Microsoft Graph (CLI)

Интерфейс командной строки Microsoft Graph (CLI) опубликован на сайте GitHub.

Установка

Windows

1. Скачайте файл .zip, начинающийся с msgraph-cli-win-x64 , из раздела Активына странице Выпуски GitHub.
2. Извлеките содержимое файла в каталог.

Настройка среды Windows (необязательно)

1. Откройте раздел Параметры.

2. Выберите О программе, а затем — Дополнительные параметры системы.

3. Выберите Переменные среды....

4. Найдите и выберите Путь, а затем — Изменить.

   Примечание.

   Переменная Path присутствует в пользовательских переменных , а также системных переменных. При обновлении переменной в переменных пользователя обновляется только путь текущего пользователя. При обновлении переменной в системных переменных будет обновлен путь для всех пользователей на компьютере.

5. Добавьте полный путь в каталог, содержащий mgc.exe.

Linux

1. Скачайте файл .tar.gz, начинающийся с msgraph-cli-linux-x64 , из раздела Активына странице Выпуски GitHub.
2. Извлеките содержимое файла в каталог.

Настройка среды Linux

Чтобы обновить PATH текущий сеанс, выполните следующую команду в каталоге, содержав mgc.

export PATH=$PATH:$(PWD)

Кроме того, можно обновить PATH без возможности восстановления, изменив профиль оболочки (~/.bash-profile или ~/.zsh-profile). Добавьте следующую строку в профиль.

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

Настройка набора ключей gnome

Следующие действия необходимы для дистрибутивов Linux, которые не имеют среды рабочего стола.

1. Установите gnome-keyring и libsecret с помощью следующей команды.

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

2. Запустите управляющая программа для управления ключами gnome с помощью следующих команд. Замените 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. Скачайте файл .tar.gz, начинающийся с msgraph-cli-osx-x64 (для Mac на базе Intel) или msgraph-cli-osx-arm (для Mac на основе M1 или M2), из раздела Активына странице Выпуски GitHub.
2. Извлеките содержимое файла в каталог.

Настройка среды macOS

Чтобы обновить PATH текущий сеанс, выполните следующую команду в каталоге, содержав mgc.

export PATH=$PATH:$(PWD)

Кроме того, можно обновить PATH без возможности восстановления, изменив профиль оболочки (~/.bash-profile или ~/.zsh-profile). Добавьте следующую строку в профиль.

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

Проверка установки

После завершения установки можно проверить установленную версию с помощью следующей команды.

mgc --version

Версия в выходных данных должна соответствовать последней версии, опубликованной в TBD. Теперь вы готовы использовать пакет SDK.

Обновление интерфейса командной строки

Чтобы обновить интерфейс командной строки, скачайте более новую версию и извлеките его в каталог, содержащий старую версию.

Удаление интерфейса командной строки

Удалите файлы из их расположения.

Дальнейшие действия

Сведения о том, как выполнять основные задачи с помощью Интерфейса командной строки Microsoft Graph, см. в статье Начало работы с интерфейсом командной строки Microsoft Graph (CLI).