Referenční dokumentace pro použití nástroje MSBuild v příkazovém řádkuMSBuild command-line reference

Při použití MSBuild.exe k sestavení projektu nebo souboru řešení můžete zahrnout několik přepínačů pro určení různých aspektů procesu.When you use MSBuild.exe to build a project or solution file, you can include several switches to specify various aspects of the process.

Každý přepínač je k dispozici ve dvou formách:-Switch a/Switch.Every switch is available in two forms: -switch and /switch. V dokumentaci se zobrazí pouze formulář přepínač-Switch.The documentation only shows the -switch form. U přepínačů se nerozlišují malá a velká písmena.Switches are not case-sensitive. Spouštíte-li nástroj MSBuild z jiného prostředí než z příkazového řádku systému Windows, mohou být v seznamech argumentů přepínače (oddělené středníkem nebo čárkami) zajištěny jednoduché nebo dvojité uvozovky, které zajistí předávání seznamů nástroji MSBuild místo interpretace prostředí.If you run MSBuild from a shell other than the Windows command prompt, lists of arguments to a switch (separated by semicolons or commas) might need single or double quotes to ensure that lists are passed to MSBuild instead of interpreted by the shell.

SyntaxeSyntax

MSBuild.exe [Switches] [ProjectFile]

ArgumentyArguments

ArgumentArgument DescriptionDescription
ProjectFile Vytvoří cíle v souboru projektu, který zadáte.Builds the targets in the project file that you specify. Pokud nezadáte soubor projektu, nástroj MSBuild vyhledá v aktuálním pracovním adresáři příponu názvu souboru, která končí v proj , a použije tento soubor.If you don't specify a project file, MSBuild searches the current working directory for a file name extension that ends in proj and uses that file. Můžete také zadat soubor řešení sady Visual Studio pro tento argument.You can also specify a Visual Studio solution file for this argument.

přepínače,Switches

PřepínačSwitch Krátký tvarShort form DescriptionDescription
-detailedSummary-detailedSummary – DS-ds Zobrazit podrobné informace na konci protokolu sestavení o konfiguracích, které byly vytvořeny a jak byly naplánovány na uzly.Show detailed information at the end of the build log about the configurations that were built and how they were scheduled to nodes.
-graphBuild [: True OR False ]-graphBuild[:True or False] -Graph [: True OR False ]-graph[:True or False] Způsobí, že nástroj MSBuild sestaví a sestaví graf projektu.Causes MSBuild to construct and build a project graph. Sestavování grafu zahrnuje identifikaci odkazů projektu na závislosti formulářů.Constructing a graph involves identifying project references to form dependencies. Sestavování grafu zahrnuje pokus o sestavení odkazů na projekt před projekty, které na ně odkazují, se liší od tradičního plánování MSBuild.Building that graph involves attempting to build project references prior to the projects that reference them, differing from traditional MSBuild scheduling. Vyžaduje MSBuild 16 nebo novější.Requires MSBuild 16 or later.
-Help-help /?/? nebo-hor -h Zobrazit informace o použití.Display usage information. Následující příkaz je příkladem:The following command is an example:

msbuild.exe -?
-ignoreProjectExtensions: extensions-ignoreProjectExtensions: extensions ohled extensions-ignore: extensions Ignorovat zadaná rozšíření při určování, který soubor projektu se má sestavit.Ignore the specified extensions when determining which project file to build. Použijte středník nebo čárku pro oddělení více rozšíření, jak ukazuje následující příklad:Use a semicolon or a comma to separate multiple extensions, as the following example shows:

-ignoreprojectextensions:.vcproj,.sln
-Interactive [: True nebo False ]-interactive[:True or False] - Označuje, že akce v sestavení mají povoleno interakci s uživatelem.Indicates that actions in the build are allowed to interact with the user. Nepoužívejte tento argument v automatizovaném scénáři, kde není očekávána interaktivita.Do not use this argument in an automated scenario where interactivity is not expected. Zadání – Interactive je stejné jako určení – Interactive: true.Specifying -interactive is the same as specifying -interactive:true. Pomocí parametru můžete přepsat hodnotu, která pochází ze souboru odpovědí.Use the parameter to override a value that comes from a response file.
-isolateProjects [: True OR False ]-isolateProjects[:True or False] -Izolujte [: True OR False ]-isolate[:True or False] Způsobí, že nástroj MSBuild sestaví jednotlivé projekty v izolaci.Causes MSBuild to build each project in isolation. Toto je přísnější režim nástroje MSBuild, protože vyžaduje, aby byl graf projektu staticky zjistitelný v době hodnocení, ale může zlepšit plánování a snížit nároky na paměť při sestavování rozsáhlé sady projektů.This is a more restrictive mode of MSBuild as it requires that the project graph be statically discoverable at evaluation time, but can improve scheduling and reduce memory overhead when building a large set of projects.
-maxCpuCount [: number ]-maxCpuCount[:number] -m [: number ]-m[:number] Určuje maximální počet souběžných procesů, které mají být použity při sestavování.Specifies the maximum number of concurrent processes to use when building. Pokud tento přepínač nezadáte, výchozí hodnota je 1.If you don't include this switch, the default value is 1. Pokud tento přepínač zadáte bez zadání hodnoty, nástroj MSBuild použije množství procesorů v počítači.If you include this switch without specifying a value, MSBuild will use up to the number of processors in the computer. Další informace naleznete v tématu Souběžné sestavování více projektů.For more information, see Building multiple projects in parallel.

Následující příklad instruuje nástroj MSBuild k sestavení pomocí tří procesů MSBuild, které umožňují sestavovat tři projekty ve stejnou dobu:The following example instructs MSBuild to build using three MSBuild processes, which allows three projects to build at the same time:

msbuild myproject.proj -maxcpucount:3
-noAutoResponse-noAutoResponse -noautorsp-noautorsp Nezahrnujte žádné soubory MSBuild. rsp automaticky.Don't include any MSBuild.rsp files automatically.
-nodeReuse:value-nodeReuse:value Nrvalue-nr:value Povolí nebo zakáže opakované použití uzlů MSBuild.Enable or disable the re-use of MSBuild nodes. Můžete určit tyto hodnoty:You can specify the following values:

- Hodnota true .- True . Uzly zůstanou po dokončení sestavení, aby je mohli použít následné sestavení (výchozí).Nodes remain after the build finishes so that subsequent builds can use them (default).
- Hodnota false .- False . Uzly po dokončení sestavení nezůstanou.Nodes don't remain after the build completes.

Uzel odpovídá projektu, který je spuštěn.A node corresponds to a project that's executing. Pokud zahrnete přepínač -maxcpucount , může být souběžně spuštěno více uzlů.If you include the -maxcpucount switch, multiple nodes can execute concurrently.
-nologo-nologo Nezobrazovat úvodní nápis nebo zprávu o autorských právech.Don't display the startup banner or the copyright message.
-předzpracování [: filepath ]-preprocess[:filepath] -PP [: filepath ]-pp[:filepath] Vytvořte jeden agregovaný soubor projektu tak, že zapíšete všechny soubory, které by se importovaly během sestavení, se svými hranicemi označenými.Create a single, aggregated project file by inlining all the files that would be imported during a build, with their boundaries marked. Pomocí tohoto přepínače můžete snadněji určit, které soubory se importují, odkud se soubory importují a které soubory přispívají k sestavení.You can use this switch to more easily determine which files are being imported, from where the files are being imported, and which files contribute to the build. Když použijete tento přepínač, projekt není sestaven.When you use this switch, the project isn't built.

Pokud zadáte filepath , agregovaný soubor projektu je výstupem do souboru.If you specify a filepath, the aggregated project file is output to the file. V opačném případě se výstup zobrazí v okně konzoly.Otherwise, the output appears in the console window.

Informace o tom, jak použít Import element pro vložení souboru projektu do jiného souboru projektu, naleznete v tématu Import element (MSBuild) a How to: použijte stejný cíl ve více souborech projektu.For information about how to use the Import element to insert a project file into another project file, see Import element (MSBuild) and How to: Use the same target in multiple project files.
-outputResultsCache[:cacheFile]-outputResultsCache[:cacheFile] -ORC [: cacheFile]-orc[:cacheFile] Soubor výstupní mezipaměti, kde nástroj MSBuild zapíše obsah svých výsledků sestavení do mezipaměti na konci sestavení.Output cache file where MSBuild will write the contents of its build result caches at the end of the build. Toto nastavení také zapne izolované sestavení (-izoluje).Setting this also turns on isolated builds (-isolate).
-profileEvaluation:<file>-profileEvaluation:<file> - Profiluje testování nástroje MSBuild a zapíše výsledek do zadaného souboru.Profiles MSBuild evaluation and writes the result to the specified file. Pokud je přípona zadaného souboru. MD, výsledek se vygeneruje ve formátu Markdownu.If the extension of the specified file is '.md', the result is generated in Markdown format. V opačném případě se vytvoří soubor oddělený tabulátorem.Otherwise, a tab-separated file is produced.
majetekname=value-property:name=value trubname=value-p:name=value Nastaví nebo přepíše zadané vlastnosti na úrovni projektu, kde name je název vlastnosti a value je hodnotou vlastnosti.Set or override the specified project-level properties, where name is the property name and value is the property value. Jednotlivé vlastnosti zadejte samostatně nebo použijte středník nebo čárku pro oddělení více vlastností, jak ukazuje následující příklad:Specify each property separately, or use a semicolon or comma to separate multiple properties, as the following example shows:

-property:WarningLevel=2;OutDir=bin\Debug
– obnovení-restore -r-r RestorePřed vytvořením skutečných cílů spustí cíl.Runs the Restore target prior to building the actual targets.
-restoreProperty:name=value-restoreProperty:name=value RPname=value-rp:name=value Nastavte nebo přepište tyto vlastnosti na úrovni projektu pouze během obnovení a nepoužívejte vlastnosti zadané s argumentem-Property.Set or override these project-level properties only during restore and do not use properties specified with the -property argument. name je název vlastnosti a value je hodnota vlastnosti.name is the property name, and value is the property value. K oddělení více vlastností použijte středník nebo čárku nebo zadejte jednotlivé vlastnosti samostatně.Use a semicolon or a comma to separate multiple properties, or specify each property separately.
cílovétargets-target:targets štargets-t:targets Sestavte zadané cíle v projektu.Build the specified targets in the project. Určete každý cíl samostatně nebo použijte středník nebo čárku pro oddělení více cílů, jak ukazuje následující příklad:Specify each target separately, or use a semicolon or comma to separate multiple targets, as the following example shows:

-target:PrepareResources;Compile

Pokud zadáte všechny cíle pomocí tohoto přepínače, jsou spuštěny namísto všech cílů v DefaultTargets atributu v souboru projektu.If you specify any targets by using this switch, they are run instead of any targets in the DefaultTargets attribute in the project file. Další informace naleznete v tématu cílové pořadí sestavení a Postup: určení cíle, který se má sestavit jako první.For more information, see Target build order and How to: Specify which target to build first.

Cíl je skupina úkolů.A target is a group of tasks. Další informace najdete v tématu cíle.For more information, see Targets.
– cíle [: file ]-targets[:file] -TS [: file ]-ts[:file] Zapsat seznam dostupných cílů do zadaného souboru (nebo výstupního zařízení, pokud není zadán žádný soubor), aniž by bylo nutné proces sestavení skutečně spustit.Write the list of available targets to the specified file (or the output device, if no file is specified), without actually executing the build process.
toolsVersionversion-toolsVersion:version řaduversion-tv:version Určuje verzi sady nástrojů, která se má použít k sestavení projektu, jak ukazuje následující příklad: -toolsversion:3.5Specifies the version of the Toolset to use to build the project, as the following example shows: -toolsversion:3.5

Pomocí tohoto přepínače můžete sestavit projekt a zadat verzi, která se liší od verze, která je zadána v elementu projektu (MSBuild).By using this switch, you can build a project and specify a version that differs from the version that's specified in the Project element (MSBuild). Další informace najdete v tématu přepsání nastavení ToolsVersion.For more information, see Overriding ToolsVersion settings.

Pro MSBuild 4,5 můžete zadat následující hodnoty pro version : 2,0, 3,5 a 4,0.For MSBuild 4.5, you can specify the following values for version: 2.0, 3.5, and 4.0. Zadáte-li 4,0, VisualStudioVersion vlastnost Build určuje, kterou dílčí sadu nástrojů použít.If you specify 4.0, the VisualStudioVersion build property specifies which sub-toolset to use. Další informace naleznete v části sady nástrojů sady nástrojů (ToolsVersion)dílčích sad nástrojů.For more information, see the Sub-toolsets section of Toolset (ToolsVersion).

Sada nástrojů se skládá z úloh, cílů a nástrojů, které se používají k sestavení aplikace.A Toolset consists of tasks, targets, and tools that are used to build an application. Mezi tyto nástroje patří kompilátory, jako jsou csc.exe a vbc.exe .The tools include compilers such as csc.exe and vbc.exe . Další informace o sadě nástrojů naleznete v tématech Sada nástrojů (ToolsVersion), standardní a vlastní konfigurace sady nástrojůa cílenína více verzí.For more information about Toolsets, see Toolset (ToolsVersion), Standard and custom toolset configurations, and Multitargeting. Poznámka: Verze sady nástrojů není shodná s cílovou architekturou, což je verze .NET Framework, na které je projekt sestaven pro spuštění.Note: The toolset version isn't the same as the target framework, which is the version of the .NET Framework on which a project is built to run. Další informace naleznete v tématu Cílová architektura a cílová platforma.For more information, see Target framework and target platform.
-Validate: [ schema ]-validate:[schema] – Val [ schema ]-val[schema] Ověřte soubor projektu a, pokud je ověření úspěšné, sestavte projekt.Validate the project file and, if validation succeeds, build the project.

Pokud nezadáte schema , projekt je ověřen proti výchozímu schématu.If you don't specify schema, the project is validated against the default schema.

Pokud zadáte schema , projekt se ověří podle schématu, které zadáte.If you specify schema, the project is validated against the schema that you specify.

Toto nastavení je příklad: -validate:MyExtendedBuildSchema.xsdThe following setting is an example: -validate:MyExtendedBuildSchema.xsd
podrobnostílevel-verbosity:level ICESlevel-v:level Určuje množství informací, které se mají zobrazit v protokolu sestavení.Specifies the amount of information to display in the build log. Každý protokolovací nástroj zobrazuje události na základě úrovně podrobností, kterou jste nastavili pro daný protokolovací nástroj.Each logger displays events based on the verbosity level that you set for that logger.

Můžete zadat následující úrovně podrobností: q[uiet] , m[inimal] , n[ormal] (výchozí), d[etailed] a diag[nostic] .You can specify the following verbosity levels: q[uiet], m[inimal], n[ormal] (default), d[etailed], and diag[nostic].

Toto nastavení je příklad: -verbosity:quietThe following setting is an example: -verbosity:quiet
– verze-version – ver-ver Zobrazí pouze informace o verzi.Display version information only. Projekt není sestaven.The project isn't built.
@file Vloží přepínače příkazového řádku z textového souboru.Insert command-line switches from a text file. Pokud máte více souborů, zadejte je samostatně.If you have multiple files, you specify them separately. Další informace najdete v tématu soubory odezvy.For more information, see Response files.
-warnaserror – [: code [ ;code2 ]-warnAsError[:code[;code2] -ERR [ :code [ ;code2 ]-err[:code[;code2] Seznam kódů upozornění, které se mají považovat za chybyList of warning codes to treats as errors. K oddělení více kódů upozornění použijte středník nebo čárku.Use a semicolon or a comma to separate multiple warning codes. Pokud chcete považovat všechna upozornění za chyby, použijte přepínač bez hodnot.To treat all warnings as errors, use the switch with no values. Když je výstraha považována za chybu, že cíl pokračuje v provádění, jako by se jednalo o upozornění, ale celkové sestavení se nepodaří.When a warning is treated as an error the target continues to execute as if it was a warning but the overall build fails.

Příklad: -err:MSB4130Example: -err:MSB4130
-warnAsMessage [: code [ ;code2 ]-warnAsMessage[:code[;code2] -WARN [: code [ ;code2 ]-noWarn[:code[;code2] Seznam kódů upozornění, které se mají považovat za zprávy s nízkou důležitostíList of warning codes to treats as low importance messages. K oddělení více kódů upozornění použijte středník nebo čárku.Use a semicolon or a comma to separate multiple warning codes.

Příklad: -noWarn:MSB3026Example: -noWarn:MSB3026

Přepínače pro protokolovací nástrojeSwitches for loggers

PřepínačSwitch Krátký tvarShort form DescriptionDescription
-binaryLogger [: [LogFile =]output.binlog-binaryLogger[:[LogFile=]output.binlog
[; ProjectImports = [None; embed; podřízený ZipFile]]][;ProjectImports=[None,Embed,ZipFile]]]
-zablokovaný-bl Zaserializace všechny události sestavení do komprimovaného binárního souboru.Serializes all build events to a compressed binary file. Ve výchozím nastavení je soubor v aktuálním adresáři a s názvem MSBuild. binlog .By default the file is in the current directory and named msbuild.binlog . Binární protokol je podrobný popis procesu sestavení, který lze později použít k rekonstrukci textových protokolů a používání jiných analytických nástrojů.The binary log is a detailed description of the build process that can later be used to reconstruct text logs and used by other analysis tools. Binární protokol je obvykle 10 – 20krát menší než nejdůležitější protokol na úrovni diagnostiky textu, ale obsahuje další informace.A binary log is usually 10-20x smaller than the most detailed text diagnostic-level log, but it contains more information.

Binární protokolovací nástroj ve výchozím nastavení shromažďuje zdrojový text souborů projektu, včetně všech importovaných projektů a cílových souborů zjištěných během sestavení.The binary logger by default collects the source text of project files, including all imported projects and target files encountered during the build. Volitelný ProjectImports přepínač řídí toto chování:The optional ProjectImports switch controls this behavior:

- ProjectImports = None .- ProjectImports=None . Neshromážděte importy projektu.Don't collect the project imports.
- ProjectImports = embed .- ProjectImports=Embed . Vložit importy projektu do souboru protokolu (výchozí).Embed project imports in the log file (default).
- ProjectImports = podřízený ZipFile .- ProjectImports=ZipFile . Uložte soubory projektu do <output>.projectimports.zip , kde <output> je stejný název jako název souboru binárního protokolu.Save project files to <output>.projectimports.zip where <output> is the same name as the binary log file name.

Výchozí nastavení pro ProjectImports je vloženo.The default setting for ProjectImports is Embed.
Poznámka : protokolovací nástroj neshromažďuje zdrojové soubory bez MSBuild, jako je například . cs , . cpp atd.Note : the logger does not collect non-MSBuild source files such as .cs , .cpp etc.
Soubor . binlog lze přesměrovat tak, že ho předáte do msbuild.exe jako argument namísto projektu nebo řešení.A .binlog file can be "played back" by passing it to msbuild.exe as an argument instead of a project/solution. Další protokolovací nástroje obdrží informace obsažené v souboru protokolu, jako kdyby došlo k původnímu sestavení.Other loggers will receive the information contained in the log file as if the original build was happening. Můžete si přečíst další informace o binárním protokolu a jeho použití na: https://github.com/Microsoft/msbuild/wiki/Binary-LogYou can read more about the binary log and its usages at: https://github.com/Microsoft/msbuild/wiki/Binary-Log

Příklady :Examples :
- -bl
- -bl:output.binlog
- -bl:output.binlog;ProjectImports=None
- -bl:output.binlog;ProjectImports=ZipFile
- -bl:..\..\custom.binlog
- -binaryLogger
-consoleLoggerParameters:-consoleLoggerParameters:

parameters
-clp:parameters-clp:parameters Předejte parametry, které zadáte, do protokolovacího nástroje konzoly, který zobrazí informace o sestavení v okně konzoly.Pass the parameters that you specify to the console logger, which displays build information in the console window. Můžete zadat následující parametry:You can specify the following parameters:

- PerformanceSummary .- PerformanceSummary . Zobrazuje čas strávený v úkolech, cílech a projektech.Show the time that's spent in tasks, targets, and projects.
- Souhrn .- Summary . Zobrazit souhrn chyb a upozornění na konci.Show the error and warning summary at the end.
- Souhrn .- NoSummary . Nezobrazovat chyby a souhrn upozornění na konci.Don't show the error and warning summary at the end.
- ErrorsOnly .- ErrorsOnly . Zobrazit pouze chyby.Show only errors.
- WarningsOnly .- WarningsOnly . Zobrazit pouze upozornění.Show only warnings.
- NoItemAndPropertyList .- NoItemAndPropertyList . Nezobrazovat seznam položek a vlastností, které by se zobrazily na začátku každého sestavení projektu, pokud je úroveň podrobností nastavená na diagnostic .Don't show the list of items and properties that would appear at the start of each project build if the verbosity level is set to diagnostic.
- ShowCommandLine .- ShowCommandLine . Zobrazit TaskCommandLineEvent zprávy.Show TaskCommandLineEvent messages.
- ShowTimestamp .- ShowTimestamp . Zobrazit časové razítko jako předponu libovolné zprávyShow the timestamp as a prefix to any message.
- ShowEventId .- ShowEventId . Zobrazí ID události pro každou spuštěnou událost, dokončenou událost a zprávu.Show the event ID for each started event, finished event, and message.
- ForceNoAlign .- ForceNoAlign . Nesjednotit text na velikost vyrovnávací paměti konzoly.Don't align the text to the size of the console buffer.
- DisableConsoleColor .- DisableConsoleColor . Pro všechny zprávy protokolu použijte výchozí barvy konzoly.Use the default console colors for all logging messages.
- DisableMPLogging .- DisableMPLogging . Při spuštění v režimu bez více procesorů zakažte styl protokolování s více procesory.Disable the multiprocessor logging style of output when running in non-multiprocessor mode.
- EnableMPLogging .- EnableMPLogging . Povolte styl protokolování s více procesory i v případě, že je spuštěný v režimu bez více procesorů.Enable the multiprocessor logging style even when running in non-multiprocessor mode. Tento styl protokolování je ve výchozím nastavení zapnutý.This logging style is on by default.
- Podrobnosti .- Verbosity . Přepsat nastavení -podrobností pro tento protokolovací nástrojOverride the -verbosity setting for this logger.

Použijte středník pro oddělení více parametrů, jak ukazuje následující příklad:Use a semicolon to separate multiple parameters, as the following example shows:

-consoleloggerparameters:PerformanceSummary;NoSummary -verbosity:minimal

Výchozí protokolovací nástroj konzoly je normální podrobností a obsahuje Summary .The default console logger is at normal verbosity and includes a Summary.
-distributedFileLogger-distributedFileLogger – úrovni funkčnosti domény-dfl Zaprotokoluje výstup sestavení každého uzlu MSBuild do vlastního souboru.Log the build output of each MSBuild node to its own file. Výchozí umístění těchto souborů je aktuální adresář.The initial location for these files is the current directory. Ve výchozím nastavení se soubory nazývají MSBuild <NodeId> . log .By default, the files are named MSBuild<NodeId>.log . K určení umístění souborů a dalších parametrů pro protokolovací nástroj lze použít přepínač -fileLoggerParameters .You can use the -fileLoggerParameters switch to specify the location of the files and other parameters for the fileLogger.

Pokud zadáte název souboru protokolu pomocí přepínače -fileLoggerParameters , použije distribuovaný protokolovací nástroj tento název jako šablonu a při vytváření souboru protokolu pro každý uzel připojí ID uzlu k tomuto názvu.If you name a log file by using the -fileLoggerParameters switch, the distributed logger will use that name as a template and append the node ID to that name when creating a log file for each node.
-distributedLogger:-distributedLogger:

central logger*

forwarding logger
distribučního seznamucentral logger*forwarding logger-dl:central logger*forwarding logger Protokolujte události z nástroje MSBuild, připojíte k jednotlivým uzlům jinou instanci protokolovacího nástroje.Log events from MSBuild, attaching a different logger instance to each node. Chcete-li zadat více protokolovacích nástrojů, zadejte jednotlivé protokolovací nástroje samostatně.To specify multiple loggers, specify each logger separately.

K určení protokolovacího nástroje slouží syntaxe protokolovacího nástroje.You use the logger syntax to specify a logger. Syntaxi protokolovacího nástroje najdete níže v přepínači protokolovacího nástroje.For the logger syntax, see the -logger switch below.

Následující příklady ukazují, jak používat tento přepínač:The following examples show how to use this switch:

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

-dl:MyLogger,C:\My.dll*ForwardingLogger,C:\Logger.dll
– Protokolovací nástroj-fileLogger

Automatické[number]
-FL [ number ]-fl[number] Zaprotokoluje výstup sestavení do jednoho souboru v aktuálním adresáři.Log the build output to a single file in the current directory. Pokud nezadáte number , výstupní soubor se jmenuje MSBuild. log .If you don't specify number, the output file is named msbuild.log . Zadáte number -li, je výstupní soubor nazván MSBuild <n> . log , kde <n> je number .If you specify number, the output file is named msbuild<n>.log , where <n> is number. Number může to být číslice od 1 do 9.Number can be a digit from 1 to 9.

K určení umístění souboru a dalších parametrů pro protokolovací nástroj lze použít přepínač -fileLoggerParameters .You can use the -fileLoggerParameters switch to specify the location of the file and other parameters for the fileLogger.
-fileLoggerParameters [číslo]:-fileLoggerParameters[number]:

parameters
-FLP [ number ]: parameters-flp[ number]: parameters Určuje všechny další parametry pro protokolovací nástroj souborů a protokolování distribuovaných souborů.Specifies any extra parameters for the file logger and the distributed file logger. Přítomnost tohoto přepínače znamená, že je k dispozici odpovídající přepínač protokolovacího nástroje [ number ] .The presence of this switch implies that the corresponding - filelogger[number] switch is present. Number může to být číslice od 1 do 9.Number can be a digit from 1 to 9.

Můžete použít všechny parametry, které jsou uvedeny pro parametr -consoleloggerparameters .You can use all parameters that are listed for -consoleloggerparameters . Můžete také použít jeden nebo více z následujících parametrů:You can also use one or more of the following parameters:

- Soubor protokolu .- LogFile . Cesta k souboru protokolu, do nějž je zapsán protokol sestavení.The path to the log file into which the build log is written. Protokolovací nástroj distribuovaného souboru přihlašuje tuto cestu k názvům jeho souborů protokolu.The distributed file logger prefixes this path to the names of its log files.
- Připojit .- Append . Určuje, zda je protokol sestavení připojen k souboru protokolu nebo Přepisuje.Determines whether the build log is appended to the log file or overwrites it. Při nastavení přepínače je protokol sestavení připojen do souboru protokolu.When you set the switch, the build log is appended to the log file. Pokud tento přepínač není k dispozici, obsah stávajícího souboru protokolu bude přepsán.When the switch is not present, the contents of an existing log file are overwritten.
Příklad: msbuild myfile.proj -flp:FileLogger,Microsoft.Build;logfile=MyLog.log;appendExample: msbuild myfile.proj -flp:FileLogger,Microsoft.Build;logfile=MyLog.log;append
Pokud zahrnete explicitní true nebo false nastavení, protokol se připojí bez ohledu na nastavení.If you include an explicit true or false setting, the log is appended regardless of the setting. Pokud nezahrnete přepínač Append, protokol se přepíše.If you do not include the append switch, the log is overwritten.
V tomto případě je soubor přepsán: msbuild myfile.proj -flp:FileLogger,Microsoft.Build;logfile=MyLog.logIn this case the file is overwritten: msbuild myfile.proj -flp:FileLogger,Microsoft.Build;logfile=MyLog.log
V takovém případě je soubor připojen: msbuild myfile.proj -flp:FileLogger,Microsoft.Build;logfile=MyLog.log;append=trueIn this case the file is appended: msbuild myfile.proj -flp:FileLogger,Microsoft.Build;logfile=MyLog.log;append=true
V takovém případě je soubor připojen: msbuild myfile.proj -flp:FileLogger,Microsoft.Build;logfile=MyLog.log;append=falseIn this case the file is appended: msbuild myfile.proj -flp:FileLogger,Microsoft.Build;logfile=MyLog.log;append=false
- Kódování .- Encoding . Určuje kódování souboru (například UTF-8, Unicode nebo ASCII).Specifies the encoding for the file (for example, UTF-8, Unicode, or ASCII).

Následující příklad generuje samostatné soubory protokolu pro upozornění a chyby:The following example generates separate log files for warnings and errors:

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

Následující příklady ukazují další možnosti:The following examples show other possibilities:

-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
Nástroj-logger:

logger
llogger-l:logger Určuje protokolovací nástroj, který se má použít k protokolování událostí z MSBuild.Specifies the logger to use to log events from MSBuild. Chcete-li zadat více protokolovacích nástrojů, zadejte jednotlivé protokolovací nástroje samostatně.To specify multiple loggers, specify each logger separately.

Použijte následující syntaxi pro logger : [``LoggerClass``,]``LoggerAssembly``[;``LoggerParameters``]Use the following syntax for logger: [``LoggerClass``,]``LoggerAssembly``[;``LoggerParameters``]

Použijte následující syntaxi pro LoggerClass : [``PartialOrFullNamespace``.]``LoggerClassNameUse the following syntax for LoggerClass: [``PartialOrFullNamespace``.]``LoggerClassName

Není nutné určovat třídu protokolovacího nástroje, pokud sestavení obsahuje právě jeden protokolovací nástroj.You don't have to specify the logger class if the assembly contains exactly one logger.

Použijte následující syntaxi pro LoggerAssembly : {``AssemblyName``[,``StrongName``] &#124;``AssemblyFile``}Use the following syntax for LoggerAssembly: {``AssemblyName``[,``StrongName``] &#124; AssemblyFile``}

Parametry protokolovacího nástroje jsou volitelné a jsou předány do protokolovacího nástroje přesně tak, jak je zadáte.Logger parameters are optional and are passed to the logger exactly as you enter them.

V následujících příkladech se používá přepínač -protokolovací nástroj.The following examples use the -logger switch.

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

-logger:XMLLogger,C:\Loggers\MyLogger.dll;OutputAsHTML
-noConsoleLogger-noConsoleLogger -noconlog-noconlog Zakáže výchozí protokolovací nástroj konzoly a neprotokoluje události do konzoly.Disable the default console logger, and don't log events to the console.

Příklad 1Example 1

Následující příklad vytvoří rebuild cíl projektu MyProject. proj .The following example builds the rebuild target of the MyProject.proj project.

MSBuild.exe MyProject.proj -t:rebuild

Příklad 2Example 2

K provádění složitějších sestavení můžete použít MSBuild.exe .You can use MSBuild.exe to perform more complex builds. Můžete ho například použít k sestavení specifických cílů konkrétního projektu v řešení.For example, you can use it to build specific targets of specific projects in a solution. Následující příklad znovu sestaví projekt NotInSolutionFolder a vyčistí projekt InSolutionFolder , který je ve složce řešení NewFolder .The following example rebuilds the project NotInSolutionFolder and cleans the project InSolutionFolder, which is in the NewFolder solution folder.

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

Viz takéSee also