Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Comandos para trabalhar com projetos de solução do Dataverse
Commands
| Command | Description |
|---|---|
| pac solution add-license | Adicione informações de licença e plano à solução. |
| pac solution add-reference | Adiciona uma referência do projeto no diretório atual ao projeto em 'path' |
| pac solution add-solution-component | Adicione um ou mais componentes de solução à solução não gerenciada de destino no Dataverse. |
| pac solution check | Carregue um projeto de solução do Dataverse para ser executado no serviço Verificador do Power Apps. |
| pac solution clone | Crie um projeto de solução com base em uma solução existente em sua organização. |
| pac solution create-settings | Crie um arquivo de configurações com base no zip da solução ou na pasta da solução. |
| pac solution delete | Exclua uma solução do Dataverse no ambiente atual. |
| pac solution export | Exportar uma solução do Dataverse. |
| pac solution import | Importe a solução para o Dataverse. |
| pac solution init | Inicializa um diretório com um novo projeto de solução do Dataverse |
| pac solution list | Listar todas as soluções da organização dataverse atual |
| pac solution online-version | Define a versão da solução carregada no Dataverse. |
| pac solution pack | Empacotar componentes da solução no sistema de arquivos local em solution.zip (SolutionPackager). |
| pac solution publish | Publica todas as personalizações |
| pac solution sync | Sincronize o projeto de solução dataverse atual com o estado atual da solução em sua organização. |
| pac solution unpack | Extraia componentes da solução de solution.zip para o sistema de arquivos local (SolutionPackager). |
| pac solution upgrade | Aplicar solution upgrade |
| pac solution version | Atualize a versão de build ou revisão da solução. |
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 solution add-license
--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 solution add-reference
--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 solution 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 solution 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.
pac solution check
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 solution check
--clearCache
-cc
Limpa o solution checkcache de imposição de er, 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:
PreviewUnitedStatesUnitedStatesEuropeAsiaAustraliaJapanIndiaCanadaSouthAmericaUnitedKingdomFranceSouthAfricaGermanyUnitedArabEmiratesSwitzerlandNorwaySingaporeKoreaSwedenUSGovernmentUSGovernmentL4USGovernmentL5DoDChina
--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 do Marketplace", "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
pac solution clone
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
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 solution clone
--name
-n
O nome da solução a ser exportada.
Parâmetros opcionais para solution clone
--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:
autonumberingcalendarcustomizationemailtrackingexternalapplicationsgeneralisvconfigmarketingoutlooksynchronizationrelationshiprolessales
--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.
pac solution create-settings
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 solution create-settings
--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 solution delete
--solution-name
-sn
Nome da solução.
Parâmetros opcionais para solution delete
--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 export
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 solution export
--name
-n
O nome da solução a ser exportada.
Parâmetros opcionais para solution export
--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:
autonumberingcalendarcustomizationemailtrackingexternalapplicationsgeneralisvconfigmarketingoutlooksynchronizationrelationshiprolessales
--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.
pac solution import
Importe a solução para o Dataverse.
Example
pac solution import --path c:\Users\Documents\Solution.zip
Parâmetros opcionais para solution import
--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 solution import 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 pac comando de autenticação a ser usado pac solution import.
pac solution import
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 solution init
--publisher-name
-pn
Nome do dataverse solution publisher
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 do prefixo de personalização para o er do Dataverse solution publish
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 solution init
--outputDirectory
-o
Diretório de saída
pac solution list
Listar todas as soluções da organização dataverse atual
Example
pac solution list
Parâmetros opcionais para solution list
--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 solution online-version
--solution-name
-sn
Nome da solução.
--solution-version
-sv
Especifique o solution version número.
Parâmetros opcionais para solution online-version
--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 solution pack
--zipfile
-z
O caminho completo para o arquivo ZIP da solução
Parâmetros opcionais para solution pack
--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.
pac solution publish
Publica todas as personalizações
Example
pac solution publish
Parâmetros opcionais para solution publish
--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.
pac solution sync
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 solution sync
--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:
autonumberingcalendarcustomizationemailtrackingexternalapplicationsgeneralisvconfigmarketingoutlooksynchronizationrelationshiprolessales
--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.
pac solution unpack
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 solution unpack
--zipfile
-z
O caminho completo para o arquivo ZIP da solução
Parâmetros opcionais para solution unpack
--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.
pac solution upgrade
Aplicar solution upgrade
Example
pac solution upgrade --solution-name SampleSolution --async --max-async-wait-time 60
Parâmetros necessários para solution upgrade
--solution-name
-sn
Nome da solução.
Parâmetros opcionais para solution upgrade
--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.
pac solution version
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 solution version
--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:
NoneGitTagsFileTrackingSolution
Diferenças entre pac solution clone e exportar
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 clonequando precisar adicionar novos componentes à solução. - Use
pac solution exportquando quiser modificar o conteúdo existente em um arquivo de solução, mas não adicionar novos componentes à solução.
pac solution clone
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 o solution unpacked, 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.
pac solution export
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 continuar com o solution packarquivo 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