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.
Comandos para trabalhar com projetos de solução Dataverse
Commands
| Command | Description |
|---|---|
| Licença adicional da solução PAC | Adicione informações de licença e plano à solução. |
| Referência adicional da solução PAC | Adiciona uma referência do projeto no diretório atual ao projeto em 'path' |
| Solução PAC Add-Solution-Component | Adicione um ou mais componentes da solução à solução não gerenciada de destino no Dataverse. |
| Verificação da solução PAC | Carregue um projeto de solução Dataverse para ser executado no serviço Power Apps Checker. |
| clone da solução pac | Crie um projeto de solução com base em uma solução existente em sua organização. |
| Create-Settings da solução PAC | Crie um arquivo de configurações a partir do zip da solução ou da pasta da solução. |
| Solução PAC Excluir | Exclua uma solução do Dataverse no ambiente atual. |
| Exportação de solução PAC | Exporte uma solução do Dataverse. |
| Importação de solução PAC | Importe a solução para o Dataverse. |
| solução pac init | Inicializa um diretório com um novo projeto de solução Dataverse |
| Lista de soluções PAC | Listar todas as soluções da organização atual do Dataverse |
| PAC Solution Online-versão | Define a versão da solução carregada no Dataverse. |
| Pacote de Soluções PAC | Empacote componentes da solução no sistema de arquivos local em solution.zip (SolutionPackager). |
| Publicação da solução PAC | Publica todas as personalizações |
| 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. |
| Solução PAC desembalar | Extraia componentes da solução do solution.zip para o sistema de arquivos local (SolutionPackager). |
| Atualização da solução PAC | Aplicar atualização de solução |
| Versão da solução PAC | Atualize a versão de compilação ou revisão da solução. |
Licença adicional da solução PAC
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
Planejar arquivo de mapeamento
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 complemento da solução
--planDefinitionFile
-pd
Arquivo de definição de plano de licença em formato CSV; colunas esperadas: ID do serviço, Nome para exibição, URL de mais informações.
--planMappingFile
-pm
Arquivo de mapeamento de plano de licença em formato CSV; colunas esperadas: ID do serviço, Nome do componente
Referência adicional da solução PAC
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 referência adicional da solução
--path
-p
O caminho para o projeto referenciado
Solução PAC Add-Solution-Component
Adicione um ou mais componentes da 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 é do 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 ID do componente a ser adicionado à 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 de solução que você está adicionando também devem ser adicionados à solução não gerenciada.
Este parâmetro não requer valor. É uma mudança.
--async
-a
Importa a solução de forma assíncrona.
Este parâmetro não requer valor. É uma mudança.
--environment
-env
URL ou ID do ambiente de destino.
Verificação da solução PAC
Carregue um projeto de solução Dataverse para ser executado no serviço Power Apps Checker.
Example
pac solution check --path c:\Users\Documents\Solution.zip --outputDirectory c:\samplepackage --geo UnitedStates
Parâmetros opcionais para verificação da solução
--clearCache
-cc
Limpa o cache de imposição do verificador de soluções, para seu locatário, de todos os registros que dizem respeito a resultados anteriores para suas soluções.
Este parâmetro não requer valor. É uma mudança.
--customEndpoint
-ce
Especifique uma URL personalizada como o ponto de extremidade do Power Apps Checker.
--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.
--excludedFiles
-ef
Excluir arquivos da análise. Passar como valores separados por vírgulas
--geo
-g
Qual instância geográfica do serviço Power Apps Checker usar.
Use um destes valores:
PreviewUnitedStatesUnitedStatesEuropeAsiaAustraliaJapanIndiaCanadaSouthAmericaUnitedKingdomFranceSouthAfricaGermanyUnitedArabEmiratesSwitzerlandNorwaySingaporeKoreaSwedenUSGovernmentUSGovernmentL4USGovernmentL5DoDChina
--outputDirectory
-o
Diretório de saída
--path
-p
Caminho onde existe 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 que seja executado como parte dessa compilação. Valores: Um Guid válido, "AppSource Certification", "Solution Checker" (padrão).
--saveResults
-sav
Usa o ambiente atual para armazenar os resultados da análise da solução que podem ser vistos no aplicativo Solution Health Hub. Por padrão, esse argumento é definido como false.
Este parâmetro não requer valor. É uma mudança.
--solutionUrl
-u
SAS Uri aponta para solution.zip a analisar
clone da solução pac
Crie um projeto de solução com base em uma solução existente em sua organização.
Examples
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
Clone com configurações gerais e de numeração automática incluídas
Este exemplo clona a solução sampleSolution para o diretório atual com as configurações gerais e de numeração automática incluídas.
pac solution clone --name sampleSolution --include general,autonumbering
Parâmetros necessários para clone de solução
--name
-n
O nome da solução a ser exportada.
Parâmetros opcionais para clone de solução
--async
-a
Exporta a solução de forma assíncrona.
Este parâmetro não requer valor. É uma mudança.
--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.
--include
-i
Quais configurações devem ser incluídas na solução que está sendo exportada.
Use um ou mais destes valores separados por vírgulas:
autonumberingcalendarcustomizationemailtrackingexternalapplicationsgeneralisvconfigmarketingoutlooksynchronizationrelationshiprolessales
--localize
-loc
Extraia ou mescle todos os recursos de cadeia de caracteres em arquivos .resx.
Este parâmetro não requer valor. É uma mudança.
--map
-m
O caminho completo para um arquivo xml de mapeamento a partir do qual ler pastas de componentes para empacotar.
--max-async-wait-time
-wt
Tempo de espera assíncrono máximo 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 é: 'Both'.
--targetversion
-v
Preterido: Este parâmetro é ignorado.
Create-Settings da solução PAC
Crie um arquivo de configurações a partir do zip da solução ou da 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 'Outros/Solution.xml' ou uma pasta com um arquivo .cdsproj.
--solution-zip
-z
Caminho para o arquivo zip da solução.
Solução PAC Excluir
Exclua uma solução do Dataverse no ambiente atual.
Example
pac solution delete --solution-name Samplesolution
Parâmetros necessários para a 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 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.
Exportação de solução PAC
Exporte 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ções
--async
-a
Exporta a solução de forma assíncrona.
Este parâmetro não requer valor. É uma mudança.
--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.
--include
-i
Quais configurações devem ser incluídas na solução que está sendo exportada.
Use um ou mais destes valores separados por vírgulas:
autonumberingcalendarcustomizationemailtrackingexternalapplicationsgeneralisvconfigmarketingoutlooksynchronizationrelationshiprolessales
--managed
-m
Se a solução deve ser exportada como uma solução gerenciada.
Este parâmetro não requer valor. É uma mudança.
--max-async-wait-time
-wt
Tempo de espera assíncrono máximo 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.
Este parâmetro não requer valor. É uma mudança.
--path
-p
Caminho onde o arquivo zip da solução exportada é gravado.
--targetversion
-v
Preterido: Este parâmetro é ignorado.
Importação de 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ções
--activate-plugins
-ap
Ative plug-ins e fluxos de trabalho na solução.
Este parâmetro não requer valor. É uma mudança.
--async
-a
Importa a solução de forma assíncrona.
Este parâmetro não requer valor. É uma mudança.
--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.
--force-overwrite
-f
Forçar uma substituição de personalizações não gerenciadas
Este parâmetro não requer valor. É uma mudança.
--import-as-holding
-h
Importe a solução como uma solução de retenção.
Este parâmetro não requer valor. É uma mudança.
--max-async-wait-time
-wt
Tempo de espera assíncrono máximo em minutos. O valor padrão é 60 minutos.
--path
-p
Caminho para o arquivo zip da solução. Se não for especificado, assume que a pasta atual é um projeto cdsproj.
--publish-changes
-pc
Publique suas alterações após uma importação bem-sucedida.
Este parâmetro não requer valor. É uma mudança.
--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 verificação de dependência em relação a dependências sinalizadas como atualização de produto
Este parâmetro não requer valor. É uma mudança.
--skip-lower-version
-slv
Ignore a importação da solução se a mesma versão ou a versão superior estiver presente no ambiente atual.
Este parâmetro não requer valor. É uma mudança.
--stage-and-upgrade
-up
Importe e atualize a solução.
Este parâmetro não requer valor. É uma mudança.
Observações
Você estará conectado a um ambiente usando o comando pac auth para usar pac solution importo .
Importação de solução PAC
Quando Path o parâmetro não é especificado, ele assume que a pasta atual é um projeto cdsproj. Se a SolutionPackageType propriedade no arquivo cdsproj estiver definida como Both, a solução gerenciada será usada por padrão.
solução pac init
Inicializa um diretório com um novo projeto de solução 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 da solução Dataverse
Nota: Apenas são permitidos caracteres dentro dos intervalos [A - Z], [a - z], [0 - 9] ou _ . O primeiro caractere pode estar apenas nos intervalos [A - Z], [a - z] ou _.
--publisher-prefix
-pp
Valor do prefixo de personalização para o editor da solução Dataverse
Nota: 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 solução init
--outputDirectory
-o
Diretório de saída
Lista de soluções PAC
Listar todas as soluções da organização atual do Dataverse
Example
pac solution list
Parâmetros opcionais para a lista de soluções
--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.
--includeSystemSolutions
Inclua soluções de sistema como as publicadas pela Microsoft
Este parâmetro não requer valor. É uma mudança.
--json
Retorna a saída do comando como uma cadeia de caracteres formatada em JSON.
PAC Solution Online-versão
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 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.
Pacote de Soluções PAC
Empacote 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'.
Este parâmetro não requer valor. É uma mudança.
--allowWrite
-aw
Determina se as operações de gravação podem ocorrer. O valor padrão é 'false'.
Este parâmetro não requer valor. É uma mudança.
--clobber
-c
Permite que os arquivos marcados como somente leitura possam ser excluídos ou substituídos. O valor padrão é 'false'.
Este parâmetro não requer valor. É uma mudança.
--disablePluginRemap
-dpm
Remapeamento de nome de tipo totalmente qualificado do plug-in desativado. O valor padrão é 'false'.
Este parâmetro não requer valor. É uma mudança.
--errorlevel
-e
Nível mínimo de log para saída de log [Verbose|Informações|Atenção|Erro|Desligado]. O valor padrão é 'Info'.
--folder
-f
O caminho para a pasta raiz no sistema de arquivos local. Ao desembalar ou extrair, isso é escrito. Ao embalar, isso é lido.
--localize
-loc
Extraia ou mescle todos os recursos de cadeia de caracteres em arquivos .resx.
Este parâmetro não requer valor. É uma mudança.
--log
-l
O caminho para o arquivo de log.
--map
-m
O caminho completo para um arquivo xml de mapeamento a partir do qual ler pastas de componentes para empacotar.
--packagetype
-p
Ao descompactar ou extrair, use para especificar duas operações gerenciadas e não gerenciadas. Ao empacotar, use para especificar Gerenciado ou Não gerenciado de um descompactador anterior 'Ambos'. Pode ser: 'Não gerenciado', 'Gerenciado' ou 'Ambos'. O valor padrão é 'Unmanaged'.
--singleComponent
-sc
Execute uma ação somente em um único tipo de componente [WebResource|Plugin|Fluxo de trabalho|Nenhuma]. O valor padrão é 'Nenhum'.
--sourceLoc
-src
Gera um arquivo de recurso de modelo. Válido apenas no extrato. Os valores possíveis são 'auto', ou código de idioma do idioma que você deseja exportar. Você pode usar formatos de código de idioma LCID (Language Code Identifier) ou ISO (International Organization for Standardization). Quando presente, isso extrai os recursos de cadeia de caracteres de determinada localidade como um .resx neutro. Se 'auto' ou apenas a forma longa ou curta do switch for especificado, a localidade base para a solução será usada.
--useLcid
-lcid
Use valores LCID (Language Code Identifier) (1033) em vez de códigos ISO (en-US) para arquivos de idioma.
Este parâmetro não requer valor. É uma mudança.
--useUnmanagedFileForMissingManaged
-same
Use o mesmo arquivo de origem XML quando o empacotamento para o arquivo XML gerenciado e somente não gerenciado for encontrado; aplica-se a AppModuleSiteMap, AppModuleMap, arquivos FormXml.
Este parâmetro não requer valor. É uma mudança.
Publicação da solução PAC
Publica todas as personalizações
Example
pac solution publish
Parâmetros opcionais para publicação da solução
--async
-a
Publica todas as personalizações de forma assíncrona
Este parâmetro não requer valor. É uma mudança.
--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.
--max-async-wait-time
-wt
Tempo de espera assíncrono máximo 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.
Examples
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ções
--async
-a
Exporta a solução de forma assíncrona.
Este parâmetro não requer valor. É uma mudança.
--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.
--include
-i
Quais configurações devem ser incluídas na solução que está sendo exportada.
Use um ou mais destes valores separados por vírgulas:
autonumberingcalendarcustomizationemailtrackingexternalapplicationsgeneralisvconfigmarketingoutlooksynchronizationrelationshiprolessales
--localize
-loc
Extraia ou mescle todos os recursos de cadeia de caracteres em arquivos .resx.
Este parâmetro não requer valor. É uma mudança.
--map
-m
O caminho completo para um arquivo xml de mapeamento a partir do qual ler pastas de componentes para empacotar.
--max-async-wait-time
-wt
Tempo de espera assíncrono máximo em minutos. O valor padrão é 60 minutos.
--packagetype
-p
Ao descompactar ou extrair, use para especificar duas operações gerenciadas e não gerenciadas. Ao empacotar, use para especificar Gerenciado ou Não gerenciado de um descompactador anterior 'Ambos'. Pode ser: 'Não gerenciado', 'Gerenciado' ou 'Ambos'. O valor padrão é: 'Both'.
--solution-folder
-f
Caminho para a pasta de solução local descompactada: a raiz do arquivo 'Outros/Solution.xml' ou uma pasta com um arquivo .cdsproj.
Solução PAC desembalar
Extraia componentes da solução do solution.zip para o sistema de arquivos local (SolutionPackager).
Example
pac solution unpack --zipfile C:\SampleSolution.zip --folder .\SampleSolutionUnpacked\.
Parâmetros necessários para a solução desembalar
--zipfile
-z
O caminho completo para o arquivo ZIP da solução
Parâmetros opcionais para descompactar a solução
--allowDelete
-ad
Determina se as operações de exclusão podem ocorrer. O valor padrão é 'false'.
Este parâmetro não requer valor. É uma mudança.
--allowWrite
-aw
Determina se as operações de gravação podem ocorrer. O valor padrão é 'false'.
Este parâmetro não requer valor. É uma mudança.
--clobber
-c
Permite que os arquivos marcados como somente leitura possam ser excluídos ou substituídos. O valor padrão é 'false'.
Este parâmetro não requer valor. É uma mudança.
--disablePluginRemap
-dpm
Remapeamento de nome de tipo totalmente qualificado do plug-in desativado. O valor padrão é 'false'.
Este parâmetro não requer valor. É uma mudança.
--errorlevel
-e
Nível mínimo de log para saída de log [Verbose|Informações|Atenção|Erro|Desligado]. O valor padrão é 'Info'.
--folder
-f
O caminho para a pasta raiz no sistema de arquivos local. Ao desembalar ou extrair, isso é escrito. Ao embalar, isso é lido.
--localize
-loc
Extraia ou mescle todos os recursos de cadeia de caracteres em arquivos .resx.
Este parâmetro não requer valor. É uma mudança.
--log
-l
O caminho para o arquivo de log.
--map
-m
O caminho completo para um arquivo xml de mapeamento a partir do qual ler pastas de componentes para empacotar.
--packagetype
-p
Ao descompactar ou extrair, use para especificar duas operações gerenciadas e não gerenciadas. Ao empacotar, use para especificar Gerenciado ou Não gerenciado de um descompactador anterior 'Ambos'. Pode ser: 'Não gerenciado', 'Gerenciado' ou 'Ambos'. O valor padrão é 'Unmanaged'.
--singleComponent
-sc
Execute uma ação somente em um único tipo de componente [WebResource|Plugin|Fluxo de trabalho|Nenhuma]. O valor padrão é 'Nenhum'.
--sourceLoc
-src
Gera um arquivo de recurso de modelo. Válido apenas no extrato. Os valores possíveis são 'auto', ou código de idioma do idioma que você deseja exportar. Você pode usar formatos de código de idioma LCID (Language Code Identifier) ou ISO (International Organization for Standardization). Quando presente, isso extrai os recursos de cadeia de caracteres de determinada localidade como um .resx neutro. Se 'auto' ou apenas a forma longa ou curta do switch for especificado, a localidade base para a solução será usada.
--useLcid
-lcid
Use valores LCID (Language Code Identifier) (1033) em vez de códigos ISO (en-US) para arquivos de idioma.
Este parâmetro não requer valor. É uma mudança.
--useUnmanagedFileForMissingManaged
-same
Use o mesmo arquivo de origem XML quando o empacotamento para o arquivo XML gerenciado e somente não gerenciado for encontrado; aplica-se a AppModuleSiteMap, AppModuleMap, arquivos FormXml.
Este parâmetro não requer valor. É uma mudança.
Atualização da solução PAC
Aplicar atualização de 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
Este parâmetro não requer valor. É uma mudança.
--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.
--max-async-wait-time
-wt
Tempo de espera assíncrono máximo em minutos. O valor padrão é 60 minutos.
Versão da solução PAC
Atualize a versão de compilação 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 compilação para a solução.
Nota: O valor deve ser um inteiro com valor mínimo de 0.
--filename
-fn
Nome do arquivo CSV do Tracker a ser usado ao usar o rastreamento de arquivos como estratégia. O valor padrão é 'ControlsStateVersionInfo.csv'.
--patchversion
-pv
Preterido: Este parâmetro é ignorado.
--revisionversion
-rv
Versão de revisão para a solução.
Nota: O valor deve ser um inteiro com valor mínimo de 0.
--solutionPath
-sp
Caminho para o diretório da solução Dataverse ou Solution.xml arquivo.
--strategy
-s
Atualiza a versão de compilação para o arquivo 'Solution.xml' usando a estratégia especificada. Se estiver usando gittags, defina o token de acesso pessoal na seguinte variável de ambiente "PacCli.PAT"
Use um destes valores:
NoneGitTagsFileTrackingSolution
Diferenças entre clone e exportação de solução pac
Há situações em que você não tem certeza de quando usar pac solution clone ou pac solution export comandar. 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.
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 que são necessárias para construir o projeto. A saída de compilação é um arquivo zip de solução, que você pode importar para diferentes ambientes.
O desenvolvedor não precisa descompactar 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 esta solução, com a solução descompactada, você pode 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 um ou dotnet buildmsbuild.
Recomenda-se fazer uma restauração de compilação antes de construir o projeto. Uma restauração de compilação (dotnet build faz uma restauração primeiro automaticamente) restaurará as bibliotecas .NET necessárias para gerar uma solução compactada.
Exportação de 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ê descompacta 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órios resultante é semelhante à estrutura em pac solution clone. A única diferença é que você não pode adicionar referências a essa solução descompactada, pois ela não tem o arquivo de .cdsproj projeto.
Você pode modificar o conjunto relevante de arquivos que deseja atualizar e, em seguida, prosseguir com o pacote de solução, 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 de 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