pac package

Comandos para trabalhar com projetos de pacotes Dataverse.

Commands

pac package add-external-package

Adiciona um pacote externo ao sistema de solução Dataverse a um projeto do Package Deployer Package.

Parâmetros Obrigatórios para package add-external-package

--package-type -t

O tipo do pacote que está sendo adicionado. Por exemplo: 'xpp' para pacotes FnO.

--path -p

Caminho para o pacote externo

Parâmetros Opcionais para package add-external-package

--import-order

Um número inteiro que indica a ordem para inserir este item no arquivo de ImportConfig.xml final no momento da compilação. Os números negativos são inseridos antes dos elementos existentes. Os números positivos são adicionados após os elementos existentes.

--skip-validation -sv

Adiciona o item ao arquivo de projeto mesmo que o arquivo não exista ou pareça ser inválido. Nota: Usar isso não afeta nenhuma validação executada pelo MSBuild.

Este parâmetro não requer valor. É uma mudança.

pac package add-reference

Adiciona referência ao projeto de solução Dataverse

Example

pac package add-reference --path c:\Users\Downloads\SampleSolution

Parâmetros Obrigatórios para package add-reference

--path -p

O caminho para o projeto de solução Dataverse referenciado

Parâmetros Opcionais para package add-reference

--dependency-overrides

Uma lista delimitada por ponto-e-vírgula de substituições. Esse valor substitui qualquer informação de dependência codificada nos metadados da solução. Cada substituição deve estar no formato: <uniquename>:<minVersion>:<maxVersion>. Onde minVersion e maxVersion são opcionais, mas devem estar na sintaxe do formato de versão .NET.

Nota: Use uma lista delimitada por ponto-e-vírgula de substituições de dependência do formato <uniquename>:<minVersion>:<maxVersion>.

--import-mode

Especifica explicitamente o modo necessário ao importar esta solução.

Use um destes valores:

• sync
• async

--import-order

Um número inteiro que indica a ordem para inserir este item no arquivo de ImportConfig.xml final no momento da compilação. Os números negativos são inseridos antes dos elementos existentes. Os números positivos são adicionados após os elementos existentes.

--missing-dependency-behavior

Especifica o comportamento na importação quando uma dependência dessa solução está ausente do ambiente de destino.

Use um destes valores:

• skip
• fault

--overwrite-unmanaged-customizations

Indica explicitamente se as personalizações não gerenciadas devem ser substituídas quando essa solução é importada.

Use um destes valores:

• true
• false

--publish-workflows-activate-plugins

Indica explicitamente se os fluxos de trabalho devem ser publicados e ativados quando essa solução for importada.

Use um destes valores:

• true
• false

pac package add-solution

Adiciona um arquivo de solução Dataverse pré-criado a um projeto do Package Deployer Package.

Parâmetros Obrigatórios para package add-solution

--path -p

Caminho para o arquivo de solução Dataverse. O ficheiro tem de ser um ficheiro ZIP comprimido.

Parâmetros Opcionais para package add-solution

--dependency-overrides

Uma lista delimitada por ponto-e-vírgula de substituições. Esse valor substitui qualquer informação de dependência codificada nos metadados da solução. Cada substituição deve estar no formato: <uniquename>:<minVersion>:<maxVersion>. Onde minVersion e maxVersion são opcionais, mas devem estar na sintaxe do formato de versão .NET.

Nota: Use uma lista delimitada por ponto-e-vírgula de substituições de dependência do formato <uniquename>:<minVersion>:<maxVersion>.

--import-mode

Especifica explicitamente o modo necessário ao importar esta solução.

Use um destes valores:

• sync
• async

--import-order

Um número inteiro que indica a ordem para inserir este item no arquivo de ImportConfig.xml final no momento da compilação. Os números negativos são inseridos antes dos elementos existentes. Os números positivos são adicionados após os elementos existentes.

--missing-dependency-behavior

Especifica o comportamento na importação quando uma dependência dessa solução está ausente do ambiente de destino.

Use um destes valores:

• skip
• fault

--overwrite-unmanaged-customizations

Indica explicitamente se as personalizações não gerenciadas devem ser substituídas quando essa solução é importada.

Use um destes valores:

• true
• false

--publish-workflows-activate-plugins

Indica explicitamente se os fluxos de trabalho devem ser publicados e ativados quando essa solução for importada.

Use um destes valores:

• true
• false

--skip-validation -sv

Adiciona o item ao arquivo de projeto mesmo que o arquivo não exista ou pareça ser inválido. Nota: Usar isso não afeta nenhuma validação executada pelo MSBuild.

Este parâmetro não requer valor. É uma mudança.

pac package deploy

Implanta o pacote no Dataverse

Example

pac package deploy --logFile c:\samplelogdata --package c:\samplepackage

Parâmetros Opcionais para package deploy

--argument-file -af

Caminho para um ficheiro JSON que corresponde ao contrato IncrementalSyncParameters (ou ModuleSyncParters). Necessário para --db-sync Incremental.

--build-type -bt

Como o pacote é aplicado. Valores permitidos: Full, Incremental, Delete. Padrão: Cheio. Usado com --package-type erp.

--db-sync -ds

Modo de sincronização de base de dados para executar após a implementação. Valores permitidos: Nenhum, Completo, Módulo, Incremental. Padrão: Nenhum. Usado com --package-type erp.

--environment -env

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

--logConsole -c

Log de saída para o console

Este parâmetro não requer valor. É uma mudança.

--logFile -lf

Caminho do arquivo de log

--modules -m

Lista separada por vírgulas de nomes de módulos a sincronizar. É obrigatório quando --db-sync é Module.

--outputDirectory -o

Apenas modo solução: pasta raiz contendo .erp/xpp.json. Por defeito, o diretório atual. Quando --package é omitido em --package-type erp, todos os modelos listados em .erp/xpp.json são implementados por ordem de dependência.

--package -p

Caminho para um pacote dll ou arquivo zip com um pacote.

--package-type -pt

Plataforma alvo para implantação. Valores permitidos: dataverse, erp. Padrão: dataverse.

--release-type -rt

Classificação de encomendas. Valores permitidos: Dev, Release. Padrão: Dev. Os pacotes de lançamento forçam uma sincronização total da base de dados no servidor. Usado com --package-type erp.

--settings -s

Configurações do pacote de tempo de execução que são passadas para o pacote que está sendo implantado. O formato da cadeia de caracteres deve ser key=value|key=value.

Nota: O formato da cadeia de caracteres deve ser key=value|key=value.

--solution -sz

Caminho para o arquivo de solução Dataverse. O arquivo deve ser um arquivo compactado ZIP ou CAB.

--solution-root -sr

Apenas modo solução: pasta raiz contendo .erp/xpp.json. Por defeito, o diretório atual. Quando --package é omitido em --package-type erp, todos os modelos listados em .erp/xpp.json são implementados por ordem de dependência.

--verbose -vdbg

Emita logs detalhados para as saídas de log.

Este parâmetro não requer valor. É uma mudança.

Observações

Você pode usar ambos os parâmetros juntos logFile ou usar um logConsole parâmetro ou outro.

pac package init

Inicializa um diretório com um novo projeto de pacote Dataverse

Example

pac package init --outputdirectory c:\samplepackage

Parâmetros Opcionais para package init

--layer -l

Camada X++. Valores permitidos: USR, CUS, VAR, SL1, SL2, SL3, BUS, HFX, GLS, DIS, ISV. Padrão: ISV.

--model -m

Nome(s) do(s) modelo(s) X++ para andaimes. Aceita um único nome ou uma lista separada por vírgulas (por exemplo, ModelA, ModelB). É obrigatório quando o tipo de pacote é ERP.

--outputDirectory -o

Diretório de saída

--package-name

Define o nome padrão do pacote. Aplica-se à geração de ImportExtension.GetNameOfImport.

--package-type -pt

Tipo de projeto de pacote para andaime. Valores permitidos: dataverse, erp. Padrão: dataverse.

--publisher -pub

Nome do Publisher escrito no descritor modelo. Padrão: Microsoft.

--source-root -sr

Caminho raiz de origem (relativo ao diretório de saída) onde os modelos irão viver. Padrão: ./src.

pac package show

Mostra detalhes do pacote Dataverse

Example

pac package show c:\samplepackage.dll

Parâmetros Obrigatórios para package show

--package -p

Caminho para um pacote dll ou arquivo zip com um pacote.

Parâmetros Opcionais para package show

--environment -env

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

--logFile -lf

Caminho do arquivo de log

--verbose -vdbg

Emita logs detalhados para as saídas de log.

Este parâmetro não requer valor. É uma mudança.

Consulte também

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