pac solution
Commandes pour utiliser les projets de solution Dataverse
Commandes
| Command | Description |
|---|---|
| pac solution add-license | Ajoute des informations de licence et de plan à la solution. |
| pac solution add-reference | Ajoute une référence du projet contenu dans le répertoire actuel au projet dans « path » |
| pac solution add-solution-component | Ajoute un ou plusieurs composants de solution à la solution non gérée cible dans Dataverse. |
| pac solution check | Charger un projet de solution Dataverse pour l’exécuter sur le service Vérificateur Power Apps. |
| pac solution clone | Crée un projet de solution basé sur une solution existante dans votre organisation. |
| pac solution create-settings | Créez un fichier de paramètres à partir du fichier zip de la solution ou du dossier de la solution. |
| pac solution delete | Supprime une solution de Dataverse dans l’environnement actuel. |
| pac solution export | Exportez une solution à partir de Dataverse. |
| pac solution import | Importer la solution dans Dataverse. |
| pac solution init | Initialise un répertoire avec un nouveau projet de solution Dataverse |
| pac solution list | Répertorie toutes les solutions de l’organisation Dataverse actuelle |
| pac solution online-version | Définit la version de la solution chargée dans Dataverse. |
| pac solution pack | Mettre en package les composants de solution du système de fichiers local dans solution.zip (SolutionPackager). |
| pac solution publish | Publie toutes les personnalisations. |
| pac solution sync | Synchronise le projet de solution Dataverse actuel avec l’état actuel de la solution dans votre organisation. |
| pac solution unpack | Extraire les composants de solution de solution.zip dans le système de fichiers local (SolutionPackager). |
| pac solution upgrade | Appliquer la mise à niveau de la solution |
| pac solution version | Met à jour la version build ou revision de la solution. |
pac solution add-license
Ajoute des informations de licence et de plan à la solution.
Exemple
Cet exemple montre comment ajouter des informations de licence à une solution.
pac solution add-license --planDefinitionFile ../ISV_Plan_Definition.csv --planMappingFile ../ISV_Plan_Mapping.csv
Fichier de définition de plan
Vous trouverez ci-dessous un exemple de fichier de définition de 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
Fichier de mappage de plan
Vous trouverez ci-dessous un exemple de fichier de mappage de plan :
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
Paramètres obligatoires pour solution add-license
--planDefinitionFile -pd
Fichier de définition du plan de licence au format CSV ; colonnes attendues : ID de service, Nom d’affichage, URL d’informations supplémentaires.
--planMappingFile -pm
Fichier de mappage du plan de licence au format CSV ; colonnes attendues : ID de service, Nom du composant
pac solution add-reference
Ajoute une référence du projet contenu dans le répertoire actuel au projet dans « path »
Exemple
pac solution add-reference --path c:\Users\Downloads\SampleComponent
Paramètres obligatoires pour solution add-reference
--path -p
Chemin d’accès au projet référencé
pac solution add-solution-component
Ajoute un ou plusieurs composants de solution à la solution non gérée cible dans Dataverse.
Exemple
Cet exemple montre comment ajouter un composant de solution à une solution. Dans ce cas, nous ajoutons la table de contact à la solution SampleSolution. Une tables est un type de composant « 1 ».
pac solution add-solution-component --solutionUniqueName SampleSolution --component contact --componentType 1
Paramètres obligatoires pour solution add-solution-component
--component -c
Nom du schéma ou ID du composant à ajouter à la solution cible.
--componentType -ct
Valeur représentant le composant de solution que vous ajoutez.
--solutionUniqueName -sn
Nom de la solution.
Paramètres facultatifs pour solution add-solution-component
--AddRequiredComponents -arc
Indique si d’autres composants de solution requis par le composant que vous ajoutez doivent également être ajoutés à la solution non gérée.
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--environment -env
URL de l’environnement ou ID de l’environnement cible.
pac solution check
Charger un projet de solution Dataverse pour l’exécuter sur le service Vérificateur Power Apps.
Exemple
pac solution check --path c:\Users\Documents\Solution.zip --outputDirectory c:\samplepackage --geo UnitedStates
Paramètres facultatifs pour solution check
--customEndpoint -ce
Spécifie une URL personnalisée en tant que point de terminaison du vérificateur Power Apps.
--environment -env
Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.
--excludedFiles -ef
Excluez les fichiers de l’analyse. Passer en tant que valeurs séparées par des virgules
--geo -g
Instance géographique du service Vérificateur Power Apps à utiliser.
Utilisez l’une de ces valeurs :
PreviewUnitedStatesUnitedStatesEuropeAsiaAustraliaJapanIndiaCanadaSouthAmericaUnitedKingdomFranceSouthAfricaGermanyUnitedArabEmiratesSwitzerlandNorwaySingaporeKoreaUSGovernmentUSGovernmentL4USGovernmentL5DoDChina
--outputDirectory -o
Répertoire de sortie
--path -p
Chemin d’accès d’un ou de plusieurs fichiers de solution à vérifier. Le chemin d’accès peut contenir des caractères glob/génériques.
--ruleLevelOverride -rl
Chemin d’accès à un fichier contenant des règles et des niveaux de tableau JSON à remplacer. Les valeurs acceptées pour OverrideLevel sont : Critical, High, Medium, Low, Informational. Exemple : [{« Id »:« meta-remove-dup-reg »,« OverrideLevel »:« Moyen »},{« Id »:« il-evid-specialized-update-ops »,« OverrideLevel »:« Moyen »}]
--ruleSet -rs
Sélectionnez un ensemble de règles qui est exécuté dans le cadre de cette build. Valeurs : un Guid valide, « AppSource Certification », « Solution Checker » (par défaut).
--saveResults -sav
Utilise l’environnement actuel pour stocker les résultats d’analyse de la solution qui sont disponibles dans l’application Centre d’intégrité de la solution. Par défaut, cet argument est défini sur false.
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--solutionUrl -u
URI SAS qui pointe vers le fichier solution.zip à analyser
pac solution clone
Crée un projet de solution basé sur une solution existante dans votre organisation.
Examples
Les exemples suivants illustrent l’utilisation de la commande pac solution clone.
- Clone de base
- Cloner avec les paramètres généraux et de numérotation automatique inclus
- Cloner avec l’application canevas décompressée
Clone de base
Cet exemple clone la solution sampleSolution dans le répertoire courant.
pac solution clone --name sampleSolution
Cloner avec les paramètres généraux et de numérotation automatique inclus
Cet exemple clone la solution sampleSolution dans le répertoire courant avec les paramètres généraux et de numérotation automatique inclus.
pac solution clone --name sampleSolution --include general,autonumbering
Cloner avec l’application canevas décompressée
Cet exemple clone la solution sampleSolution et décompresse les applications canevas en une seule fois.
pac solution clone --name sampleSolution --processCanvasApps
Paramètres obligatoires pour solution clone
--name -n
Nom de la solution à exporter.
Paramètres facultatifs pour solution clone
--async -a
Exporte la solution de manière asynchrone.
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--environment -env
Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.
--include -i
Indique les paramètres à inclure dans la solution exportée.
Utilisez une ou plusieurs de ces valeurs séparées par des virgules :
autonumberingcalendarcustomizationemailtrackingexternalapplicationsgeneralisvconfigmarketingoutlooksynchronizationrelationshiprolessales
--localize -loc
Extrayez ou fusionnez toutes les ressources de chaînes dans les fichiers .resx.
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--max-async-wait-time -wt
Temps d’attente asynchrone maximal en minutes. La valeur par défaut est de 60 minutes.
--outputDirectory -o
Répertoire de sortie
--packagetype -p
Spécifie le type d’extraction pour la solution. Peut être : « Unmanaged », « Managed » ou « Both ». La valeur par défaut est « Both ».
--processCanvasApps -pca
(Version préliminaire) Compresser/décompresser les applications canevas (.msapp) lors du traitement de la solution. La valeur par défaut est « false ».
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--targetversion -v
Obsolète : ce paramètre est ignoré.
pac solution create-settings
Créez un fichier de paramètres à partir du fichier zip de la solution ou du dossier de la solution.
Exemple
pac solution create-settings --solution-zip C:\SampleSolution.zip --settings-file .\SampleDeploymentSettingsDev.json
Paramètres facultatifs pour solution create-settings
--settings-file -s
Fichier .json avec les paramètres de déploiement pour les références de connexion et les variables d’environnement.
--solution-folder -f
Chemin d’accès au dossier de solution local décompressé : la racine du fichier « Other/Solution.xml » ou un dossier avec un fichier .cdsproj.
--solution-zip -z
Chemin d’accès au fichier zip de la solution.
pac solution delete
Supprime une solution de Dataverse dans l’environnement actuel.
Exemple
pac solution delete --solution-name Samplesolution
Paramètres obligatoires pour solution delete
--solution-name -sn
Nom de la solution.
Paramètres facultatifs pour solution delete
--environment -env
Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.
pac solution export
Exportez une solution à partir de Dataverse.
Exemple
pac solution export --path c:\Users\Documents\Solution.zip --name SampleComponentSolution --managed true --include general
Paramètres obligatoires pour solution export
--name -n
Nom de la solution à exporter.
Paramètres facultatifs pour solution export
--async -a
Exporte la solution de manière asynchrone.
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--environment -env
Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.
--include -i
Indique les paramètres à inclure dans la solution exportée.
Utilisez une ou plusieurs de ces valeurs séparées par des virgules :
autonumberingcalendarcustomizationemailtrackingexternalapplicationsgeneralisvconfigmarketingoutlooksynchronizationrelationshiprolessales
--managed -m
Indique si la solution doit être exportée comme solution gérée.
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--max-async-wait-time -wt
Temps d’attente asynchrone maximal en minutes. La valeur par défaut est de 60 minutes.
--overwrite -ow
Le fichier exporté de la solution peut remplacer le fichier zip de la solution sur le système de fichiers local.
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--path -p
Chemin d’accès du fichier zip de la solution exportée.
--targetversion -v
Obsolète : ce paramètre est ignoré.
pac solution import
Importer la solution dans Dataverse.
Exemple
pac solution import --path c:\Users\Documents\Solution.zip
Paramètres facultatifs pour solution import
--activate-plugins -ap
Active les plug-ins et les workflows sur la solution.
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--async -a
Importe la solution de manière asynchrone.
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--convert-to-managed -cm
Convertit en solution gérée.
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--environment -env
Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.
--force-overwrite -f
Forcer le remplacement des personnalisations non gérées
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--import-as-holding -h
Importe la solution comme solution de maintien.
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--max-async-wait-time -wt
Temps d’attente asynchrone maximal en minutes. La valeur par défaut est de 60 minutes.
--path -p
Chemin d’accès au fichier zip de la solution. S’il n’est pas spécifié, on suppose que le dossier actuel est un projet cdsproj.
--publish-changes -pc
Publie vos modifications en cas d’importation réussie.
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--settings-file
Fichier .json avec les paramètres de déploiement pour les références de connexion et les variables d’environnement.
--skip-dependency-check -s
Ignorer la vérification de dépendance sur les dépendances signalées comme mise à jour du produit
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--skip-lower-version -slv
Ignore l’importation de solution si une version identique ou supérieure est présente dans l’environnement actuel.
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--stage-and-upgrade -up
Importez et mettez à niveau la solution.
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
Remarques
Vous devez être connecté à un environnement utilisant la commande pac auth pour utiliser pac solution import.
convertir à géré
Le paramètre convert-to-managed n’accepte pas une solution non gérée ni ne l’importe comme une solution gérée. Ce paramètre permet à une solution gérée importée dans un environnement de convertir des composants non gérés en composants gérés.
Si cet indicateur n’est pas explicitement défini, le système de solution fera échouer la demande d’importation, car les couches gérées ne peuvent pas être au-dessus de composants de base non gérés. Ce changement permet à l’importation de la solution de réussir et le résultat net est que le solution gérée entrante sera la couche de base pour chacun de ces composants. Les composants de l’environnement de destination sont convertis de composant non géré en composant géré.
pac solution init
Initialise un répertoire avec un nouveau projet de solution Dataverse
Exemple
pac solution init --publisher-name developer --publisher-prefix dev
Paramètres obligatoires pour solution init
--publisher-name -pn
Nom de l’éditeur de solutions Dataverse
Remarque : seuls les caractères des plages [A - Z], [a - z], [0 - 9] ou _ sont autorisés. Le premier caractère ne peut être que dans les plages [A - Z], [a - z] ou _.
--publisher-prefix -pp
Valeur du préfixe de personnalisation pour l’éditeur de solutions Dataverse
Remarque : le préfixe doit comporter entre 2 et 8 caractères, ne peut contenir que des caractères alphanumériques, doit commencer par une lettre et ne peut pas commencer par « mscrm ».
Paramètres facultatifs pour solution init
--outputDirectory -o
Répertoire de sortie
pac solution list
Répertorie toutes les solutions de l’organisation Dataverse actuelle
Exemple
pac solution list
Paramètres facultatifs pour solution list
--environment -env
Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.
--json
Renvoie la sortie de la commande sous la forme d’une chaîne au format JSON.
pac solution online-version
Définit la version de la solution chargée dans Dataverse.
Exemple
pac solution online-version --solution-name Samplesolution --solution-version 1.0.0.2
Paramètres obligatoires pour solution online-version
--solution-name -sn
Nom de la solution.
--solution-version -sv
Spécifiez le numéro de version de la solution.
Paramètres facultatifs pour solution online-version
--environment -env
Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.
pac solution pack
Mettre en package les composants de solution du système de fichiers local dans solution.zip (SolutionPackager).
Exemple
pac solution pack --zipfile C:\SampleSolution.zip --folder .\SampleSolutionUnpacked\.
Paramètres obligatoires pour solution pack
--zipfile -z
Chemin d’accès complet au fichier ZIP de la solution
Paramètres facultatifs pour solution pack
--allowDelete -ad
Indique si les opérations de suppression peuvent se produire. La valeur par défaut est « false ».
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--allowWrite -aw
Indique si les opérations d’écriture peuvent se produire. La valeur par défaut est « false ».
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--clobber -c
Permet de supprimer ou de remplacer les fichiers marqués en lecture seule. La valeur par défaut est « false ».
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--disablePluginRemap -dpm
Nouveau mappage du nom de type complet du plug-in désactivé. La valeur par défaut est « false ».
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--errorlevel -e
Niveau de journalisation minimal pour la sortie de journal [Verbose|Info|Warning|Error|Off]. La valeur par défaut est « Info ».
--folder -f
Chemin d’accès au dossier racine sur le système de fichiers local. Lors de la décompression ou de l’extraction, le contenu est écrit dans ce chemin d’accès. Lors de la compression, le contenu est lu depuis ce chemin d’accès.
--localize -loc
Extrayez ou fusionnez toutes les ressources de chaînes dans les fichiers .resx.
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--log -l
Chemin d’accès au fichier journal.
--map -m
Chemin d’accès complet à un fichier xml de mappage à partir duquel lire les dossiers de composants à compresser.
--packagetype -p
Lors de la décompression ou de l’extraction, permet de spécifier l’opération double Managed et Unmanaged Lors de la compression, permet de spécifier Managed ou Unmanaged à partir d’une précédente décompression « Both ». Peut être : « Unmanaged », « Managed » ou « Both ». La valeur par défaut est « Unmanaged ».
--processCanvasApps -pca
(Version préliminaire) Compresser/décompresser les applications canevas (.msapp) lors du traitement de la solution. La valeur par défaut est « false ».
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--singleComponent -sc
N’effectuez l’action que sur un type de composant unique [WebResource|Plugin|Workflow|None]. La valeur par défaut est « None ».
--sourceLoc -src
Génère un fichier de ressources modèle. Valide uniquement pour l’extraction. Les valeurs possibles sont « auto » ou le code de langue de la langue que vous souhaitez exporter. Vous pouvez utiliser l’Identificateur de code de langue (LCID) ou les formats de code de langue de l’Organisation internationale de normalisation (ISO). Si ce paramètre est présent, les ressources de chaînes sont extraites des paramètres régionaux donnés en tant que fichier .resx neutre. Si « auto » ou la forme longue ou courte du commutateur est spécifié, les paramètres régionaux de base de la solution sont utilisés.
--useLcid -lcid
Utilise les valeurs de l’Identificateur de code de langue (LCID) (1033) plutôt que les codes de l’Organisation internationale pour la normalisation (ISO) (en-US) pour les fichiers de langue.
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--useUnmanagedFileForMissingManaged -same
Utilisez le même fichier source XML lorsqu’un package pour Managed et uniquement un fichier XML Unmanaged est disponible ; s’applique aux fichiers AppModuleSiteMap, AppModuleMap et FormXml.
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
pac solution publish
Publie toutes les personnalisations.
Exemple
pac solution publish
Paramètres facultatifs pour solution publish
--async -a
Publie toutes les personnalisations de manière asynchrone
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--environment -env
Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.
--max-async-wait-time -wt
Temps d’attente asynchrone maximal en minutes. La valeur par défaut est de 60 minutes.
pac solution sync
Synchronise le projet de solution Dataverse actuel avec l’état actuel de la solution dans votre organisation.
Examples
Les exemples suivants illustrent l’utilisation de la commande pac solution sync.
Synchronisation de base
Cet exemple synchronise la solution dans le répertoire courant.
pac solution sync
Synchroniser avec l’application canevas décompressée
Cet exemple synchronise la solution avec le répertoire actuel et décompresse les applications canevas en une seule fois.
pac solution sync --processCanvasApps
Paramètres facultatifs pour solution sync
--async -a
Exporte la solution de manière asynchrone.
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--environment -env
Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.
--include -i
Indique les paramètres à inclure dans la solution exportée.
Utilisez une ou plusieurs de ces valeurs séparées par des virgules :
autonumberingcalendarcustomizationemailtrackingexternalapplicationsgeneralisvconfigmarketingoutlooksynchronizationrelationshiprolessales
--localize -loc
Extrayez ou fusionnez toutes les ressources de chaînes dans les fichiers .resx.
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--max-async-wait-time -wt
Temps d’attente asynchrone maximal en minutes. La valeur par défaut est de 60 minutes.
--packagetype -p
Lors de la décompression ou de l’extraction, permet de spécifier l’opération double Managed et Unmanaged Lors de la compression, permet de spécifier Managed ou Unmanaged à partir d’une précédente décompression « Both ». Peut être : « Unmanaged », « Managed » ou « Both ». La valeur par défaut est « Both ».
--processCanvasApps -pca
(Version préliminaire) Compresser/décompresser les applications canevas (.msapp) lors du traitement de la solution. La valeur par défaut est « false ».
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--solution-folder -f
Chemin d’accès au dossier de solution local décompressé : la racine du fichier « Other/Solution.xml » ou un dossier avec un fichier .cdsproj.
pac solution unpack
Extraire les composants de solution de solution.zip dans le système de fichiers local (SolutionPackager).
Exemple
pac solution unpack --zipfile C:\SampleSolution.zip --folder .\SampleSolutionUnpacked\.
Paramètres obligatoires pour solution unpack
--zipfile -z
Chemin d’accès complet au fichier ZIP de la solution
Paramètres facultatifs pour solution unpack
--allowDelete -ad
Indique si les opérations de suppression peuvent se produire. La valeur par défaut est « false ».
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--allowWrite -aw
Indique si les opérations d’écriture peuvent se produire. La valeur par défaut est « false ».
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--clobber -c
Permet de supprimer ou de remplacer les fichiers marqués en lecture seule. La valeur par défaut est « false ».
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--disablePluginRemap -dpm
Nouveau mappage du nom de type complet du plug-in désactivé. La valeur par défaut est « false ».
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--errorlevel -e
Niveau de journalisation minimal pour la sortie de journal [Verbose|Info|Warning|Error|Off]. La valeur par défaut est « Info ».
--folder -f
Chemin d’accès au dossier racine sur le système de fichiers local. Lors de la décompression ou de l’extraction, le contenu est écrit dans ce chemin d’accès. Lors de la compression, le contenu est lu depuis ce chemin d’accès.
--localize -loc
Extrayez ou fusionnez toutes les ressources de chaînes dans les fichiers .resx.
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--log -l
Chemin d’accès au fichier journal.
--map -m
Chemin d’accès complet à un fichier xml de mappage à partir duquel lire les dossiers de composants à compresser.
--packagetype -p
Lors de la décompression ou de l’extraction, permet de spécifier l’opération double Managed et Unmanaged Lors de la compression, permet de spécifier Managed ou Unmanaged à partir d’une précédente décompression « Both ». Peut être : « Unmanaged », « Managed » ou « Both ». La valeur par défaut est « Unmanaged ».
--processCanvasApps -pca
(Version préliminaire) Compresser/décompresser les applications canevas (.msapp) lors du traitement de la solution. La valeur par défaut est « false ».
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--singleComponent -sc
N’effectuez l’action que sur un type de composant unique [WebResource|Plugin|Workflow|None]. La valeur par défaut est « None ».
--sourceLoc -src
Génère un fichier de ressources modèle. Valide uniquement pour l’extraction. Les valeurs possibles sont « auto » ou le code de langue de la langue que vous souhaitez exporter. Vous pouvez utiliser l’Identificateur de code de langue (LCID) ou les formats de code de langue de l’Organisation internationale de normalisation (ISO). Si ce paramètre est présent, les ressources de chaînes sont extraites des paramètres régionaux donnés en tant que fichier .resx neutre. Si « auto » ou la forme longue ou courte du commutateur est spécifié, les paramètres régionaux de base de la solution sont utilisés.
--useLcid -lcid
Utilise les valeurs de l’Identificateur de code de langue (LCID) (1033) plutôt que les codes de l’Organisation internationale pour la normalisation (ISO) (en-US) pour les fichiers de langue.
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--useUnmanagedFileForMissingManaged -same
Utilisez le même fichier source XML lorsqu’un package pour Managed et uniquement un fichier XML Unmanaged est disponible ; s’applique aux fichiers AppModuleSiteMap, AppModuleMap et FormXml.
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
pac solution upgrade
Appliquer la mise à niveau de la solution
Exemple
pac solution upgrade --solution-name SampleSolution --async --max-async-wait-time 60
Paramètres obligatoires pour solution upgrade
--solution-name -sn
Nom de la solution.
Paramètres facultatifs pour solution upgrade
--async -a
Met à niveau la solution de manière asynchrone
Ce paramètre ne requiert aucune valeur. C’est un commutateur.
--environment -env
Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.
--max-async-wait-time -wt
Temps d’attente asynchrone maximal en minutes. La valeur par défaut est de 60 minutes.
pac solution version
Met à jour la version build ou revision de la solution.
Exemple
pac solution version --patchversion 2
pac solution version --strategy gittags
Paramètres facultatifs pour solution version
--buildversion -bv
Version build de la solution.
Remarque : la valeur doit être un entier avec une valeur minimale de 0.
--filename -fn
Nom du fichier de suivi CSV à utiliser lors de l’utilisation de FileTracking comme stratégie. La valeur par défaut est « ControlsStateVersionInfo.csv ».
--patchversion -pv
Obsolète : ce paramètre est ignoré.
--revisionversion -rv
Version revision de la solution.
Remarque : la valeur doit être un entier avec une valeur minimale de 0.
--solutionPath -sp
Chemin d’accès au répertoire de la solution Dataverse ou au fichier Solution.xml.
--strategy -s
Met à jour la version de la build pour le fichier ’Solution.xml’ à l’aide des valeurs de stratégie spécifiées. Si vous utilisez des gittags, définissez le token personnel dans la variable d’environnement suivante "PacCli.PAT"
Utilisez l’une de ces valeurs :
NoneGitTagsFileTrackingSolution
Différences entre le clonage et l’exportation de la solution pac
Il y a des cas où vous ne savez pas quand utiliser la commande pac solution clone ou la commande pac solution export. Utilisez l’une des commandes dans les scénarios suivants :
- Utilisez la commande
pac solution clonesi vous devez ajouter de nouveaux composants à la solution. - Utilisez la commande
pac solution exportsi vous souhaitez modifier le contenu existant dans un fichier de solution sans ajouter de nouveaux composants à la solution.
pac solution clone
La solution exportée ressemble à un projet Visual Studio lorsque vous exportez la solution à l’aide de la commande pac solution clone. En remplacement d’un fichier .csproj (comme dans Visual Studio), vous affichez un fichier cdsproj. Le fichier cdsproj contient toutes les informations sur les composants nécessaires à la création du projet. La sortie de version est un fichier zip de solution que vous pouvez importer dans différents environnements.
Le développeur n’a pas besoin de décompresser la solution clonée, car elle s’affiche dans un format décompressé dans le dossier src (source).
Pour associer un plug-in nouvellement créé à cette solution, avec la solution décompressée, utilisez la commande pac solution add-reference pour mettre à jour le fichier .cdsproj et ajouter le nouveau plug-in. Vous pouvez ensuite construire le projet en utilisant soit dotnet build, soit msbuild.
Il est recommandé d’effectuer une restauration de build avant de générer le projet. Une restauration de version (la version dotnet commence par effectuer automatiquement une restauration) restaure les bibliothèques .NET requises pour générer une solution compressée.
pac solution export
Si vous exportez la solution en utilisant pac solution export, vous avez envie d’exporter la solution à l’aide du portail des créateurs et la sortie résultante est un fichier zip de solution.
Lorsque vous décompressez le fichier zip de la solution (nous vous déconseillons d’ouvrir le zip avec des outils standard et d’utiliser la commande appropriée de la CLI). La structure de répertoire résultante est similaire à la structure dans pac solution clone. La seule différence est que vous ne pouvez pas ajouter de références à cette solution décompressée, car elle n’a pas le dossier de projet .cdsproj.
Vous pouvez modifier l’ensemble de fichiers que vous souhaitez mettre à jour, puis continuer avec le pack de solution, ce qui génère à nouveau le fichier zip de solution pour faciliter l’importation de la solution dans l’environnement cible. Le résultat de l’action est un fichier zip de solution avec un contenu mis à jour et un horodatage mis à jour.
Voir aussi
Groupes de commandes Microsoft Power Platform CLI
Microsoft Power PlatformVue d’ensemble d’un processus CLI