Instalar a CLI (interface de linha de comando) do Microsoft Graph

A CLI (interface de linha de comando) do Microsoft Graph é publicada no GitHub.

Instalação

Windows

1. Baixe o arquivo .zip começando com msgraph-cli-win-x64 na seção Ativos da página Versões do GitHub.
2. Extraia o conteúdo do arquivo em um diretório.

Configuração do ambiente do Windows (Opcional)

1. Abra Configurações.

2. Selecione Sobre e, em seguida, Configurações avançadas do sistema.

3. Selecione Variáveis de Ambiente....

4. Localize e selecione Caminho e selecione Editar.

   Observação

   A variável Path está presente em variáveis de usuário , bem como variáveis de sistema. Atualizar a variável em Variáveis de usuário só atualizará o caminho do usuário atual. Atualizar a variável em Variáveis de sistema atualizará o caminho para todos os usuários no computador.

5. Adicione o caminho completo ao diretório que contém mgc.exe.

Linux

1. Baixe o arquivo .tar.gz começando com msgraph-cli-linux-x64 na seção Ativos da página Versões do GitHub.
2. Extraia o conteúdo do arquivo em um diretório.

Configuração do ambiente do Linux

Para atualizar PATH para sua sessão atual, execute o comando a seguir enquanto estiver no diretório que contém mgc.

export PATH=$PATH:$(PWD)

Como alternativa, você pode atualizar PATH permanentemente editando seu perfil de shell (~/.bash-profile ou ~/.zsh-profile). Adicione a linha a seguir ao seu perfil.

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

Configurar o gnome-keyring

As etapas a seguir são necessárias nas distribuições do Linux que não têm um ambiente de área de trabalho.

1. Instale gnome-keyring e libsecret com o comando a seguir.

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

2. Execute um processo de daemon de chave de gnome com os comandos a seguir. Substitua secure-password por uma senha segura de sua escolha.

   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
   

   Observação

   Os comandos anteriores devem ser executados sempre que o sistema é reiniciado.

macOS

1. Baixe o arquivo .tar.gz começando com msgraph-cli-osx-x64 (para Mac baseado em Intel) ou msgraph-cli-osx-arm (para M1 ou Mac baseado em M2) na seção Ativos da página Versões do GitHub.
2. Extraia o conteúdo do arquivo em um diretório.

Configuração do ambiente macOS

Para atualizar PATH para sua sessão atual, execute o comando a seguir enquanto estiver no diretório que contém mgc.

export PATH=$PATH:$(PWD)

Como alternativa, você pode atualizar PATH permanentemente editando seu perfil de shell (~/.bash-profile ou ~/.zsh-profile). Adicione a linha a seguir ao seu perfil.

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

Verificar a instalação

Depois que a instalação for concluída, você poderá verificar a versão instalada com o comando a seguir.

mgc --version

A versão na saída deve corresponder à versão mais recente publicada no TBD. Agora você está pronto para usar o SDK.

Atualizando a CLI

Para atualizar a CLI, baixe uma versão mais recente e extraia para o diretório que contém a versão mais antiga.

Desinstalando a CLI

Exclua os arquivos de sua localização.

Próximas etapas

Para saber como executar tarefas básicas com a CLI do Microsoft Graph, consulte Introdução à CLI (interface de linha de comando) do Microsoft Graph.