pac package

Polecenia do pracy z projektami pakietu Dataverse.

Commands

Command	Description
pac package add-external-package	Dodaje pakiet zewnętrzny do systemu rozwiązania Dataverse w projekcie Package Deployer Package.
pac package add-reference	Dodaje odwołanie do projektu rozwiązania Dataverse
pac package add-solution	Dodaje wstępnie utworzony plik rozwiązania Dataverse do projektu Package Deployer Package.
pac package deploy	Wdraża pakiet w usłudze Dataverse
pac package init	Inicjuje katalog przy użyciu nowego projektu pakietu Dataverse
pac package show	Pokazuje szczegóły pakietu Dataverse

pac package add-external-package

Dodaje pakiet zewnętrzny do systemu rozwiązania Dataverse w projekcie Package Deployer Package.

Wymagane parametry dla package add-external-package

--package-type -t

Typ dodawanego pakietu. Na przykład: "xpp" dla pakietów FnO.

--path -p

Ścieżka do pakietu zewnętrznego

Parametry opcjonalne dla package add-external-package

--import-order

Liczba całkowita wskazująca kolejność wstawiania tego elementu do końcowego pliku ImportConfig.xml w czasie kompilacji. Liczby ujemne są wstawiane przed istniejącymi elementami. Liczby dodatnie są dodawane po istniejących elementach.

--skip-validation -sv

Dodaje element do pliku projektu, nawet jeśli plik nie istnieje lub wydaje się być nieprawidłowy. Uwaga: użycie tej metody nie ma wpływu na walidację wykonywaną przez program MSBuild.

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

pac package add-reference

Dodaje odwołanie do projektu rozwiązania Dataverse

Example

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

Wymagane parametry dla package add-reference

--path -p

Ścieżka do przywoływnego projektu rozwiązania Dataverse

Parametry opcjonalne dla package add-reference

--dependency-overrides

Rozdzielana średnikami lista przesłonięć. Ta wartość zastępuje wszelkie informacje o zależnościach zakodowane w metadanych rozwiązania. Każde zastąpienie powinno mieć format: <uniquename>:<minVersion>:<maxVersion>. Gdzie parametr minVersion i maxVersion są opcjonalne, ale powinny być w składni formatu wersji platformy .NET.

Uwaga: Użyj rozdzielanej średnikami listy przesłonięć zależności w formacie <uniquename>:minVersion:<>maxVersion<>.

--import-mode

Jawnie określa wymagany tryb podczas importowania tego rozwiązania.

Użyj jednej z następujących wartości:

• sync
• async

--import-order

Liczba całkowita wskazująca kolejność wstawiania tego elementu do końcowego pliku ImportConfig.xml w czasie kompilacji. Liczby ujemne są wstawiane przed istniejącymi elementami. Liczby dodatnie są dodawane po istniejących elementach.

--missing-dependency-behavior

Określa zachowanie podczas importowania, gdy w środowisku docelowym brakuje zależności tego rozwiązania.

Użyj jednej z następujących wartości:

• skip
• fault

--overwrite-unmanaged-customizations

Jawnie wskazuje, czy zastąpić niezarządzane dostosowania podczas importowania tego rozwiązania.

Użyj jednej z następujących wartości:

• true
• false

--publish-workflows-activate-plugins

Jawnie wskazuje, czy należy opublikować przepływy pracy i aktywować wtyczki podczas importowania tego rozwiązania.

Użyj jednej z następujących wartości:

• true
• false

pac package add-solution

Dodaje wstępnie utworzony plik rozwiązania Dataverse do projektu Package Deployer Package.

Wymagane parametry dla package add-solution

--path -p

Ścieżka do pliku rozwiązania Dataverse. Plik musi być skompresowanym plikiem ZIP.

Parametry opcjonalne dla package add-solution

--dependency-overrides

Rozdzielana średnikami lista przesłonięć. Ta wartość zastępuje wszelkie informacje o zależnościach zakodowane w metadanych rozwiązania. Każde zastąpienie powinno mieć format: <uniquename>:<minVersion>:<maxVersion>. Gdzie parametr minVersion i maxVersion są opcjonalne, ale powinny być w składni formatu wersji platformy .NET.

Uwaga: Użyj rozdzielanej średnikami listy przesłonięć zależności w formacie <uniquename>:minVersion:<>maxVersion<>.

--import-mode

Jawnie określa wymagany tryb podczas importowania tego rozwiązania.

Użyj jednej z następujących wartości:

• sync
• async

--import-order

Liczba całkowita wskazująca kolejność wstawiania tego elementu do końcowego pliku ImportConfig.xml w czasie kompilacji. Liczby ujemne są wstawiane przed istniejącymi elementami. Liczby dodatnie są dodawane po istniejących elementach.

--missing-dependency-behavior

Określa zachowanie podczas importowania, gdy w środowisku docelowym brakuje zależności tego rozwiązania.

Użyj jednej z następujących wartości:

• skip
• fault

--overwrite-unmanaged-customizations

Jawnie wskazuje, czy zastąpić niezarządzane dostosowania podczas importowania tego rozwiązania.

Użyj jednej z następujących wartości:

• true
• false

--publish-workflows-activate-plugins

Jawnie wskazuje, czy należy opublikować przepływy pracy i aktywować wtyczki podczas importowania tego rozwiązania.

Użyj jednej z następujących wartości:

• true
• false

--skip-validation -sv

Dodaje element do pliku projektu, nawet jeśli plik nie istnieje lub wydaje się być nieprawidłowy. Uwaga: użycie tej metody nie ma wpływu na walidację wykonywaną przez program MSBuild.

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

pac package deploy

Wdraża pakiet w usłudze Dataverse

Uwaga / Notatka

To polecenie jest dostępne tylko dla wersji platformy .NET Full Framework interfejsu wiersza polecenia PAC.

Example

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

Parametry opcjonalne dla package deploy

--argument-file -af

Ścieżka do pliku JSON zgodnego z kontraktem IncrementalSyncParameters (lub ModuleSyncParameters). Wymagane dla przyrostowego elementu --db-sync.

--build-type -bt

Sposób stosowania pakietu. Dozwolone wartości: Pełne, Przyrostowe, Usuń. Ustawienie domyślne: Pełne. Używany z --package-type erp.

--db-sync -ds

Tryb synchronizacji bazy danych do uruchomienia po wdrożeniu. Dozwolone wartości: Brak, Pełny, Moduł, Przyrostowy. Ustawienie domyślne: Brak. Używany z --package-type erp.

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

--logConsole -c

Dziennik wyjściowy do konsoli

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

--logFile -lf

Ścieżka pliku dziennika

--modules -m

Rozdzielona przecinkami lista nazw modułów do synchronizacji. Wymagane, gdy --db-sync jest modułem.

--outputDirectory -o

Tylko tryb rozwiązania: folder główny zawierający plik erp/xpp.json. Domyślnie jest to aktualny katalog. Gdy parametr --package zostanie pominięty w obszarze --package-type erp, wszystkie modele wymienione w pliku .erp/xpp.json są wdrażane w kolejności zależności.

--package -p

Ścieżka do pliku dll pakietu lub pliku zip z pakietem.

--package-type -pt

Platforma docelowa do wdrożenia. Dozwolone wartości: dataverse, erp. Ustawienie domyślne: dataverse.

--release-type -rt

Klasyfikacja pakietów. Dozwolone wartości: Dev, Release. Ustawienie domyślne: Dev. Pakiety wydań wymuszają pełną synchronizację bazy danych na serwerze. Używany z --package-type erp.

--settings -s

Ustawienia pakietu środowiska uruchomieniowego przekazywane do wdrażanego pakietu. Format ciągu musi mieć wartość key=value|key=value.

Uwaga: format ciągu musi mieć wartość key=value|key=value.

--solution -sz

Ścieżka do pliku rozwiązania Dataverse. Plik musi być skompresowanym plikiem ZIP lub CAB.

--solution-root -sr

Tylko tryb rozwiązania: folder główny zawierający plik erp/xpp.json. Domyślnie jest to aktualny katalog. Gdy parametr --package zostanie pominięty w obszarze --package-type erp, wszystkie modele wymienione w pliku .erp/xpp.json są wdrażane w kolejności zależności.

--verbose -vdbg

Emituj pełne dzienniki do danych wyjściowych dziennika.

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

Uwagi

Można użyć obu logFile parametrów i logConsole razem albo użyć jednego parametru lub drugiego.

pac package init

Inicjuje katalog przy użyciu nowego projektu pakietu Dataverse

Example

pac package init --outputdirectory c:\samplepackage

Parametry opcjonalne dla package init

--layer -l

Warstwa X++. Dozwolone wartości: USR, CUS, VAR, SL1, SL2, SL3, BUS, HFX, GLS, DIS, ISV. Ustawienie domyślne: niezależnego dostawcy oprogramowania.

--model -m

Nazwy modeli X++ do szkieletu. Akceptuje pojedynczą nazwę lub listę rozdzielaną przecinkami (np. ModelA, ModelB). Wymagane, gdy parametr --package-type to erp.

--outputDirectory -o

Katalog wyjściowy

--package-name

Ustawia domyślną nazwę pakietu. Dotyczy generowania polecenia ImportExtension.GetNameOfImport.

--package-type -pt

Typ projektu pakietu do szkieletu. Dozwolone wartości: dataverse, erp. Ustawienie domyślne: dataverse.

--publisher -pub

Publisher nazwa zapisana w deskryptorze modelu. Domyślnie: Microsoft.

--source-root -sr

Źródłowa ścieżka główna (względna do katalogu wyjściowego), w której będą żyć modele. Wartość domyślna: ./src.

pac package show

Pokazuje szczegóły pakietu Dataverse

Uwaga / Notatka

To polecenie jest dostępne tylko dla wersji platformy .NET Full Framework interfejsu wiersza polecenia PAC.

Example

pac package show c:\samplepackage.dll

Wymagane parametry dla package show

--package -p

Ścieżka do pliku dll pakietu lub pliku zip z pakietem.

Parametry opcjonalne dla package show

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

--logFile -lf

Ścieżka pliku dziennika

--verbose -vdbg

Emituj pełne dzienniki do danych wyjściowych dziennika.

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

Zobacz także

Grupy poleceń interfejsu wiersza polecenia platformy Microsoft Power Platform
Omówienie interfejsu wiersza polecenia platformy Microsoft Power Platform