Compartir por


Solución PAC

Comandos para traballar con proxectos de solucións de Dataverse

Comandos

Comando Descripción
Licenza de engadido da solución PAC Engade información de licenza e plan á solución.
Referencia de engadido de solucións pac Engade unha referencia do proxecto no directorio actual ao proxecto en 'path'
pac solution add-solution-component Engadir un ou máis compoñentes da solución á solución non xestionada de destino en Dataverse.
Comprobación da solución PAC Cargar un proxecto de solución Dataverse para executalo no servizo Power Apps Checker.
Clon de solución PAC Crea un proxecto de solución baseado nunha solución existente na túa organización.
Configuración de creación da solución pac Crea un ficheiro de configuración a partir do zip da solución ou do cartafol de solucións.
Eliminación da solución PAC Eliminar unha solución de Dataverse no entorno actual.
Exportación de solucións PAC Exportar unha solución desde Dataverse.
Importación de solucións PAC Importa a solución a Dataverse.
PAC Solution Init Inicializa un cartafol cun novo proxecto de solución de Dataverse
Lista de solucións de PAC Lista de todas as solucións da organización actual de Dataverse
Solución PAC versión en liña Establece a versión para a solución cargada en Dataverse.
Paquete de solucións PAC Empaqueta os compoñentes da solución do sistema de ficheiros local en solution.zip (SolutionPackager).
Publicación de solucións PAC Publica todas as personalizacións
Sincronización de solucións PAC Sincroniza o proxecto actual da solución de Dataverse co estado actual da solución na organización.
Desempaquetado da solución PAC Extraer os compoñentes da solución do solution.zip ao sistema de ficheiros local (SolutionPackager).
Actualización da solución PAC Aplicar a actualización da solución
Versión da solución PAC Actualización da versión de compilación ou revisión da solución.

Licenza de engadido da solución PAC

Engade información de licenza e plan á solución.

Exemplo

Este exemplo móstrase como engadir información de licenza a unha solución.

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

Ficheiro de definición do plan

A continuación atoparás un exemplo do ficheiro de definición do plan:

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

Ficheiro de mapeo de planos

A continuación atoparás un exemplo do ficheiro de mapeo do 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 necesarios para a licenza de engadido da solución

--planDefinitionFile -pd

Ficheiro de definición do plan de licenza en formato CSV; Columnas esperadas: ID do servizo, Nome de visualización, URL de máis información.

--planMappingFile -pm

Ficheiro de mapeo do plan de licenza en formato CSV; Columnas esperadas: ID do servizo, Nome do compoñente

Referencia de engadido de solucións pac

Engade unha referencia do proxecto no directorio actual ao proxecto en 'path'

Exemplo

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

Parámetros necesarios para engadir a referencia da solución

--path -p

O camiño cara ao proxecto referenciado

pac solution add-solution-component

Engadir un ou máis compoñentes da solución á solución non xestionada de destino en Dataverse.

Exemplo

Este exemplo móstrase como engadir un compoñente de solución a unha solución. Neste caso, engadimos a táboa de contactos á solución SampleSolution. A táboa é o tipo de compoñente 1.

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

Parámetros requiridos para a solución add-solution-component

--component -c

O nome do esquema ou ID do compoñente que se vai engadir á solución de destino.

--componentType -ct

O valor que representa o compoñente da solución que está engadindo.

--solutionUniqueName -sn

Nome da solución.

Parámetros opcionais para a solución add-solution-component

--AddRequiredComponents -arc

Indica se outros compoñentes da solución requiridos polo compoñente da solución que está engadindo tamén deben engadirse á solución non xestionada.

Este parámetro non precisa de valor. É un cambio.

--async -a

Importa a solución de forma asíncrona.

Este parámetro non precisa de valor. É un cambio.

--environment -env

URL ou ID do entorno de destino.

Comprobación da solución PAC

Cargar un proxecto de solución Dataverse para executalo no servizo Power Apps Checker.

Exemplo

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

Parámetros opcionais para a comprobación da solución

--clearCache -cc

Limpa a caché de aplicación do comprobador de solucións, para o seu inquilino, de todos os rexistros que pertencen a resultados pasados para as súas solucións.

Este parámetro non precisa de valor. É un cambio.

--customEndpoint -ce

Especifique un URL personalizado como punto de conexión de Power Apps Checker.

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

--excludedFiles -ef

Excluír os ficheiros da análise. Pasar como valores separados por vírgulas

--geo -g

Que instancia xeográfica do servizo Power Apps Checker usar.

Utiliza un 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

Cartafol de saída

--path -p

Ruta onde existen un ou máis ficheiros de solución a comprobar. A ruta pode conter caracteres glob/wildcard.

--ruleLevelOverride -rl

Ruta a un ficheiro que conteña unha matriz JSON, regras e niveis a superar. Os valores aceptados para OverrideLevel son: Critical, High, Medium, Low, Informational. Exemplo: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]

--ruleSet -rs

Seleccione un conxunto de regras que se execute como parte desta compilación. Valores: Un Guid válido, "AppSource Certification", "Solution Checker" (predeterminado).

--saveResults -sav

Usa o ambiente actual para almacenar os resultados da análise de solucións que se poden ver na aplicación Solution Health Hub. Por defecto, este argumento está establecido como false.

Este parámetro non precisa de valor. É un cambio.

--solutionUrl -u

SAS Uri apunta a solution.zip a analizar

Clon de solución PAC

Crea un proxecto de solución baseado nunha solución existente na túa organización.

Exemplos

Os seguintes exemplos mostran o uso do pac solution clone comando.

Clon básico

Este exemplo clona a solución sampleSolution no directorio actual.

pac solution clone --name sampleSolution

Clonar con configuración de numeración xeral e automática incluída

Este exemplo clona a solución sampleSolution no directorio actual coa configuración de numeración xeral e automática incluída.

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

Parámetros necesarios para o clonamento da solución

--name -n

Nome da solución a exportar.

Parámetros opcionais para o clonamento da solución

--async -a

Exporta a solución de forma asíncrona.

Este parámetro non precisa de valor. É un cambio.

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

--include -i

Que configuración debe incluírse na solución que se está a exportar.

Use un ou máis destes valores separados por comas:

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

--localize -loc

Extraia ou combine todos os recursos de cadea en ficheiros .resx.

Este parámetro non precisa de valor. É un cambio.

--map -m

A ruta completa a un ficheiro xml de mapeo desde o que ler os cartafoles dos compoñentes para empaquetar.

--max-async-wait-time -wt

Tempo máximo de espera asíncrona en minutos. O valor predeterminado é de 60 minutos.

--outputDirectory -o

Cartafol de saída

--packagetype -p

Especifica o tipo de extracción da solución. Pode ser: "Non xestionado", "Xestionado" ou "Ambos". O valor predeterminado é: "Ambos".

--targetversion -v

Obsoleto: Este parámetro é ignorado.

Configuración de creación da solución pac

Crea un ficheiro de configuración a partir do zip da solución ou do cartafol de solucións.

Exemplo

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

Parámetros opcionais para a configuración de creación da solución

--settings-file -s

O ficheiro .json coa configuración de implementación para referencias de conexión e variables de ambiente.

--solution-folder -f

Ruta ao cartafol de solución local desempaquetado: a raíz do ficheiro « Outros/Solution.xml» ou un cartafol cun ficheiro .cdsproj.

--solution-zip -z

Camiño ao ficheiro zip da solución.

Eliminación da solución PAC

Eliminar unha solución de Dataverse no entorno actual.

Exemplo

pac solution delete --solution-name Samplesolution

Parámetros necesarios para eliminar a solución

--solution-name -sn

Nome da solución.

Parámetros opcionais para a eliminación da solución

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

Exportación de solucións PAC

Exportar unha solución desde Dataverse.

Exemplo

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

Parámetros necesarios para a exportación da solución

--name -n

Nome da solución a exportar.

Parámetros opcionais para a exportación da solución

--async -a

Exporta a solución de forma asíncrona.

Este parámetro non precisa de valor. É un cambio.

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

--include -i

Que configuración debe incluírse na solución que se está a exportar.

Use un ou máis destes valores separados por comas:

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

--managed -m

Se a solución debe ser exportada como solución xestionada.

Este parámetro non precisa de valor. É un cambio.

--max-async-wait-time -wt

Tempo máximo de espera asíncrona en minutos. O valor predeterminado é de 60 minutos.

--overwrite -ow

O ficheiro de solución exportado pode sobrescribir o ficheiro zip da solución no sistema de ficheiros local.

Este parámetro non precisa de valor. É un cambio.

--path -p

Ruta na que se escribe o ficheiro zip da solución exportada.

--targetversion -v

Obsoleto: Este parámetro é ignorado.

Importación de solucións PAC

Importa a solución a Dataverse.

Exemplo

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

Parámetros opcionais para a importación da solución

--activate-plugins -ap

Activar complementos e fluxos de traballo na solución.

Este parámetro non precisa de valor. É un cambio.

--async -a

Importa a solución de forma asíncrona.

Este parámetro non precisa de valor. É un cambio.

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

--force-overwrite -f

Forzar unha sobrescritura de personalizacións non xestionadas

Este parámetro non precisa de valor. É un cambio.

--import-as-holding -h

Importar a solución como solución de retención.

Este parámetro non precisa de valor. É un cambio.

--max-async-wait-time -wt

Tempo máximo de espera asíncrona en minutos. O valor predeterminado é de 60 minutos.

--path -p

Camiño ao ficheiro zip da solución. Se non se especifica, asume que o cartafol actual é un proxecto cdsproj.

--publish-changes -pc

Publica os teus cambios tras unha importación exitosa.

Este parámetro non precisa de valor. É un cambio.

--settings-file

O ficheiro .json coa configuración de implementación para referencias de conexión e variables de ambiente.

--skip-dependency-check -s

Saltar a comprobación de dependencias contra as dependencias marcadas como actualización do produto

Este parámetro non precisa de valor. É un cambio.

--skip-lower-version -slv

Saltar a importación da solución se hai a mesma versión ou unha versión superior na contorna actual.

Este parámetro non precisa de valor. É un cambio.

--stage-and-upgrade -up

Importar e actualizar a solución.

Este parámetro non precisa de valor. É un cambio.

Comentarios

Está conectado a un entorno usando o comando pac auth para usar pac solution import.

Importación de solucións PAC

Cando Path non se especifica o parámetro, asume que o cartafol actual é un proxecto cdsproj. Se a propiedade SolutionPackageType no ficheiro cdsproj está establecida en Both, a solución xestionada úsase por defecto.

PAC Solution Init

Inicializa un cartafol cun novo proxecto de solución de Dataverse

Exemplo

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

Parámetros necesarios para o inicio da solución

--publisher-name -pn

Nome do editor de solucións de Dataverse

Nota: Só se permiten caracteres dentro dos intervalos [A - Z], [a - z], [0 - 9] ou _. O primeiro carácter só pode estar nos rangos [A - Z], [a - z] ou _.

--publisher-prefix -pp

Valor do prefixo de personalización para o editor de solucións de Dataverse

Nota: O prefixo debe ter entre 2 e 8 caracteres, só pode consistir en alfanuméricos, debe comezar cunha letra e non pode comezar con 'mscrm'.

Parámetros opcionais para o inicio da solución

--outputDirectory -o

Cartafol de saída

Lista de solucións de PAC

Lista de todas as solucións da organización actual de Dataverse

Exemplo

pac solution list

Parámetros opcionais para a lista de solucións

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

--includeSystemSolutions

Inclúe solucións de sistema como as publicadas por Microsoft

Este parámetro non precisa de valor. É un cambio.

--json

Devolve a saída do comando como unha cadea con formato JSON.

Solución PAC versión en liña

Establece a versión para a solución cargada en Dataverse.

Exemplo

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

Parámetros necesarios para a versión en liña da solución

--solution-name -sn

Nome da solución.

--solution-version -sv

Especifica o número de versión da solución.

Parámetros opcionais para a versión en liña da solución

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

Paquete de solucións PAC

Empaqueta os compoñentes da solución do sistema de ficheiros local en solution.zip (SolutionPackager).

Exemplo

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

Parámetros necesarios para o paquete de solucións

--zipfile -z

O camiño completo ao ficheiro ZIP da solución

Parámetros opcionais para o paquete de solucións

--allowDelete -ad

Indica se poden ocorrer operacións de eliminación. O valor predeterminado é 'false'.

Este parámetro non precisa de valor. É un cambio.

--allowWrite -aw

Indica se poden ocorrer operacións de escritura. O valor predeterminado é 'false'.

Este parámetro non precisa de valor. É un cambio.

--clobber -c

Permite que os ficheiros marcados como de só lectura poidan ser borrados ou sobrescritos. O valor predeterminado é 'false'.

Este parámetro non precisa de valor. É un cambio.

--disablePluginRemap -dpm

Desactivouse o remapeo do nome de tipo completo do complemento. O valor predeterminado é 'false'.

Este parámetro non precisa de valor. É un cambio.

--errorlevel -e

Nivel mínimo de rexistro para a saída do rexistro [Verbose|Info|Aviso |Erro|Off]. O valor predeterminado é "Info".

--folder -f

O camiño ao cartafol raíz do sistema de ficheiros local. Ao desempaquetar ou extraer, isto está escrito a. Ao empaquetar isto léase.

--localize -loc

Extraia ou combine todos os recursos de cadea en ficheiros .resx.

Este parámetro non precisa de valor. É un cambio.

--log -l

O camiño ao ficheiro de rexistro.

--map -m

A ruta completa a un ficheiro xml de mapeo desde o que ler os cartafoles dos compoñentes para empaquetar.

--packagetype -p

Ao desempaquetar ou extraer, utilízase para especificar a dobre operación xestionada e non xestionada. Ao empaquetar, utilízase para especificar Xestionado ou Non xestionado a partir dun desempaquetado anterior "Ambos". Pode ser: "Non xestionado", "Xestionado" ou "Ambos". O valor predeterminado é "Non xestionado".

--singleComponent -sc

Realizar só a acción nun só tipo de compoñente [WebResource|Engadido|Fluxo de traballo |Ningunha]. O valor predeterminado é "Ningún".

--sourceLoc -src

Xera un ficheiro de recursos de modelo. Válido só no extracto. Os valores posibles son "auto" ou o código de idioma do idioma que desexa exportar. Pode usar os formatos de código de linguaxe LCID (Language Code Identifier) ou ISO (International Organization for Standardization). Cando está presente, isto extrae os recursos de cadea da localización dada como un .resx neutro. Se se especifica 'auto' ou só a forma longa ou curta do interruptor, utilízase a localización base para a solución.

--useLcid -lcid

Usar valores de identificador de código de linguaxe (LCID) (1033) en lugar de códigos da Organización Internacional de Normalización (ISO) (en-US) para os ficheiros de linguaxe.

Este parámetro non precisa de valor. É un cambio.

--useUnmanagedFileForMissingManaged -same

Use o mesmo ficheiro fonte XML cando se empaqueta para Xestionado e só se atopa o ficheiro XML non xestionado; Aplícase aos ficheiros AppModuleSiteMap, AppModuleMap e FormXml.

Este parámetro non precisa de valor. É un cambio.

Publicación de solucións PAC

Publica todas as personalizacións

Exemplo

pac solution publish

Parámetros opcionais para a publicación da solución

--async -a

Publica todas as personalizacións de forma asíncrona

Este parámetro non precisa de valor. É un cambio.

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

--max-async-wait-time -wt

Tempo máximo de espera asíncrona en minutos. O valor predeterminado é de 60 minutos.

Sincronización de solucións PAC

Sincroniza o proxecto actual da solución de Dataverse co estado actual da solución na organización.

Exemplos

Os seguintes exemplos mostran o uso do pac solution sync comando.

Sincronización básica

Este exemplo sincroniza a solución co directorio actual.

pac solution sync

Parámetros opcionais para a sincronización da solución

--async -a

Exporta a solución de forma asíncrona.

Este parámetro non precisa de valor. É un cambio.

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

--include -i

Que configuración debe incluírse na solución que se está a exportar.

Use un ou máis destes valores separados por comas:

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

--localize -loc

Extraia ou combine todos os recursos de cadea en ficheiros .resx.

Este parámetro non precisa de valor. É un cambio.

--map -m

A ruta completa a un ficheiro xml de mapeo desde o que ler os cartafoles dos compoñentes para empaquetar.

--max-async-wait-time -wt

Tempo máximo de espera asíncrona en minutos. O valor predeterminado é de 60 minutos.

--packagetype -p

Ao desempaquetar ou extraer, utilízase para especificar a dobre operación xestionada e non xestionada. Ao empaquetar, utilízase para especificar Xestionado ou Non xestionado a partir dun desempaquetado anterior "Ambos". Pode ser: "Non xestionado", "Xestionado" ou "Ambos". O valor predeterminado é: "Ambos".

--solution-folder -f

Ruta ao cartafol de solución local desempaquetado: a raíz do ficheiro « Outros/Solution.xml» ou un cartafol cun ficheiro .cdsproj.

Desempaquetado da solución PAC

Extraer os compoñentes da solución do solution.zip ao sistema de ficheiros local (SolutionPackager).

Exemplo

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

Parámetros necesarios para o desempaquetado da solución

--zipfile -z

O camiño completo ao ficheiro ZIP da solución

Parámetros opcionais para o desempaquetado da solución

--allowDelete -ad

Indica se poden ocorrer operacións de eliminación. O valor predeterminado é 'false'.

Este parámetro non precisa de valor. É un cambio.

--allowWrite -aw

Indica se poden ocorrer operacións de escritura. O valor predeterminado é 'false'.

Este parámetro non precisa de valor. É un cambio.

--clobber -c

Permite que os ficheiros marcados como de só lectura poidan ser borrados ou sobrescritos. O valor predeterminado é 'false'.

Este parámetro non precisa de valor. É un cambio.

--disablePluginRemap -dpm

Desactivouse o remapeo do nome de tipo completo do complemento. O valor predeterminado é 'false'.

Este parámetro non precisa de valor. É un cambio.

--errorlevel -e

Nivel mínimo de rexistro para a saída do rexistro [Verbose|Info|Aviso |Erro|Off]. O valor predeterminado é "Info".

--folder -f

O camiño ao cartafol raíz do sistema de ficheiros local. Ao desempaquetar ou extraer, isto está escrito a. Ao empaquetar isto léase.

--localize -loc

Extraia ou combine todos os recursos de cadea en ficheiros .resx.

Este parámetro non precisa de valor. É un cambio.

--log -l

O camiño ao ficheiro de rexistro.

--map -m

A ruta completa a un ficheiro xml de mapeo desde o que ler os cartafoles dos compoñentes para empaquetar.

--packagetype -p

Ao desempaquetar ou extraer, utilízase para especificar a dobre operación xestionada e non xestionada. Ao empaquetar, utilízase para especificar Xestionado ou Non xestionado a partir dun desempaquetado anterior "Ambos". Pode ser: "Non xestionado", "Xestionado" ou "Ambos". O valor predeterminado é "Non xestionado".

--singleComponent -sc

Realizar só a acción nun só tipo de compoñente [WebResource|Engadido|Fluxo de traballo |Ningunha]. O valor predeterminado é "Ningún".

--sourceLoc -src

Xera un ficheiro de recursos de modelo. Válido só no extracto. Os valores posibles son "auto" ou o código de idioma do idioma que desexa exportar. Pode usar os formatos de código de linguaxe LCID (Language Code Identifier) ou ISO (International Organization for Standardization). Cando está presente, isto extrae os recursos de cadea da localización dada como un .resx neutro. Se se especifica 'auto' ou só a forma longa ou curta do interruptor, utilízase a localización base para a solución.

--useLcid -lcid

Usar valores de identificador de código de linguaxe (LCID) (1033) en lugar de códigos da Organización Internacional de Normalización (ISO) (en-US) para os ficheiros de linguaxe.

Este parámetro non precisa de valor. É un cambio.

--useUnmanagedFileForMissingManaged -same

Use o mesmo ficheiro fonte XML cando se empaqueta para Xestionado e só se atopa o ficheiro XML non xestionado; Aplícase aos ficheiros AppModuleSiteMap, AppModuleMap e FormXml.

Este parámetro non precisa de valor. É un cambio.

Actualización da solución PAC

Aplicar a actualización da solución

Exemplo

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

Parámetros necesarios para a actualización da solución

--solution-name -sn

Nome da solución.

Parámetros opcionais para a actualización da solución

--async -a

Actualización da solución de forma asíncrona

Este parámetro non precisa de valor. É un cambio.

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

--max-async-wait-time -wt

Tempo máximo de espera asíncrona en minutos. O valor predeterminado é de 60 minutos.

Versión da solución PAC

Actualización da versión de compilación ou revisión da solución.

Exemplo

pac solution version --patchversion 2
pac solution version --strategy gittags

Parámetros opcionais para a versión da solución

--buildversion -bv

Versión para a solución.

Nota: O valor debe ser un número enteiro cun valor mínimo de 0.

--filename -fn

Nome do ficheiro CSV do rastrexador que se debe usar cando se usa o seguimento de ficheiros como estratexia. O valor predeterminado é "ControlsStateVersionInfo.csv".

--patchversion -pv

Obsoleto: Este parámetro é ignorado.

--revisionversion -rv

Versión de revisión da solución.

Nota: O valor debe ser un número enteiro cun valor mínimo de 0.

--solutionPath -sp

Ruta ao directorio de solucións de Dataverse ou Solution.xml ficheiro.

--strategy -s

Actualiza a versión de compilación do ficheiro «Solution.xml» usando a estratexia especificada. Se usa gittags, estableza o token de acceso persoal na seguinte variable de ambiente "PacCli.PAT"

Utiliza un destes valores:

  • None
  • GitTags
  • FileTracking
  • Solution

Diferenzas entre a clonación e a exportación da solución PAC

Hai situacións nas que non estás seguro de cando usar pac solution clone ou pac solution export mandar. Podes usar un dos comandos nos seguintes escenarios:

  • Utilízase pac solution clone cando necesites engadir novos compoñentes á solución.
  • Utilízase pac solution export cando queiras modificar o contido existente nun ficheiro de solución, pero sen engadir novos compoñentes á solución.

Clon de solución PAC

A solución exportada parece un proxecto de Visual Studio cando exporta a solución usando o pac solution clone comando. No canto de a .csproj (como en Visual Studio), verás un cdsproj ficheiro. O cdsproj ficheiro contén toda a información necesaria para construír o proxecto. A saída da compilación é un ficheiro zip da solución, que podes importar a diferentes ambientes.

Clon de solución Pac.

O desenvolvedor non ten que desempaquetar a solución clonada porque está renderizada nun formato desempaquetado dentro do cartafol src (fonte).

Solución Pac desempaquetado.

Agora, se quere asociar un complemento recentemente creado con esta solución, coa solución desempaquetada, pode usar o pac solution add-reference comando para actualizar o .cdsproj ficheiro para engadir o novo complemento. A continuación, podes construír o proxecto usando ou dotnet buildmsbuild.

Recoméndase facer unha restauración da construción antes de construír o proxecto. Unha restauración de compilación (dotnet build fai unha restauración primeiro automaticamente) restaurará as bibliotecas .NET necesarias para xerar unha solución empaquetada.

Exportación de solucións PAC

Cando exportas a solución usando pac solution export queres exportar a solución usando o portal maker e a saída resultante é un ficheiro zip da solución.

Exportación de solucións PAC.

Cando descomprima o ficheiro zip da solución (non recomendamos abrir o zip con ferramentas estándar e usar o comando apropiado desde a CLI). A estrutura de directorios resultante é semellante á estrutura de pac solution clone. A única diferenza é que non podes engadir referencias a esta solución desempaquetada, xa que non ten o ficheiro do .cdsproj proxecto.

Estrutura da solución de Pac.

Pode modificar o conxunto relevante de ficheiros que desexa actualizar e, a continuación, continuar co paquete de solucións, que xera de novo o ficheiro zip da solución para facilitar a importación da solución ao entorno de destino. O resultado da acción é un ficheiro zip da solución con contido actualizado e un selo de tempo actualizado.

Consulte tamén

Grupos de comandos da CLI de Microsoft Power Platform
Visión xeral da CLI de Microsoft Power Platform