Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Começando com Power Apps biblioteca de clientes para aplicativos de código versão 1.1.9, a nova CLI baseada em npm inclui um comando create-connection. Use este comando para criar uma conexão para um conector diretamente da linha de comando, sem sair do terminal ou abrir o portal do criador de Power Apps.
A conexão é criada no ambiente do Power Platform que seu aplicativo de código está usando no momento (o ambiente definido em power.config.json quando você executou power-apps init).
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 npm.
- O conector que você deseja usar deve dar suporte ao SSO (logon único). Confira Limitações.
Uso
Execute o comando na raiz do seu projeto de aplicativo de código:
power-apps create-connection --api-id <connectorId> [--display-name <name>] [--json]
Opções
| Opção | Alias | Obrigatório | Description |
|---|---|---|---|
--api-id |
-a |
Yes | Identificador da API do conector (por exemplo, shared_office365, shared_teams). |
--display-name |
-n |
No | Nome de exibição opcional para a nova conexão. Se não for especificado, um padrão será usado. |
--json |
— | No | Gere o resultado como JSON para cenários de script. |
Exemplos
Criar uma conexão Office 365:
power-apps create-connection --api-id shared_office365
Crie uma conexão do Teams com um nome de exibição personalizado:
power-apps create-connection --api-id shared_teams --display-name "My Teams"
Criar uma conexão e emitir uma saída JSON (útil em scripts e CI):
power-apps create-connection --api-id shared_office365 --json
Com êxito, o comando imprime a ID da nova conexão. Em seguida, você pode referenciar essa ID de conexão ao adicionar o conector como uma fonte de dados ao seu aplicativo de código.
Limitations
- Há suporte apenas para a criação de conexões SSO não interativas. O comando
create-connectionsó funciona para conectores cujo único tipo de autenticação é elegível para SSO — normalmente conectores baseados em Microsoft Entra ID, como Office 365 Outlook, SharePoint, OneDrive for Business e Microsoft Teams. - Não há suporte para conectores que exigem credenciais fornecidas pelo usuário ou configuração. Exemplos incluem SQL Server com autenticação SQL, conectores personalizados que exigem chaves de API e qualquer conector que exponha vários métodos de autenticação para o usuário escolher. Para criar essas conexões, use o portal do criador do Power Apps.