Compartilhar via

conector pac

Comandos para trabalhar com conectores do Power Platform

Commands

Command Description
pac connector create Cria uma nova linha na tabela Conector no Dataverse.
download do conector pac Baixar o arquivo OpenApiDefinition e as Propriedades da API de um Conector
pac connector init Inicializa um novo arquivo de Propriedades da API para um Conector.
lista de conectores pac Listar os Conectores registrados no Dataverse.
atualização do conector pac Atualiza uma entidade do conector no Dataverse.

pac connector create

Cria uma nova linha na tabela Conector no Dataverse.

Exemplos

Os exemplos a seguir mostram o uso do pac connector create comando.

Criação básica de conector no ambiente atual

Este exemplo cria um conector no ambiente do seu perfil de autenticação ativo no momento.

pac connector create `
  --api-definition-file ./apiDefinition.json `
  --api-properties-file ./apiProperties.json

Criação básica de conector no ambiente especificado

Este exemplo cria um conector no ambiente especificado.

pac connector create `
  --api-definition-file ./apiDefinition.json `
  --api-properties-file ./apiProperties.json
  --environment 00000000-0000-0000-0000-000000000000

Parâmetros opcionais para criação de conector

--api-definition-file -df

O nome do arquivo e o caminho para ler o OpenApiDefinition do Conector.

--api-properties-file -pf

O nome do arquivo e o caminho para ler o arquivo Propriedades da API do Conector.

--environment -env

Especifica o Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

--icon-file -if

O nome do arquivo e o caminho para o arquivo de ícone .png.

--script-file -sf

O nome do arquivo e o caminho para um arquivo .csx de script.

--settings-file

O arquivo filename e o arquivo de configurações do conector de caminho.

--solution-unique-name -sol

O nome exclusivo da solução para adicionar o conector a

download do conector pac

Baixar o arquivo OpenApiDefinition e as Propriedades da API de um Conector

Exemplos

Os exemplos a seguir mostram o uso do pac connector download comando.

Download básico do conector

Este exemplo baixa o conector especificado para o diretório atual.

pac connector download `
  --connector-id 00000000-0000-0000-0000-000000000000

Download básico do conector do ambiente especificado

Este exemplo baixa o conector especificado do ambiente especificado para o diretório atual.

pac connector download `
  --connector-id 00000000-0000-0000-0000-000000000000 `
  --environment 00000000-0000-0000-0000-000000000000

Download básico do conector do ambiente especificado para o diretório especificado

Este exemplo baixa o conector especificado do ambiente especificado para o diretório especificado.

pac connector download `
  --connector-id 00000000-0000-0000-0000-000000000000 `
  --environment 00000000-0000-0000-0000-000000000000 `
  --outputDirectory "contoso_Connector"

Parâmetros necessários para download do conector

--connector-id -id

A ID do Conector

Observação: a ID do Conector deve ser um Guid válido.

Parâmetros opcionais para download do conector

--environment -env

Especifica o Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

--outputDirectory -o

Diretório de saída

pac connector init

Inicializa um novo arquivo de Propriedades da API para um Conector.

Example

O exemplo a seguir mostra o uso do pac connector init comando.

Init do conector com o diretório de saída e o modelo de conexão para autenticação OAuth da ID do Microsoft Entra

Este exemplo inicializa um conector no diretório atual.

pac connector init `
  --connection-template "OAuthAAD" `
  --generate-script-file `
  --generate-settings-file `
  --outputDirectory "contoso_Connector"

Parâmetros opcionais para a inicialização do conector

--connection-template -ct

Gere um conjunto inicial de parâmetros de conexão com o modelo especificado.

Use um destes valores:

  • NoAuth
  • BasicAuth
  • ApiKey
  • OAuthGeneric
  • OAuthAAD

--generate-script-file

Gerar um arquivo de script do conector inicial

Esse parâmetro não requer nenhum valor. É um comutador.

--generate-settings-file

Gerar um arquivo inicial de Configurações do Conector

Esse parâmetro não requer nenhum valor. É um comutador.

--outputDirectory -o

Diretório de saída

lista de conectores pac

Listar os Conectores registrados no Dataverse.

Exemplos

Os exemplos a seguir mostram o uso do pac connector list comando.

Listar conectores no ambiente atual

Este exemplo lista todos os conectores no ambiente do seu perfil de autenticação ativo no momento.

pac connector list

Listar conectores no ambiente especificado

Este exemplo lista todos os conectores no ambiente especificado.

pac connector list `
  --environment 00000000-0000-0000-0000-000000000000

Parâmetros opcionais para a lista de conectores

--environment -env

Especifica o Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

--json

Retorna a saída do comando como uma cadeia de caracteres formatada em JSON.

Observações

Somente conectores com reconhecimento de solução são mostrados. Quando o conector não está na resposta desse comando, provavelmente é por causa do fato de que o conector não está ciente da solução.

atualização do conector pac

Atualiza uma entidade do conector no Dataverse.

Exemplos

Os exemplos a seguir mostram o uso do pac connector update comando.

Atualização básica do conector no ambiente atual

Este exemplo atualiza um conector no ambiente do seu perfil de autenticação ativo no momento.

pac connector update `
  --api-definition-file ./apiDefinition.json

Atualização básica do conector no ambiente especificado

Este exemplo atualiza um conector no ambiente especificado.

pac connector update `
  --api-definition-file ./apiDefinition.json `
  --environment 00000000-0000-0000-0000-000000000000

Parâmetros opcionais para atualização do conector

--api-definition-file -df

O nome do arquivo e o caminho para ler o OpenApiDefinition do Conector.

--api-properties-file -pf

O nome do arquivo e o caminho para ler o arquivo Propriedades da API do Conector.

--connector-id -id

A ID do Conector

Observação: a ID do Conector deve ser um Guid válido.

--environment -env

Especifica o Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

--icon-file -if

O nome do arquivo e o caminho para o arquivo de ícone .png.

--script-file -sf

O nome do arquivo e o caminho para um arquivo .csx de script.

--settings-file

O arquivo filename e o arquivo de configurações do conector de caminho.

--solution-unique-name -sol

O nome exclusivo da solução para adicionar o conector a

Consulte também

Grupos de comandos da CLI do Microsoft Power Platform
Visão geral da CLI do Microsoft Power Platform

  • Last updated on