solução pac

Comandos para trabalhar com projetos de solução do Dataverse

Commands

pac solution add-license

Adicione informações de licença e plano à solução.

Example

Este exemplo mostra como adicionar informações de licenciamento a uma solução.

pac solution add-license --planDefinitionFile ../ISV_Plan_Definition.csv --planMappingFile ../ISV_Plan_Mapping.csv

Arquivo de definição de plano

Abaixo, você encontrará um exemplo do arquivo de definição de plano:

ServiceID,Display name,More info URL
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.bronzeplan,Fabrikam Bronze Plan,http://www.microsoft.com
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.silverplan,Fabrikam Silver Plan,http://www.microsoft.com
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.goldplan,Fabrikam Gold Plan,http://www.microsoft.com

Arquivo de mapeamento de plano

Abaixo, você encontrará um exemplo do arquivo de mapeamento de plano:

Service ID,Component name
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.bronzeplan,crf36_BronzeApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.silverplan,crf36_BronzeApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.silverplan,crf36_SilverApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.goldplan,crf36_BronzeApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.goldplan,crf36_SilverApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.goldplan,crf36_GoldApp

Parâmetros necessários para a licença de adição de solução

--planDefinitionFile -pd

Arquivo de definição do plano de licença no formato CSV; colunas esperadas: ID do serviço, nome de exibição, URL de mais informações.

--planMappingFile -pm

Arquivo de mapeamento de plano de licença no formato CSV; colunas esperadas: ID do serviço, nome do componente

pac solution add-reference

Adiciona uma referência do projeto no diretório atual ao projeto em 'path'

Example

pac solution add-reference --path c:\Users\Downloads\SampleComponent

Parâmetros necessários para a referência de adição de solução

--path -p

O caminho para o projeto referenciado

pac solution add-solution-component

Adicione um ou mais componentes de solução à solução não gerenciada de destino no Dataverse.

Example

Este exemplo mostra como adicionar um componente de solução a uma solução. Nesse caso, estamos adicionando a tabela de contatos à solução SampleSolution. Uma tabela é o tipo de componente 1.

pac solution add-solution-component --solutionUniqueName SampleSolution --component contact --componentType 1

Parâmetros necessários para a solução add-solution-component

--component -c

O nome do esquema ou a ID do componente para adicionar à solução de destino.

--componentType -ct

O valor que representa o componente da solução que você está adicionando.

--solutionUniqueName -sn

Nome da solução.

Parâmetros opcionais para solução add-solution-component

--AddRequiredComponents -arc

Indica se outros componentes de solução exigidos pelo componente da solução que você está adicionando também devem ser adicionados à solução não gerenciada.

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

--async -a

Importa a solução de forma assíncrona.

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

--environment -env

URL do ambiente ou ID do ambiente de destino.

verificação da solução pac

Carregue um projeto de solução do Dataverse para ser executado no serviço Verificador do Power Apps.

Example

pac solution check --path c:\Users\Documents\Solution.zip --outputDirectory c:\samplepackage --geo UnitedStates

Parâmetros opcionais para verificação de solução

--clearCache -cc

Limpa o cache de imposição do verificador de solução, para seu locatário, de todos os registros que pertencem a resultados anteriores para suas soluções.

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

--customEndpoint -ce

Especifique uma URL personalizada como o ponto de extremidade do Verificador do Power Apps.

--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.

--excludedFiles -ef

Exclua arquivos da análise. Passar como valores separados por vírgulas

--geo -g

Qual instância geográfica do serviço verificador do Power Apps usar.

Use um destes valores:

• PreviewUnitedStates
• UnitedStates
• Europe
• Asia
• Australia
• Japan
• India
• Canada
• SouthAmerica
• UnitedKingdom
• France
• SouthAfrica
• Germany
• UnitedArabEmirates
• Switzerland
• Norway
• Singapore
• Korea
• Sweden
• USGovernment
• USGovernmentL4
• USGovernmentL5DoD
• China

--outputDirectory -o

Diretório de saída

--path -p

Caminho em que existem um ou mais arquivos de solução a serem verificados. O caminho pode conter caracteres glob/curinga.

--ruleLevelOverride -rl

Caminho para um arquivo que contém regras e níveis de matriz JSON a serem substituídos. Os valores aceitos para OverrideLevel são: crítico, alto, médio, baixo, informativo. Exemplo: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]

--ruleSet -rs

Selecione um conjunto de regras executado como parte deste build. Valores: Um Guid válido, "Certificação AppSource", "Verificador de Soluções" (padrão).

--saveResults -sav

Usa o ambiente atual para armazenar os resultados da análise de solução que podem ser vistos no Aplicativo hub de integridade da solução. Por padrão, esse argumento é definido como false.

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

--solutionUrl -u

Uri sas apontando para solution.zip a serem analisados

clone da solução pac

Crie um projeto de solução com base em uma solução existente em sua organização.

Exemplos

Os exemplos a seguir mostram o uso do pac solution clone comando.

• Clone básico
• Clonar com configurações de numeração geral e automática incluídas

Clone básico

Este exemplo clona a solução sampleSolution para o diretório atual.

pac solution clone --name sampleSolution

Clonar com configurações de numeração geral e automática incluídas

Este exemplo clona a solução sampleSolution para o diretório atual com as configurações de numeração geral e automática incluídas.

pac solution clone --name sampleSolution --include general,autonumbering

Parâmetros necessários para clonagem de solução

--name -n

O nome da solução a ser exportada.

Parâmetros opcionais para clonagem de solução

--async -a

Exporta a solução de forma assíncrona.

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

--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.

--include -i

Quais configurações devem ser incluídas na solução que está sendo exportada.

Use um ou mais desses valores separados por vírgulas:

• autonumbering
• calendar
• customization
• emailtracking
• externalapplications
• general
• isvconfig
• marketing
• outlooksynchronization
• relationshiproles
• sales

--localize -loc

Extraia ou mescle todos os recursos de cadeia de caracteres em arquivos .resx.

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

--map -m

O caminho completo para um arquivo xml de mapeamento do qual ler pastas de componente para empacotar.

--max-async-wait-time -wt

Tempo máximo de espera assíncrono em minutos. O valor padrão é 60 minutos.

--outputDirectory -o

Diretório de saída

--packagetype -p

Especifica o tipo de extração para a solução. Pode ser: 'Não gerenciado', 'Gerenciado' ou 'Ambos'. O valor padrão é: 'Ambos'.

--targetversion -v

Preterido: esse parâmetro é ignorado.

configurações de criação da solução pac

Crie um arquivo de configurações com base no zip da solução ou na pasta da solução.

Example

pac solution create-settings --solution-zip C:\SampleSolution.zip --settings-file .\SampleDeploymentSettingsDev.json

Parâmetros opcionais para configurações de criação de solução

--settings-file -s

O arquivo .json com as configurações de implantação para referências de conexão e variáveis de ambiente.

--solution-folder -f

Caminho para a pasta de solução local descompactada: a raiz do arquivo 'Other/Solution.xml' ou uma pasta com um arquivo .cdsproj.

--solution-zip -z

Caminho para arquivo zip de solução.

pac solution delete

Exclua uma solução do Dataverse no ambiente atual.

Example

pac solution delete --solution-name Samplesolution

Parâmetros necessários para exclusão da solução

--solution-name -sn

Nome da solução.

Parâmetros opcionais para exclusão de solução

--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.

exportação da solução pac

Exportar uma solução do Dataverse.

Example

pac solution export --path c:\Users\Documents\Solution.zip --name SampleComponentSolution --managed true --include general

Parâmetros necessários para exportação de solução

--name -n

O nome da solução a ser exportada.

Parâmetros opcionais para exportação de solução

--async -a

Exporta a solução de forma assíncrona.

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

--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.

--include -i

Quais configurações devem ser incluídas na solução que está sendo exportada.

Use um ou mais desses valores separados por vírgulas:

• autonumbering
• calendar
• customization
• emailtracking
• externalapplications
• general
• isvconfig
• marketing
• outlooksynchronization
• relationshiproles
• sales

--managed -m

Se a solução deve ser exportada como uma solução gerenciada.

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

--max-async-wait-time -wt

Tempo máximo de espera assíncrono em minutos. O valor padrão é 60 minutos.

--overwrite -ow

O arquivo de solução exportado pode substituir o arquivo zip da solução no sistema de arquivos local.

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

--path -p

Caminho em que o arquivo zip da solução exportada é gravado.

--targetversion -v

Preterido: esse parâmetro é ignorado.

importação da solução pac

Importe a solução para o Dataverse.

Example

pac solution import --path c:\Users\Documents\Solution.zip

Parâmetros opcionais para importação de solução

--activate-plugins -ap

Ative plug-ins e fluxos de trabalho na solução.

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

--async -a

Importa a solução de forma assíncrona.

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

--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.

--force-overwrite -f

Forçar uma substituição de personalizações não gerenciadas

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

--import-as-holding -h

Importe a solução como uma solução de retenção.

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

--max-async-wait-time -wt

Tempo máximo de espera assíncrono em minutos. O valor padrão é 60 minutos.

--path -p

Caminho para arquivo zip de solução. Se não for especificado, pressupõe que a pasta atual seja um projeto cdsproj.

--publish-changes -pc

Publique suas alterações após uma importação bem-sucedida.

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

--settings-file

O arquivo .json com as configurações de implantação para referências de conexão e variáveis de ambiente.

--skip-dependency-check -s

Ignorar a verificação de dependência em relação às dependências sinalizadas como atualização do produto

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

--skip-lower-version -slv

Ignore a importação da solução se a mesma versão ou versão superior estiver presente no ambiente atual.

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

--stage-and-upgrade -up

Importe e atualize a solução.

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

Observações

Você está conectado a um ambiente usando o comando pac auth a ser usado pac solution import.

importação da solução pac

Quando Path o parâmetro não é especificado, ele pressupõe que a pasta atual seja um projeto cdsproj. Se a SolutionPackageType propriedade no arquivo cdsproj estiver definida como Both, a solução gerenciada será usada por padrão.

pac solution init

Inicializa um diretório com um novo projeto de solução do Dataverse

Example

pac solution init --publisher-name developer --publisher-prefix dev

Parâmetros necessários para a inicialização da solução

--publisher-name -pn

Nome do editor de soluções do Dataverse

Observação: somente caracteres dentro dos intervalos [A - Z], [a - z], [0 - 9], ou _ são permitidos. O primeiro caractere pode estar apenas nos intervalos [A - Z], [a - z], ou _.

--publisher-prefix -pp

Valor de prefixo de personalização para o editor de soluções do Dataverse

Observação: o prefixo deve ter de 2 a 8 caracteres, só pode consistir em alfanuméricos, deve começar com uma letra e não pode começar com 'mscrm'.

Parâmetros opcionais para a inicialização da solução

--outputDirectory -o

Diretório de saída

lista de soluções pac

Listar todas as soluções da organização dataverse atual

Example

pac solution list

Parâmetros opcionais para a lista de soluções

--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.

--includeSystemSolutions

Incluir soluções do sistema como as publicadas pela Microsoft

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

--json

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

pac solution online-version

Define a versão da solução carregada no Dataverse.

Example

pac solution online-version --solution-name Samplesolution --solution-version 1.0.0.2

Parâmetros necessários para a versão online da solução

--solution-name -sn

Nome da solução.

--solution-version -sv

Especifique o número da versão da solução.

Parâmetros opcionais para a versão online da solução

--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.

pac solution pack

Empacotar componentes da solução no sistema de arquivos local em solution.zip (SolutionPackager).

Example

pac solution pack --zipfile C:\SampleSolution.zip --folder .\SampleSolutionUnpacked\.

Parâmetros necessários para o pacote de soluções

--zipfile -z

O caminho completo para o arquivo ZIP da solução

Parâmetros opcionais para o pacote de soluções

--allowDelete -ad

Determina se as operações de exclusão podem ocorrer. O valor padrão é 'false'.

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

--allowWrite -aw

Determina se as operações de gravação podem ocorrer. O valor padrão é 'false'.

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

--clobber -c

Permite que os arquivos marcados como somente leitura possam ser excluídos ou substituídos. O valor padrão é 'false'.

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

--disablePluginRemap -dpm

Plug-in totalmente qualificado desabilitado remapeando o nome do tipo. O valor padrão é 'false'.

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

--errorlevel -e

Nível mínimo de log para saída de log [Detalhado|Informações|Aviso|Erro|Desativado]. O valor padrão é 'Info'.

--folder -f

O caminho para a pasta raiz no sistema de arquivos local. Ao desempacotar ou extrair, isso é gravado. Ao empacotar, isso é lido.

--localize -loc

Extraia ou mescle todos os recursos de cadeia de caracteres em arquivos .resx.

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

--log -l

O caminho para o arquivo de log.

--map -m

O caminho completo para um arquivo xml de mapeamento do qual ler pastas de componente para empacotar.

--packagetype -p

Ao desempacotar ou extrair, use para especificar a operação gerenciada e não gerenciada dupla. Ao empacotar, use para especificar Gerenciado ou Não Gerenciado de um unpack anterior 'Both'. Pode ser: 'Não gerenciado', 'Gerenciado' ou 'Ambos'. O valor padrão é 'Não gerenciado'.

--singleComponent -sc

Executar apenas uma ação em um único tipo de componente [WebResource|Plug-in|Fluxo de trabalho|Nenhum]. O valor padrão é 'None'.

--sourceLoc -src

Gera um arquivo de recurso de modelo. Válido somente na extração. Os valores possíveis são "auto" ou código de idioma do idioma que você deseja exportar. Você pode usar o LCID (Identificador de Código de Idioma) ou os formatos de código de linguagem ISO (Organização Internacional para Padronização). Quando presente, isso extrai os recursos de cadeia de caracteres da localidade fornecida como um .resx neutro. Se 'auto' ou apenas a forma longa ou curta do comutador for especificada, a localidade base da solução será usada.

--useLcid -lcid

Use valores de LCID (Identificador de Código de Linguagem) (1033) em vez de códigos ISO (Organização Internacional para Padronização) (en-US) para arquivos de idioma.

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

--useUnmanagedFileForMissingManaged -same

Use o mesmo arquivo de origem XML quando o empacotamento para o arquivo XML gerenciado e não gerenciado for encontrado; aplica-se a arquivos AppModuleSiteMap, AppModuleMap, FormXml.

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

publicação da solução pac

Publica todas as personalizações

Example

pac solution publish

Parâmetros opcionais para publicação de solução

--async -a

Publica todas as personalizações de forma assíncrona

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

--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.

--max-async-wait-time -wt

Tempo máximo de espera assíncrono em minutos. O valor padrão é 60 minutos.

sincronização da solução pac

Sincronize o projeto de solução dataverse atual com o estado atual da solução em sua organização.

Exemplos

Os exemplos a seguir mostram o uso do pac solution sync comando.

Sincronização básica

Este exemplo sincroniza a solução com o diretório atual.

pac solution sync

Parâmetros opcionais para sincronização de solução

--async -a

Exporta a solução de forma assíncrona.

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

--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.

--include -i

Quais configurações devem ser incluídas na solução que está sendo exportada.

Use um ou mais desses valores separados por vírgulas:

• autonumbering
• calendar
• customization
• emailtracking
• externalapplications
• general
• isvconfig
• marketing
• outlooksynchronization
• relationshiproles
• sales

--localize -loc

Extraia ou mescle todos os recursos de cadeia de caracteres em arquivos .resx.

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

--map -m

O caminho completo para um arquivo xml de mapeamento do qual ler pastas de componente para empacotar.

--max-async-wait-time -wt

Tempo máximo de espera assíncrono em minutos. O valor padrão é 60 minutos.

--packagetype -p

Ao desempacotar ou extrair, use para especificar a operação gerenciada e não gerenciada dupla. Ao empacotar, use para especificar Gerenciado ou Não Gerenciado de um unpack anterior 'Both'. Pode ser: 'Não gerenciado', 'Gerenciado' ou 'Ambos'. O valor padrão é: 'Ambos'.

--solution-folder -f

Caminho para a pasta de solução local descompactada: a raiz do arquivo 'Other/Solution.xml' ou uma pasta com um arquivo .cdsproj.

desempacotar a solução pac

Extraia componentes da solução de solution.zip para o sistema de arquivos local (SolutionPackager).

Example

pac solution unpack --zipfile C:\SampleSolution.zip --folder .\SampleSolutionUnpacked\.

Parâmetros necessários para desempacotar a solução

--zipfile -z

O caminho completo para o arquivo ZIP da solução

Parâmetros opcionais para desempacotar a solução

--allowDelete -ad

Determina se as operações de exclusão podem ocorrer. O valor padrão é 'false'.

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

--allowWrite -aw

Determina se as operações de gravação podem ocorrer. O valor padrão é 'false'.

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

--clobber -c

Permite que os arquivos marcados como somente leitura possam ser excluídos ou substituídos. O valor padrão é 'false'.

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

--disablePluginRemap -dpm

Plug-in totalmente qualificado desabilitado remapeando o nome do tipo. O valor padrão é 'false'.

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

--errorlevel -e

Nível mínimo de log para saída de log [Detalhado|Informações|Aviso|Erro|Desativado]. O valor padrão é 'Info'.

--folder -f

O caminho para a pasta raiz no sistema de arquivos local. Ao desempacotar ou extrair, isso é gravado. Ao empacotar, isso é lido.

--localize -loc

Extraia ou mescle todos os recursos de cadeia de caracteres em arquivos .resx.

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

--log -l

O caminho para o arquivo de log.

--map -m

O caminho completo para um arquivo xml de mapeamento do qual ler pastas de componente para empacotar.

--packagetype -p

Ao desempacotar ou extrair, use para especificar a operação gerenciada e não gerenciada dupla. Ao empacotar, use para especificar Gerenciado ou Não Gerenciado de um unpack anterior 'Both'. Pode ser: 'Não gerenciado', 'Gerenciado' ou 'Ambos'. O valor padrão é 'Não gerenciado'.

--singleComponent -sc

Executar apenas uma ação em um único tipo de componente [WebResource|Plug-in|Fluxo de trabalho|Nenhum]. O valor padrão é 'None'.

--sourceLoc -src

Gera um arquivo de recurso de modelo. Válido somente na extração. Os valores possíveis são "auto" ou código de idioma do idioma que você deseja exportar. Você pode usar o LCID (Identificador de Código de Idioma) ou os formatos de código de linguagem ISO (Organização Internacional para Padronização). Quando presente, isso extrai os recursos de cadeia de caracteres da localidade fornecida como um .resx neutro. Se 'auto' ou apenas a forma longa ou curta do comutador for especificada, a localidade base da solução será usada.

--useLcid -lcid

Use valores de LCID (Identificador de Código de Linguagem) (1033) em vez de códigos ISO (Organização Internacional para Padronização) (en-US) para arquivos de idioma.

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

--useUnmanagedFileForMissingManaged -same

Use o mesmo arquivo de origem XML quando o empacotamento para o arquivo XML gerenciado e não gerenciado for encontrado; aplica-se a arquivos AppModuleSiteMap, AppModuleMap, FormXml.

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

atualização da solução pac

Aplicar atualização da solução

Example

pac solution upgrade --solution-name SampleSolution --async --max-async-wait-time 60

Parâmetros necessários para atualização da solução

--solution-name -sn

Nome da solução.

Parâmetros opcionais para atualização da solução

--async -a

Atualiza a solução de forma assíncrona

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

--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.

--max-async-wait-time -wt

Tempo máximo de espera assíncrono em minutos. O valor padrão é 60 minutos.

versão da solução pac

Atualize a versão de build ou revisão da solução.

Example

pac solution version --patchversion 2

pac solution version --strategy gittags

Parâmetros opcionais para a versão da solução

--buildversion -bv

Versão de build para a solução.

Observação: o valor deve ser um inteiro com valor mínimo de 0.

--filename -fn

Nome do arquivo CSV do rastreador a ser usado ao usar o rastreamento de arquivos como estratégia. O valor padrão é 'ControlsStateVersionInfo.csv'.

--patchversion -pv

Preterido: esse parâmetro é ignorado.

--revisionversion -rv

Versão de revisão para a solução.

Observação: o valor deve ser um inteiro com valor mínimo de 0.

--solutionPath -sp

Caminho para o diretório da solução do Dataverse ou Solution.xml arquivo.

--strategy -s

Atualiza a versão de build para o arquivo 'Solution.xml' usando a estratégia especificada. Se estiver usando gittags, defina o token de acesso pessoal na variável de ambiente "PacCli.PAT" a seguir

Use um destes valores:

• None
• GitTags
• FileTracking
• Solution

Diferenças entre a clonagem e a exportação da solução pac

Há situações em que você não tem certeza de quando usar pac solution clone ou pac solution export comando. Você pode usar um dos comandos nos seguintes cenários:

• Use pac solution clone quando precisar adicionar novos componentes à solução.
• Use pac solution export quando quiser modificar o conteúdo existente em um arquivo de solução, mas não adicionar novos componentes à solução.

clone da solução pac

A solução exportada se parece com um projeto do Visual Studio quando você exporta a solução usando o pac solution clone comando. Em vez de um .csproj (como no Visual Studio), você verá um cdsproj arquivo. O cdsproj arquivo tem todas as informações de componentes necessárias para compilar o projeto. A saída de build é um arquivo zip da solução, que você pode importar para ambientes diferentes.

O desenvolvedor não precisa desempacotar a solução clonada porque ela é renderizada em um formato descompactado dentro da pasta src (origem).

Agora, se você quiser associar um plug-in recém-criado a essa solução, com a solução descompactada, poderá usar o pac solution add-reference comando para atualizar o .cdsproj arquivo para adicionar o novo plug-in. Em seguida, você pode criar o projeto usando ou dotnet buildmsbuild.

É recomendável fazer uma restauração de build primeiro antes de compilar o projeto. Uma restauração de build (o build dotnet faz uma restauração primeiro automaticamente) restaurará as bibliotecas .NET necessárias para gerar uma solução empacotada.

exportação da solução pac

Quando você exporta a solução usando pac solution export você sente vontade de exportar a solução usando o portal do criador e a saída resultante é um arquivo zip da solução.

Quando você desempacotar o arquivo zip da solução (não recomendamos que você abra o zip com ferramentas padrão e use o comando apropriado da CLI). A estrutura de diretório resultante é semelhante à estrutura em pac solution clone. A única diferença é que você não pode adicionar referências a essa solução desempacotada, pois ela não tem o arquivo de .cdsproj projeto.

Você pode modificar o conjunto relevante de arquivos que deseja atualizar e, em seguida, continuar com o pacote de soluções, que gera o arquivo zip da solução novamente para facilitar a importação da solução para o ambiente de destino. O resultado da ação é um arquivo zip da solução com conteúdo atualizado e um carimbo de data/hora atualizado.

Consulte também

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