Udostępnij za pośrednictwem

Informacje w wierszu polecenia programu MSBuild

  • Artykuł

Korzystając z MSBuild.exe do tworzenia pliku projektu lub rozwiązanie, może zawierać kilka przełączników, aby określić różnych aspektów 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, MSBuild przeszukuje bieżący katalog roboczy dla rozszerzenia nazwy pliku, która kończy się na "proj" i korzysta z tego pliku.Można również określić plik rozwiązania Visual Studio, w tym argumencie.

Przełączniki

Przełącznik

Krótka forma

Opis

/help

/?lub/h

Wyświetl informacje dotyczące użycia.Przykładem jest następujące polecenie:

msbuild.exe /?

/detailedsummary

/ ds

Pokaż szczegółowe informacje na końcu dzienniku kompilacji konfiguracji, które zostały zaprojektowane i jak zostały zaplanowane do węzłów.

/ignoreprojectextensions:extensions

/ Ignoruj:extensions

Ignoruj określonych rozszerzeń podczas ustalania, który plik projektu do utworzenia.Aby oddzielić wiele rozszerzeń, jak w poniższym przykładzie pokazano, należy użyć średnikami lub przecinkami:

/ignoreprojectextensions:.vcproj,.sln

/maxcpucount [:number]

/m[:number]

Określa maksymalną liczbę współbieżnych procesów do użycia podczas tworzenia.Jeśli ten przełącznik nie zostanie uwzględniony, wartością domyślną jest 1.Jeśli nie określając wartość tego parametru, MSBuild użyje do liczbę 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 MSBuild do utworzenia przy użyciu trzy MSBuild procesy, dzięki czemu trzy projektów do utworzenia w tym samym czasie:

msbuild myproject.proj /maxcpucount:3

/ noautoresponse

/noautorsp

Nie zawierają żadnych plików MSBuild.rsp automatycznie.

/nodeReuse:value

/nr:value

Włączać lub wyłączać ponownego użycia węzłów MSBuild.Można określić następujące wartości:

  • TRUE.Węzły pozostają po zakończeniu kompilacji, tak aby kolejne kompilacje można korzystać z nich (domyślnie).

  • FALSE.Węzły nie pozostaje po zakończeniu kompilacji.

Węzeł odnosi się do tego projektu, który jest wykonywany.Jeśli /maxcpucount przełącznik, wiele węzłów może wykonywać jednocześnie.

/nologo

Nie wyświetlaj Baner uruchamiania lub komunikat o prawach autorskich.

/ Przetwarzanie wstępne [:filepath]

/pp[:filepath]

Utwórz plik projekt pojedynczy, skumulowany przez inlining wszystkich plików, które może być importowane podczas kompilacji, z ich granice.Ta opcja służy do łatwiej określić pliki, które są importowane, z którym są importowane pliki i które pliki przyczyniają się do kompilacji.Korzystając z tej opcji, nie jest wbudowane projektu.

W przypadku określenia filepath, plik projektu skumulowany jest danych wyjściowych do pliku.W przeciwnym razie dane wyjściowe pojawia się w oknie konsoli.

Aby uzyskać informacje dotyczące sposobu realizacji Import element do wstawienia pliku projektu do innego pliku projektu, zobacz Import — Element (MSBuild) i Porady: użycie tej samej wartości docelowej w wielu plikach projektów.

/Property:name=value

/p:name=value

Ustawianie lub zastąpienie określonej właściwości na poziomie projektu, gdzie name jest nazwą właściwości i value jest wartość właściwości.Określ każdej właściwości oddzielnie, lub aby oddzielić wiele właściwości, jak w poniższym przykładzie pokazano użyć średnikami lub przecinkami:

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

/ target:targets

/ t:targets

Tworzenie celów określoną w projekcie.Określ każdego obiektu docelowego oddzielnie, lub aby oddzielić wiele elementów docelowych, jak w poniższym przykładzie pokazano użyć średnikami lub przecinkami:

/target:Resources;Compile

Jeśli określisz wszelkie cele przy użyciu tego parametru, są uruchamiane zamiast wszelkie cele w DefaultTargets atrybut w pliku projektu.Aby uzyskać więcej informacji, zobacz Kolejność kompilowania obiektów docelowych i Porady: określanie pierwszego obiektu docelowego do kompilacji.

Element docelowy jest grupy zadań.Aby uzyskać więcej informacji, zobacz Obiekty docelowe w programie MSBuild.

/toolsversion:version

/TV:version

Określa wersję zestawu narzędzi do użycia w celu tworzenia projektu, jak w następującym przykładzie:/toolsversion:3.5

Przy użyciu tego parametru, tworzenie projektu i określ różni się od wersji, określonym w wersji Project — Element (MSBuild).Aby uzyskać więcej informacji, zobacz Zastępowanie ustawień ToolsVersion.

Dla MSBuild 4.5, można określić następujące wartości dla version: 2.0, 3.5 i 4.0.W przypadku określenia 4.0, VisualStudioVersion kompilacji właściwość określa, które sub narzędzi do użycia.Aby uzyskać więcej informacji, zobacz sekcję procesami Sub Zestaw narzędzi MSBuild (ToolsVersion).

Zestaw narzędzi składa się z zadań, celów i narzędzia służące do tworzenia aplikacji.Tych narzędzi należą: kompilatorów, takich jak csc.exe i vbc.exe.Aby uzyskać więcej informacji na temat procesami, zobacz Zestaw narzędzi MSBuild (ToolsVersion), Konfiguracje standardowego i niestandardowego zestawu narzędzi, i Przegląd wielowersyjności kodu w programie MSBuild.

[!UWAGA]

Wersja zestawu narzędzi nie jest taki sam, jak cel struktury, która jest wersją programu .NET Framework, na którym oparto projekt do uruchamiania.Aby uzyskać więcej informacji, zobacz Platforma docelowa programu MSBuild.

/ validate: [schema]

/val[schema]

Sprawdź poprawność pliku projektu i, jeśli weryfikacja zakończy się powodzeniem, tworzenie projektu.

Jeśli nie określisz schema, projektu jest sprawdzana schemat domyślny.

W przypadku określenia schema, sprawdzania poprawności projektu schematem, 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 Wyświetla zdarzeń w oparciu o poziom szczegółowości 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świetl tylko informacje o wersji.Projekt nie jest wbudowane.

@file

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

Przełączniki rejestratorów

Przełącznik

Krótka forma

Opis

/consoleloggerparameters:

parameters

/CLP:parameters

Parametry, które można określić należy przekazać do rejestratora konsoli, który wyświetla informacje o kompilacji w oknie konsoli.Można określić następujące parametry:

  • PerformanceSummary.Pokaż przeznaczonego na czas w zadań, celów i projektów.

  • Podsumowanie.Pokaż błąd i ostrzeżenie podsumowanie na końcu.

  • NoSummary.Nie pokazuj błąd i ostrzeżenie 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 pojawią się na początku każdego projektu kompilacji, jeśli ustawiono poziom szczegółowości diagnostic.

  • ShowCommandLine.Pokaż TaskCommandLineEvent wiadomości.

  • ShowTimestamp.Pokaż sygnaturę czasową jako prefiksu do każdej wiadomości.

  • ShowEventId.Pokaż identyfikator zdarzenia dla każdego zdarzenia uruchomiony, zakończeniu zdarzenia i komunikat.

  • ForceNoAlign.Nie umożliwia wyrównanie tekstu do rozmiar buforu konsoli.

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

  • DisableMPLogging.Wyłącz rejestrowanie wieloprocesorowych stylu danych wyjściowych w trybie bez komputerach wieloprocesorowych.

  • EnableMPLogging.Włącz stylu wieloprocesorowych rejestrowania, nawet wtedy, gdy działa w trybie bez komputerach wieloprocesorowych.Ten styl rejestrowania jest domyślnie włączony.

  • Szczegółowości.Zastąpienie /verbosity dla tego rejestratora.

Aby oddzielić wiele parametrów, jak w poniższym przykładzie pokazano, należy użyć średnikami lub przecinkami:

/consoleloggerparameters:PerformanceSummary;NoSummary /verbosity:minimal

/distributedFileLogger

/DFL

Wyniki kompilacji każdego węzła MSBuild własnej w pliku dziennika.Położenie początkowe dla tych plików jest bieżący katalog.Domyślnie nazwy plików "MSBuildID. węzłalog".Można użyć /fileLoggerParameters przełącznik, aby określić lokalizację plików oraz innych parametrów fileLogger.

Jeśli nazwa pliku dziennika przy użyciu /fileLoggerParameters przełącznik, rozproszonej Rejestrator będzie używać go nazwy jako szablon i dołączyć identyfikator węzła do tej nazwy, tworząc plik dziennika dla każdego węzła.

/distributedlogger:

central logger*

forwarding logger

/dl:central logger*forwarding logger

Dziennik zdarzeń z MSBuild związane z wystąpieniem różnych rejestratora każdy węzeł.Aby określić wiele rejestratory, określ osobno każdy rejestratora.

Składnia rejestratora służy do określania rejestratora.Informacje na temat składni rejestratora, zobacz /logger switch poniżej.

Poniższe przykłady pokazują, jak używać tej opcji:

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

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

/fileLogger

[numer]

/fl[number]

Zaloguj się wyniki kompilacji pojedynczy plik w bieżącym katalogu.Jeśli nie określisz number, plik wyjściowy jest o nazwie msbuild.log.W przypadku określenia number, plik wyjściowy jest o nazwie msbuildnlog, gdzie n oznacza number.Numbermoże być cyfrą z zakresu od 1 do 9.

Można użyć /fileLoggerParameters przełącznik, aby określić lokalizację pliku oraz innych parametrów fileLogger.

/fileloggerparameters: [numer]

parameters

/flp:[ number]parameters

Określa żadnych dodatkowych parametrów dla rejestratora plików i plików rozproszonych rejestratora.Obecność tej opcji oznacza, że odpowiednie /filelogger[number] przełącznik jest obecny.Numbermoże być cyfrą z zakresu od 1 do 9.

Można użyć wszystkich parametrów, które są wymienione /consoleloggerparameters.Można również użyć jedną lub więcej z następujących parametrów:

  • Plik dziennika.Ścieżka do pliku dziennika, w którym jest zapisywana w dzienniku kompilacji.Rejestrator DFS dodanie prefiksu składającego ta ścieżka do nazwy jego plików dziennika.

  • Dołącz.Określa, czy w dzienniku kompilacji jest dołączona do pliku dziennika, czy zastępuje go.Po ustawieniu przełącznika dzienniku kompilacji jest dołączany do pliku dziennika.Gdy nie ma przełącznik, są zastępowane zawartość istniejącego pliku dziennika.

    Jeśli zawierać przełącznik Dołącz, niezależnie od tego, czy jest ustawiona na wartość true lub false, jest dołączany dziennika.Jeśli nie ma przełącznika Dołącz, dziennik jest zastępowany.

    W takim przypadku plik jest zastępowany:msbuild myfile.proj /l:FileLogger,Microsoft.Build.Engine;logfile=MyLog.log

    W takim przypadku zostanie dołączony plik:msbuild myfile.proj /l:FileLogger,Microsoft.Build.Engine;logfile=MyLog.log;append=true

    W takim przypadku zostanie dołączony plik:msbuild myfile.proj /l:FileLogger,Microsoft.Build.Engine;logfile=MyLog.log;append=false 

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

W poniższym przykładzie generuje oddzielnych plikach dziennika błędów i ostrzeżenia:

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

Poniższe przykłady pokazują 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 Rejestrator do rejestrowania zdarzeń z MSBuild.Aby określić wiele rejestratory, określ osobno każdy rejestratora.

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śli zestaw zawiera dokładnie jeden rejestratora.

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 poniższych 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łącz rejestratora konsoli domyślny, a nie rejestrować zdarzeń w konsoli.

Przykład

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

MSBuild.exe MyProject.proj /t:rebuild

MSBuild.exe można użyć do wykonania bardziej złożonych kompilacje.Na przykład służy on do tworzenia określonych celów szczególnych projektów w rozwiązaniu.W poniższym przykładzie odtwarza 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 projektów MSBuild

Inne zasoby

Odwołanie do narzędzia MSBuild