pac package

Comandi per l'uso dei progetti di pacchetto Dataverse.

Commands

Command Description
pac package add-external-package Aggiunge un pacchetto esterno al sistema della soluzione Dataverse a un progetto Package Deployer Package.
pac package add-reference Aggiunge un riferimento al progetto di soluzione Dataverse
pac package add-solution Aggiunge un file di soluzione Dataverse predefinito a un progetto Package Deployer Package.
pac package deploy Distribuisce il pacchetto in Dataverse
pac package init Inizializza una directory con un nuovo progetto di pacchetto Dataverse
pac package show Mostra i dettagli del pacchetto Dataverse

pac package add-external-package

Aggiunge un pacchetto esterno al sistema della soluzione Dataverse a un progetto Package Deployer Package.

Parametri obbligatori per package add-external-package

--package-type -t

Tipo del pacchetto da aggiungere. Ad esempio: 'xpp' per i pacchetti FnO.

--path -p

Percorso del pacchetto esterno

Parametri facoltativi per package add-external-package

--import-order

Numero intero che indica l'ordine di inserire questo elemento nel file finale ImportConfig.xml in fase di compilazione. I numeri negativi vengono inseriti prima degli elementi esistenti. I numeri positivi vengono aggiunti dopo gli elementi esistenti.

--skip-validation -sv

Aggiunge l'elemento al file di progetto anche se il file non esiste o sembra non valido. Nota: l'uso di questo non influisce sulla convalida eseguita da MSBuild.

Questo parametro non richiede alcun valore. È un cambio.

pac package add-reference

Aggiunge un riferimento al progetto di soluzione Dataverse

Example

pac package add-reference --path c:\Users\Downloads\SampleSolution

Parametri obbligatori per package add-reference

--path -p

Percorso del progetto di soluzione Dataverse di riferimento

Parametri facoltativi per package add-reference

--dependency-overrides

Elenco delimitato da punto e virgola di sostituzioni. Questo valore esegue l'override di tutte le informazioni sulle dipendenze codificate nei metadati della soluzione. Ogni override deve essere nel formato : <uniquename>:<minVersion>:<maxVersion>. Dove minVersion e maxVersion sono facoltativi, ma devono essere nella sintassi del formato della versione .NET.

Nota: usare un elenco delimitato da punto e virgola di override delle dipendenze del formato <uniquename>:<minVersion:>maxVersion<>.

--import-mode

Specifica in modo esplicito la modalità richiesta durante l'importazione di questa soluzione.

Usare uno di questi valori:

  • sync
  • async

--import-order

Numero intero che indica l'ordine di inserire questo elemento nel file finale ImportConfig.xml in fase di compilazione. I numeri negativi vengono inseriti prima degli elementi esistenti. I numeri positivi vengono aggiunti dopo gli elementi esistenti.

--missing-dependency-behavior

Specifica il comportamento da importare quando manca una dipendenza di questa soluzione dall'ambiente di destinazione.

Usare uno di questi valori:

  • skip
  • fault

--overwrite-unmanaged-customizations

Indica in modo esplicito se sovrascrivere le personalizzazioni non gestite quando questa soluzione viene importata.

Usare uno di questi valori:

  • true
  • false

--publish-workflows-activate-plugins

Indica in modo esplicito se pubblicare i flussi di lavoro e attivare i plug-in quando questa soluzione viene importata.

Usare uno di questi valori:

  • true
  • false

pac package add-solution

Aggiunge un file di soluzione Dataverse predefinito a un progetto Package Deployer Package.

Parametri obbligatori per package add-solution

--path -p

Percorso del file della soluzione Dataverse. Il file deve essere un file ZIP compresso.

Parametri facoltativi per package add-solution

--dependency-overrides

Elenco delimitato da punto e virgola di sostituzioni. Questo valore esegue l'override di tutte le informazioni sulle dipendenze codificate nei metadati della soluzione. Ogni override deve essere nel formato : <uniquename>:<minVersion>:<maxVersion>. Dove minVersion e maxVersion sono facoltativi, ma devono essere nella sintassi del formato della versione .NET.

Nota: usare un elenco delimitato da punto e virgola di override delle dipendenze del formato <uniquename>:<minVersion:>maxVersion<>.

--import-mode

Specifica in modo esplicito la modalità richiesta durante l'importazione di questa soluzione.

Usare uno di questi valori:

  • sync
  • async

--import-order

Numero intero che indica l'ordine di inserire questo elemento nel file finale ImportConfig.xml in fase di compilazione. I numeri negativi vengono inseriti prima degli elementi esistenti. I numeri positivi vengono aggiunti dopo gli elementi esistenti.

--missing-dependency-behavior

Specifica il comportamento da importare quando manca una dipendenza di questa soluzione dall'ambiente di destinazione.

Usare uno di questi valori:

  • skip
  • fault

--overwrite-unmanaged-customizations

Indica in modo esplicito se sovrascrivere le personalizzazioni non gestite quando questa soluzione viene importata.

Usare uno di questi valori:

  • true
  • false

--publish-workflows-activate-plugins

Indica in modo esplicito se pubblicare i flussi di lavoro e attivare i plug-in quando questa soluzione viene importata.

Usare uno di questi valori:

  • true
  • false

--skip-validation -sv

Aggiunge l'elemento al file di progetto anche se il file non esiste o sembra non valido. Nota: l'uso di questo non influisce sulla convalida eseguita da MSBuild.

Questo parametro non richiede alcun valore. È un cambio.

pac package deploy

Distribuisce il pacchetto in Dataverse

Annotazioni

Questo comando è disponibile solo per la versione .NET Full Framework dell'interfaccia della riga di comando pac.

Example

pac package deploy --logFile c:\samplelogdata --package c:\samplepackage

Parametri facoltativi per package deploy

--argument-file -af

Percorso di un file JSON corrispondente al contratto IncrementalSyncParameters (o ModuleSyncParameters). Obbligatorio per --db-sync Incremental.

--build-type -bt

Modalità di applicazione del pacchetto. Valori consentiti: Full, Incremental, Delete. Impostazione predefinita: completa. Usato con --package-type erp.

--db-sync -ds

Modalità di sincronizzazione del database da eseguire dopo la distribuzione. Valori consentiti: None, Full, Module, Incremental. Impostazione predefinita: nessuna. Usato con --package-type erp.

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

--logConsole -c

Log di output nella console

Questo parametro non richiede alcun valore. È un cambio.

--logFile -lf

Percorso del file di log

--modules -m

Elenco delimitato da virgole di nomi di modulo da sincronizzare. Obbligatorio quando --db-sync è Module.

--outputDirectory -o

Solo in modalità soluzione: cartella radice contenente .erp/xpp.json. Di default si trova nella directory corrente. Quando --package viene omesso in --package-type erp, tutti i modelli elencati in .erp/xpp.json vengono distribuiti in ordine di dipendenza.

--package -p

Percorso di una DLL del pacchetto o di un file ZIP con un pacchetto.

--package-type -pt

Piattaforma di destinazione per la distribuzione. Valori consentiti: dataverse, erp. Impostazione predefinita: dataverse.

--release-type -rt

Classificazione dei pacchetti. Valori consentiti: Dev, Release. Impostazione predefinita: Sviluppo. I pacchetti di rilascio forzano una sincronizzazione completa del database nel server. Usato con --package-type erp.

--settings -s

Impostazioni del pacchetto di runtime passate al pacchetto in fase di distribuzione. Il formato della stringa deve essere key=value|key=value.

Nota: il formato della stringa deve essere key=value|key=value.

--solution -sz

Percorso del file della soluzione Dataverse. Il file deve essere un file ZIP o CAB compresso.

--solution-root -sr

Solo in modalità soluzione: cartella radice contenente .erp/xpp.json. Di default si trova nella directory corrente. Quando --package viene omesso in --package-type erp, tutti i modelli elencati in .erp/xpp.json vengono distribuiti in ordine di dipendenza.

--verbose -vdbg

Generare log dettagliati negli output del log.

Questo parametro non richiede alcun valore. È un cambio.

Osservazioni:

È possibile usare entrambi logFile i parametri e logConsole insieme oppure usare un parametro o l'altro.

pac package init

Inizializza una directory con un nuovo progetto di pacchetto Dataverse

Example

pac package init --outputdirectory c:\samplepackage

Parametri facoltativi per package init

--layer -l

Livello X++. Valori consentiti: USR, CUS, VAR, SL1, SL2, SL3, BUS, HFX, GLS, DIS, ISV. Impostazione predefinita: ISV.

--model -m

Nomi dei modelli X++ da scaffolding. Accetta un singolo nome o un elenco delimitato da virgole,ad esempio ModelA,ModelB. Obbligatorio quando --package-type è erp.

--outputDirectory -o

Directory di output

--package-name

Imposta il nome predefinito del pacchetto. Si applica alla generazione di ImportExtension.GetNameOfImport.

--package-type -pt

Tipo di progetto di pacchetto da eseguire per lo scaffolding. Valori consentiti: dataverse, erp. Impostazione predefinita: dataverse.

--publisher -pub

Publisher nome scritto nel descrittore del modello. Impostazione predefinita: Microsoft.

--source-root -sr

Percorso radice di origine (relativo alla directory di output) in cui verranno attivati i modelli. Impostazione predefinita: ./src.

pac package show

Mostra i dettagli del pacchetto Dataverse

Annotazioni

Questo comando è disponibile solo per la versione .NET Full Framework dell'interfaccia della riga di comando pac.

Example

pac package show c:\samplepackage.dll

Parametri obbligatori per package show

--package -p

Percorso di una DLL del pacchetto o di un file ZIP con un pacchetto.

Parametri facoltativi per package show

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

--logFile -lf

Percorso del file di log

--verbose -vdbg

Generare log dettagliati negli output del log.

Questo parametro non richiede alcun valore. È un cambio.

Vedere anche

Gruppi di comandi dell'interfaccia della riga di comando di Microsoft Power Platform
Panoramica dell'interfaccia della riga di comando di Microsoft Power Platform