Instalación de la interfaz de línea de comandos (CLI) de Microsoft Graph

La interfaz de línea de comandos (CLI) de Microsoft Graph se publica en GitHub.

Instalación

Windows

1. Descargue el archivo .zip a partir de msgraph-cli-win-x64 desde la sección Activos de la página Versiones de GitHub.
2. Extraiga el contenido del archivo en un directorio.

Configuración del entorno de Windows (opcional)

1. Abra Configuración.

2. Seleccione Acerca de y, a continuación, Configuración avanzada del sistema.

3. Seleccione Variables de entorno....

4. Busque y seleccione Ruta de acceso y, a continuación, seleccione Editar.

   Nota:

   La variable Path está presente en Variables de usuario , así como en Variables del sistema. La actualización de la variable en Variables de usuario solo actualizará la ruta de acceso del usuario actual. Al actualizar la variable en Variables del sistema , se actualizará la ruta de acceso de todos los usuarios del equipo.

5. Agregue la ruta de acceso completa al directorio que contiene mgc.exe.

Linux

1. Descargue el archivo .tar.gz a partir de msgraph-cli-linux-x64 desde la sección Activos de la página Versiones de GitHub.
2. Extraiga el contenido del archivo en un directorio.

Configuración del entorno linux

Para actualizar PATH para la sesión actual, ejecute el siguiente comando mientras está en el directorio que contiene mgc.

export PATH=$PATH:$(PWD)

Como alternativa, puede actualizar PATH permanentemente editando el perfil de shell (~/.bash-profile o ~/.zsh-profile). Agregue la siguiente línea al perfil.

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

Configuración de gnome-keyring

Los pasos siguientes son necesarios en las distribuciones de Linux que no tienen un entorno de escritorio.

1. Instale gnome-keyring y libsecret con el siguiente comando.

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

2. Ejecute un proceso de demonio de gnome-keyring con los siguientes comandos. Reemplace por secure-password una contraseña segura de su elección.

   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
   

   Nota:

   Los comandos anteriores se deben ejecutar cada vez que se reinicie el sistema.

macOS

1. Descargue el archivo .tar.gz a partir de msgraph-cli-osx-x64 (para Mac basado en Intel) o msgraph-cli-osx-arm (para Mac basado en M1 o M2) de la sección Activos de la página Versiones de GitHub.
2. Extraiga el contenido del archivo en un directorio.

Configuración del entorno de macOS

Para actualizar PATH para la sesión actual, ejecute el siguiente comando mientras está en el directorio que contiene mgc.

export PATH=$PATH:$(PWD)

Como alternativa, puede actualizar PATH permanentemente editando el perfil de shell (~/.bash-profile o ~/.zsh-profile). Agregue la siguiente línea al perfil.

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

Verificar la instalación

Una vez completada la instalación, puede comprobar la versión instalada con el siguiente comando.

mgc --version

La versión de la salida debe coincidir con la versión más reciente publicada en TBD. Ahora está listo para usar el SDK.

Actualización de la CLI

Para actualizar la CLI, descargue una versión más reciente y extráigala en el directorio que contiene la versión anterior.

Desinstalación de la CLI

Elimine los archivos de su ubicación.

Pasos siguientes

Para obtener información sobre cómo realizar tareas básicas con la CLI de Microsoft Graph, consulte Introducción a la interfaz de línea de comandos (CLI) de Microsoft Graph.