Criar uma conexão com base na CLI do Power Apps

Use a CLI Power Apps para localizar conectores e criar uma conexão sem sair do terminal ou abrir Power Apps.

Pré-requisitos

Um aplicativo de código inicializado do Power Apps. Confira o Início Rápido: Criar um aplicativo de código usando a CLI do Power Apps.

Etapa 1: Listar conectores disponíveis

Execute os comandos neste artigo na raiz do projeto do aplicativo de código.

Use pa connector list para localizar os conectores disponíveis no ambiente do Power Platform configurado para seu aplicativo de código:

pa connector list [--search <term>] [--json]

O ambiente é definido quando power.config.json você executa pa app init.

Opções

Opção Alias Obrigatório Description
--search -s No Filtra conectores por nome ou nome de exibição.
--json - No Retorna a lista de conectores como JSON.

Saída

Por padrão, o comando retorna uma tabela com as seguintes colunas:

Coluna Description
Nome de Exibição O nome de exibição do conector, como Office 365 Outlook.
Conector O identificador do conector, como shared_office365. Use esse valor com a opção --connector de pa connection create.

Em um terminal interativo, os resultados aparecem em páginas de 20 linhas. Pressione Enter para mostrar a próxima página. Pressione Esc ou Q para sair. Quando você redireciona a saída ou a inclusão --json, o comando retorna a lista completa.

A saída JSON inclui os seguintes campos:

Campo Description
id A ID do conector.
name O identificador do conector, como shared_office365.
displayName O nome a apresentar do conector.
description A descrição do conector.
isTabular Indica se o conector dá suporte a operações de dados tabulares.

Exemplos

Listar todos os conectores disponíveis:

pa connector list

Pesquise conectores:

pa connector list --search teams

Retorne a lista de conectores como JSON:

pa connector list --json

Etapa 2: Criar a conexão

Use pa connection create para criar uma conexão no ambiente configurado para o aplicativo de código:

pa connection create --connector <connector-id> [--display-name <name>] [--json]

Opções

Opção Alias Obrigatório Description
--connector - Yes O identificador do conector, como shared_office365 ou shared_teams.
--display-name -n No O nome de exibição da conexão. Se você não fornecer um nome, a CLI usará um nome padrão.
--json - No Retorna o resultado como JSON.

Exemplos

Criar uma conexão Office 365 Outlook:

pa connection create --connector shared_office365

Crie uma conexão Microsoft Teams com um nome de exibição personalizado:

pa connection create --connector shared_teams --display-name "My Teams"

Crie uma conexão e retorne o resultado como JSON:

pa connection create --connector shared_office365 --json

Quando o comando for bem-sucedido, ele retornará a ID da conexão. Use a ID de conexão ao adicionar o conector como uma fonte de dados ao aplicativo de código.