Udostępnij za pośrednictwem


Informacje w wierszu polecenia programu MSBuild

Korzystając z programu MSBuild.exe Aby utworzyć plik projektu lub rozwiązanie, można dołączyć kilka przełączników, aby określić różne aspekty procesu.

MSBuild.exe [Switches] [ProjectFile]

Argumenty

Argument

Opis

ProjectFile

Tworzy obiekty docelowe w pliku projektu, który określisz.Jeśli nie określisz pliku projektu, program MSBuild przeszukuje bieżący katalog roboczy dla rozszerzenia nazwy pliku, który kończy się za "proj" i używa tego pliku.Można również określić plik rozwiązania Visual Studio dla tego argumentu.

Przełączniki

Przełącznik

Forma krótka

Opis

/ Help

/?lub /h

Wyświetlić informacje o sposobie użycia.Następujące polecenie znajduje się przykład:

msbuild.exe /?

/detailedsummary

/ ds

Umożliwia wyświetlenie szczegółowych informacji na koniec dziennika kompilacji o konfiguracji, które zostały zbudowane i jak zostały zaplanowane do węzłów.

/ignoreprojectextensions:extensions

/ ignore:extensions

Ignoruj określonymi rozszerzeniami, przy ustalaniu których pliku projektu w celu utworzenia.Użyj średnikiem lub przecinkiem, aby oddzielić wiele rozszerzeń, co ilustruje poniższy przykład:

/ignoreprojectextensions:.vcproj,.sln

/maxcpucount [:number

/m[:number

Określa maksymalną liczbę równoczesnych procesów będzie używana podczas budowania.Jeśli ten przełącznik nie zostanie uwzględniony, wartością domyślną jest 1.Jeśli ten przełącznik zostanie uwzględniony bez określenia wartości, program MSBuild użyje do liczby procesorów w komputerze.Aby uzyskać więcej informacji, zobacz Równoległe tworzenie wielu projektów za pomocą narzędzia MSBuild.

Poniższy przykład powoduje, że program MSBuild zbudować przy użyciu trzech MSBuild procesów, co pozwala trzech projektów zbudować w tym samym czasie:

msbuild myproject.proj /maxcpucount:3

/ noautoresponse

/noautorsp

Nie uwzględnia żadnych plików MSBuild.rsp automatycznie.

/nodeReuse:value

/nr:value

Włącz lub Wyłącz ponowne wykorzystywanie węzły MSBuild.Można określić następujące wartości:

  • Wartość true.Węzły pozostać po zakończeniu kompilacji, tak aby kolejnych operacji budowania mogą być użyte (ustawienie domyślne).

  • Fałszywe.Węzły nie pozostają po zakończeniu kompilacji.

Węzeł odnosi się do projektu, który jest wykonywany.Jeśli dołączysz /maxcpucount przełącznika, wiele węzłów mogą być wykonywane jednocześnie.

/ nologo

Nie wyświetlaj transparentu startowego lub komunikatu o prawach autorskich.

/ przetwarzania wstępnego [:filepath

/pp[:filepath

Utwórz plik projektu pojedynczy, zagregowane przez inline wszystkie zaznaczone pliki, które przywożono podczas kompilacji, z ich granice.Można użyć tego przełącznika, aby łatwiej określić, które pliki są importowane, z którym pliki są importowane pliki, które pliki przyczyniają się do kompilacji.Gdy ta opcja zostanie użyta, projektu nie jest tworzona.

Jeśli określisz filepath, plik projektu zagregowane są kierowane do pliku.W przeciwnym razie dane wyjściowe są wyświetlane w oknie konsoli.

Aby uzyskać informacje o sposobach używania Import element, aby wstawić plik projektu do innego pliku programu project, zobacz Elementu importu (MSBuild) i Jak: Użyj tej samej lokalizacji docelowej w wielu plikach programu Project.

/Property:name=value

/p:name=value

Ustawianie lub zastąpić określone właściwości poziomu projektu, gdzie name jest nazwą właściwości i value jest wartość właściwości.Każda właściwość oddzielnie lub użyj średniki lub przecinki do oddzielenia poszczególnych właściwości, jak pokazano w następującym przykładzie:

/property:WarningLevel=2;OutputDir=bin\Debug

/ Target:targets

/ t:targets

Budowanie sprecyzowanych celów w projekcie.Każdy cel oddzielnie lub użyj średniki lub przecinki do oddzielenia wielu celów, jak pokazano w następującym przykładzie:

/target:Resources;Compile

Jeśli określisz wszelkie cele za pomocą tego przełącznika, są one uruchamiane zamiast wszelkie cele w DefaultTargets atrybut w pliku projektu.Aby uzyskać więcej informacji, zobacz Zamówienie docelowej i Jak: Określ, które docelowych do kompilacji najpierw.

Element docelowy jest grupy zadań.Aby uzyskać więcej informacji, zobacz Cele programu MSBuild.

/toolsversion:version

/TV:version

Określa wersję zestaw narzędzi, aby skonstruować projektu, co ilustruje poniższy przykład:/toolsversion:3.5

Za pomocą tego przełącznika, można zbudować projekt i określić wersję, która różni się od wersji, która jest określona w Element projektu (MSBuild).Aby uzyskać więcej informacji, zobacz Zastępowanie ustawień ToolsVersion.

Dla programu MSBuild 4.5, można określić następujące wartości dla version: 2.0, 3.5 i 4.0.Jeśli określisz 4.0, VisualStudioVersion właściwość kompilacji Określa, które toolset sub, aby użyć.Aby uzyskać więcej informacji, zobacz sekcję zestawów narzędzi Sub Zestaw narzędzi MSBuild (ToolsVersion).

Opis narzędzia składa się z zadania, cele i narzędzia, które są używane do budowania aplikacji.Obejmują one kompilatory takie jak csc.exe i vbc.exe.Aby uzyskać więcej informacji na temat zestawów narzędzi, zobacz Zestaw narzędzi MSBuild (ToolsVersion), Konfiguracje standardowego i niestandardowego zestawu narzędzi, i Omówienie aktualnie MSBuild.

UwagaUwaga
Wersja zestawu narzędzi nie jest taki sam jak systemu docelowego, który jest wersją.NET Framework, na którym projekt jest skompilowany w celu uruchamiania.Aby uzyskać więcej informacji, zobacz Ramy docelowych MSBuild i platforma docelowa.

/ validate: schema

/valschema

Sprawdź poprawność pliku projektu i, jeśli weryfikacja przebiegnie pomyślnie, skompiluj projekt.

Jeśli nie zostanie określony schema, projekt jest sprawdzany domyślnego schematu.

Jeśli określisz schema, projekt jest sprawdzana względem schematu, który określisz.

Następujące ustawienie jest przykładem:/validate:MyExtendedBuildSchema.xsd

/Verbosity:level

/ v:level

Określa ilość informacji do wyświetlenia w dzienniku kompilacji.Każdy rejestrator wyowietlane są zdarzenia, w zależności od poziomu szczegółowości, ustawionego dla tego rejestratora.

Można określić następujące poziomy szczegółowości: q[uiet], m[inimal], n[ormal], d[etailed], i diag[nostic].

Następujące ustawienie jest przykładem:/verbosity:quiet

/version

/ VER

Wyświetlić tylko informacje o wersji.Projekt nie jest wbudowana.

@file

Przełączniki wiersza polecenia Wstaw z pliku tekstowego.Jeśli masz wiele plików, możesz określić je oddzielnie.Aby uzyskać więcej informacji, zobacz Program MSBuild plików odpowiedzi.

ms164311.collapse_all(pl-pl,VS.110).gifPrzełączniki programu Rejestrator

Przełącznik

Forma krótka

Opis

/consoleloggerparameters:parameters

/CLP:parameters

Przekazywanie parametrów, określonych przez użytkownika do programu rejestrującego konsoli, który wyświetla informacja o kompilacji w oknie konsoli.Można określić następujące parametry:

  • PerformanceSummary.Pokaż czas, który jest wydawana w zadania, cele i projekty.

  • Krótki opis.Pokaż błąd i ostrzeżenie podsumowanie na końcu.

  • NoSummary.Nie pokazuj błędów i ostrzeżeń podsumowanie na końcu.

  • ErrorsOnly.Pokaż tylko błędy.

  • WarningsOnly.Pokaż tylko ostrzeżenia.

  • NoItemAndPropertyList.Nie pokazuj listę elementów i właściwości, które wyglądałyby na początku każdej kompilacji projektu, jeśli poziom szczegółowości jest równa diagnostic.

  • ShowCommandLine.Pokaż TaskCommandLineEvent wiadomości.

  • ShowTimestamp.Sygnatura czasowa są wyświetlane jako prefiks do wszystkich wiadomości.

  • ShowEventId.Pokaż identyfikator zdarzenia dla każdego zdarzenia rozpoczętych, gotowego zdarzenia i komunikat.

  • ForceNoAlign.Nie wyrównać tekst do rozmiar buforu konsoli.

  • DisableConsoleColor.Użyj kolorów konsoli domyślne dla wszystkich wiadomości rejestrowania.

  • DisableMPLogging.Wyłącz styl wieloprocesorowych rejestrowanie produkcji globalnej w trybie non systemów wieloprocesorowych.

  • EnableMPLogging.Styl wieloprocesorowych rejestrowania należy włączyć, nawet w przypadku, gdy działa w trybie non systemów wieloprocesorowych.Ten styl rejestrowania jest domyślnie włączona.

  • Poziom szczegółowości.Zastąpić /verbosity ustawienie dla tego rejestratora.

Użyj średniki lub przecinki do oddzielenia wielu parametrów, jak pokazano w następującym przykładzie:

/consoleloggerparameters:PerformanceSummary;NoSummary /verbosity:minimal

/distributedFileLogger

/DFL

Zaloguj się budować produkcja każdego węzła MSBuild własny plik.Położenie początkowe dla tych plików jest katalog bieżący.Domyślnie pliki są nazywane "MSBuildNodeIddziennika (.log)".Można użyć /fileLoggerParameters przełącznika, aby określić lokalizację plików oraz innych parametrów dla fileLogger.

Jeśli nazwa pliku dziennika za pomocą /fileLoggerParameters przełącznika, rozproszonych rejestratora użyje który nazwany jako szablon i dołączyć identyfikator węzła do tej nazwy podczas tworzenia pliku dziennika dla każdego węzła.

/distributedlogger:central logger*forwarding logger

/dl:central logger*forwarding logger

Dziennik zdarzeń z MSBuild dołączanie wystąpienia różnych rejestratora do każdego węzła.Aby określić wiele rejestratory, określić oddzielnie każdy rejestrator.

Określ Rejestrator za pomocą składni rejestratora.Rejestrator składnię, zobacz /logger przełącznik poniżej.

Następujące przykłady przedstawiają metody korzystania z tego przełącznika:

/dl:XMLLogger,MyLogger,Version=1.0.2,Culture=neutral

/dl:MyLogger,C:\My.dll*ForwardingLogger,C:\Logger.dll

/fileLogger[numer]

/flnumber

Dziennika produkcji kompilacji w pojedynczym pliku w katalogu bieżącym.Jeśli nie zostanie określony number, plik wyjściowy o nazwie msbuild.log.Jeśli określisz number, plik wyjściowy o nazwie msbuildn.log, gdzie n jest number.Numbermoże być cyfrę od 1 do 9.

Można użyć /fileLoggerParameters przełącznika, aby określić lokalizację pliku i inne parametry dla fileLogger.

/fileloggerparameters: [numer]parameters

/flp:numberparameters

Określa wszelkie dodatkowe parametry dla rejestratora pliku i Rejestrator DFS.Obecności tej opcji oznacza, że odpowiadające im /filelogger[number] znajduje się przełącznik.Numbermoże być cyfrę od 1 do 9.

Można użyć wszystkich parametrów, które są wymienione w /consoleloggerparameters.Umożliwia także, przynajmniej jedną z następujących parametrów:

  • Plik dziennika.Ścieżka do pliku dziennika, do którego zapisu dziennika kompilacji.Rejestrator DFS prefiksy tę ścieżkę do nazwy jego plików dziennika.

  • Dołącz.Określa, czy dziennik kompilacji są dołączane do pliku dziennika lub w sieci jest zastąpienie go.Po ustawieniu przełącznika, dziennik kompilacji jest dołączony do pliku dziennika.Gdy przełącznik nie zostanie ustawiona, zawartość istniejącego pliku dziennika są zastępowane.

  • Kodowanie.Określa kodowanie pliku (na przykład UTF-8, Unicode lub ASCII).

W poniższym przykładzie generuje oddzielne pliki dziennika dla ostrzeżeń i błędów:

/flp1:logfile=errors.txt;errorsonly /flp2:logfile=warnings.txt;warningsonly

Następujące przykłady przedstawiają inne możliwości:

/fileLoggerParameters:LogFile=MyLog.log;Append; Verbosity=diagnostic;Encoding=UTF-8

/flp:Summary;Verbosity=minimal;LogFile=msbuild.sum

/flp1:warningsonly;logfile=msbuild.wrn

/flp2:errorsonly;logfile=msbuild.err

/Logger:logger

/ l: wyświetlenielogger

Określa rejestratora służy do rejestrowania zdarzeń z programu MSBuild.Aby określić wiele rejestratory, określić oddzielnie każdy rejestrator.

Należy użyć następującej składni dla logger:[LoggerClass,]LoggerAssembly[;LoggerParameters]

Należy użyć następującej składni dla LoggerClass:[PartialOrFullNamespace.]LoggerClassName

Nie trzeba określić klasy rejestratora, jeżeli zgromadzenie zawiera dokładnie jeden rejestrator.

Należy użyć następującej składni dla LoggerAssembly:{AssemblyName[,StrongName] |AssemblyFile}

Rejestrator parametry są opcjonalne i są przekazywane do programu rejestrującego, dokładnie tak, jak je wprowadzić.

W następujących przykładach użyto /logger przełączyć.

/logger:XMLLogger,MyLogger,Version=1.0.2,Culture=neutral

/logger:XMLLogger,C:\Loggers\MyLogger.dll;OutputAsHTML

/noconsolelogger

/noconlog

Wyłączyć rejestrator domyślny konsoli, a nie Rejestruj zdarzenia do konsoli.

Przykład

Poniższy przykład tworzy rebuild cel MyProject.proj projektu.

MSBuild.exe MyProject.proj /t:rebuild

MSBuild.exe można użyć, aby wykonać opiera się bardziej złożone.Na przykład służy on do tworzenia szczegółowych celów szczególnych projektów w ramach rozwiązania.Poniższy przykład buduje ponownie projektu NotInSolutionFolder i czyści projektu InSolutionFolder, który jest w NewFolder folder rozwiązania.

msbuild SlnFolders.sln /t:NotInSolutionfolder:Rebuild;NewFolder\InSolutionFolder:Clean

Zobacz też

Informacje

Wspólne właściwości projektu MSBuild

Inne zasoby

Program MSBuild odniesienia