PowerBuild.dll-Help.xml
<?xml version="1.0" encoding="utf-8"?>
<helpItems schema="maml" xmlns="http://msh"> <!-- Cmdlet: New-ConsoleLogger --> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <command:details> <command:name>New-ConsoleLogger</command:name> <command:verb>New</command:verb> <command:noun>ConsoleLogger</command:noun> <maml:description> <maml:para>Create new console logger.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Create new configured console logger. Parameters are equivalent of msbuild.exe's /consoleloggerparameters:<parameters> switch.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>New-ConsoleLogger</maml:name> <!-- Parameter: Verbosity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="0"> <maml:name>Verbosity</maml:name> <maml:description> <maml:para>Overrides the Verbosity setting for this logger. Default verbosity is Normal.</maml:para> <maml:para>Possible values: Quiet, Minimal, Normal, Detailed, Diagnostic</maml:para> </maml:description> <command:parameterValue required="true">LoggerVerbosity</command:parameterValue> <dev:type> <maml:name>Microsoft.Build.Framework.LoggerVerbosity</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>Normal</dev:defaultValue> <command:parameterValueGroup> <command:parameterValue required="false" variableLength="false">Quiet</command:parameterValue> <command:parameterValue required="false" variableLength="false">Minimal</command:parameterValue> <command:parameterValue required="false" variableLength="false">Normal</command:parameterValue> <command:parameterValue required="false" variableLength="false">Detailed</command:parameterValue> <command:parameterValue required="false" variableLength="false">Diagnostic</command:parameterValue> </command:parameterValueGroup> </command:parameter> <!-- Parameter: DisableConsoleColor --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>DisableConsoleColor</maml:name> <maml:description> <maml:para>Use the default console colors for all logging messages.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: DisableMPLogging --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>DisableMPLogging</maml:name> <maml:description> <maml:para>Disable the multiprocessor logging style of output when running in non - multiprocessor mode.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: EnableMPLogging --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>EnableMPLogging</maml:name> <maml:description> <maml:para>Enable the multiprocessor logging style even when running in non - multiprocessor mode.This logging style is on by default.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: ErrorsOnly --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ErrorsOnly</maml:name> <maml:description> <maml:para>Show only errors.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: ForceConsoleColor --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ForceConsoleColor</maml:name> <maml:description> <maml:para>Use ANSI console colors even if console does not support it.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: ForceNoAlign --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ForceNoAlign</maml:name> <maml:description> <maml:para>Does not align the text to the size of the console buffer.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: NoItemAndPropertyList --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>NoItemAndPropertyList</maml:name> <maml:description> <maml:para>Don't show list of items and properties at the start of each project build.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: NoSummary --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>NoSummary</maml:name> <maml:description> <maml:para>Don't show error and warning summary at the end.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: PerformanceSummary --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>PerformanceSummary</maml:name> <maml:description> <maml:para>Show time spent in tasks, targets and projects.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: ShowCommandLine --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ShowCommandLine</maml:name> <maml:description> <maml:para>Show TaskCommandLineEvent messages.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: ShowEventId --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ShowEventId</maml:name> <maml:description> <maml:para>Show eventId for started events, finished events, and messages.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: ShowTimestamp --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ShowTimestamp</maml:name> <maml:description> <maml:para>Display the Timestamp as a prefix to any message.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Summary --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Summary</maml:name> <maml:description> <maml:para>Show error and warning summary at the end.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: WarningsOnly --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>WarningsOnly</maml:name> <maml:description> <maml:para>Show only warnings.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: DisableConsoleColor --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>DisableConsoleColor</maml:name> <maml:description> <maml:para>Use the default console colors for all logging messages.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: DisableMPLogging --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>DisableMPLogging</maml:name> <maml:description> <maml:para>Disable the multiprocessor logging style of output when running in non - multiprocessor mode.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: EnableMPLogging --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>EnableMPLogging</maml:name> <maml:description> <maml:para>Enable the multiprocessor logging style even when running in non - multiprocessor mode.This logging style is on by default.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: ErrorsOnly --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ErrorsOnly</maml:name> <maml:description> <maml:para>Show only errors.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: ForceConsoleColor --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ForceConsoleColor</maml:name> <maml:description> <maml:para>Use ANSI console colors even if console does not support it.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: ForceNoAlign --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ForceNoAlign</maml:name> <maml:description> <maml:para>Does not align the text to the size of the console buffer.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: NoItemAndPropertyList --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>NoItemAndPropertyList</maml:name> <maml:description> <maml:para>Don't show list of items and properties at the start of each project build.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: NoSummary --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>NoSummary</maml:name> <maml:description> <maml:para>Don't show error and warning summary at the end.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: PerformanceSummary --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>PerformanceSummary</maml:name> <maml:description> <maml:para>Show time spent in tasks, targets and projects.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: ShowCommandLine --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ShowCommandLine</maml:name> <maml:description> <maml:para>Show TaskCommandLineEvent messages.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: ShowEventId --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ShowEventId</maml:name> <maml:description> <maml:para>Show eventId for started events, finished events, and messages.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: ShowTimestamp --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ShowTimestamp</maml:name> <maml:description> <maml:para>Display the Timestamp as a prefix to any message.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Summary --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Summary</maml:name> <maml:description> <maml:para>Show error and warning summary at the end.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Verbosity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="0"> <maml:name>Verbosity</maml:name> <maml:description> <maml:para>Overrides the Verbosity setting for this logger. Default verbosity is Normal.</maml:para> <maml:para>Possible values: Quiet, Minimal, Normal, Detailed, Diagnostic</maml:para> </maml:description> <command:parameterValue required="true">LoggerVerbosity</command:parameterValue> <dev:type> <maml:name>Microsoft.Build.Framework.LoggerVerbosity</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>Normal</dev:defaultValue> <command:parameterValueGroup> <command:parameterValue required="false" variableLength="false">Quiet</command:parameterValue> <command:parameterValue required="false" variableLength="false">Minimal</command:parameterValue> <command:parameterValue required="false" variableLength="false">Normal</command:parameterValue> <command:parameterValue required="false" variableLength="false">Detailed</command:parameterValue> <command:parameterValue required="false" variableLength="false">Diagnostic</command:parameterValue> </command:parameterValueGroup> </command:parameter> <!-- Parameter: WarningsOnly --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>WarningsOnly</maml:name> <maml:description> <maml:para>Show only warnings.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <!-- OutputType: ILogger --> <command:returnValue> <dev:type> <maml:name>Microsoft.Build.Framework.ILogger</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>New-ConsoleLogger -Verbosity Minimal -PerformanceSummary</dev:code> </command:example> </command:examples> </command:command> <!-- Cmdlet: New-FileLogger --> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <command:details> <command:name>New-FileLogger</command:name> <command:verb>New</command:verb> <command:noun>FileLogger</command:noun> <maml:description> <maml:para>Create new file logger.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Create new configured file logger. Parameters are equivalent of msbuild.exe's /fileloggerparameters:<parameters> switch.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>New-FileLogger</maml:name> <!-- Parameter: LogFile --> <command:parameter required="true" globbing="false" pipelineInput="false" position="0"> <maml:name>LogFile</maml:name> <maml:description> <maml:para>Path to the log file into which the build log will be written.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Verbosity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="0"> <maml:name>Verbosity</maml:name> <maml:description> <maml:para>Overrides the Verbosity setting for this logger. Default verbosity is Detailed.</maml:para> <maml:para>Possible values: Quiet, Minimal, Normal, Detailed, Diagnostic</maml:para> </maml:description> <command:parameterValue required="true">LoggerVerbosity</command:parameterValue> <dev:type> <maml:name>Microsoft.Build.Framework.LoggerVerbosity</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>Detailed</dev:defaultValue> <command:parameterValueGroup> <command:parameterValue required="false" variableLength="false">Quiet</command:parameterValue> <command:parameterValue required="false" variableLength="false">Minimal</command:parameterValue> <command:parameterValue required="false" variableLength="false">Normal</command:parameterValue> <command:parameterValue required="false" variableLength="false">Detailed</command:parameterValue> <command:parameterValue required="false" variableLength="false">Diagnostic</command:parameterValue> </command:parameterValueGroup> </command:parameter> <!-- Parameter: Append --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Append</maml:name> <maml:description> <maml:para>Determines if the build log will be appended to or overwrite the log file.Setting the switch appends the build log to the log file; Not setting the switch overwrites the contents of an existing log file. The default is not to append to the log file.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: DisableConsoleColor --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>DisableConsoleColor</maml:name> <maml:description> <maml:para>Use the default console colors for all logging messages.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: DisableMPLogging --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>DisableMPLogging</maml:name> <maml:description> <maml:para>Disable the multiprocessor logging style of output when running in non - multiprocessor mode.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: EnableMPLogging --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>EnableMPLogging</maml:name> <maml:description> <maml:para>Enable the multiprocessor logging style even when running in non - multiprocessor mode.This logging style is on by default.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Encoding --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Encoding</maml:name> <maml:description> <maml:para>Specifies the encoding for the file, for example, UTF-8, Unicode, or ASCII</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: ErrorsOnly --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ErrorsOnly</maml:name> <maml:description> <maml:para>Show only errors.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: ForceConsoleColor --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ForceConsoleColor</maml:name> <maml:description> <maml:para>Use ANSI console colors even if console does not support it.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: ForceNoAlign --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ForceNoAlign</maml:name> <maml:description> <maml:para>Does not align the text to the size of the console buffer.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: NoItemAndPropertyList --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>NoItemAndPropertyList</maml:name> <maml:description> <maml:para>Don't show list of items and properties at the start of each project build.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: NoSummary --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>NoSummary</maml:name> <maml:description> <maml:para>Don't show error and warning summary at the end.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: PerformanceSummary --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>PerformanceSummary</maml:name> <maml:description> <maml:para>Show time spent in tasks, targets and projects.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: ShowCommandLine --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ShowCommandLine</maml:name> <maml:description> <maml:para>Show TaskCommandLineEvent messages.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: ShowEventId --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ShowEventId</maml:name> <maml:description> <maml:para>Show eventId for started events, finished events, and messages.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: ShowTimestamp --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ShowTimestamp</maml:name> <maml:description> <maml:para>Display the Timestamp as a prefix to any message.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Summary --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Summary</maml:name> <maml:description> <maml:para>Show error and warning summary at the end.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: WarningsOnly --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>WarningsOnly</maml:name> <maml:description> <maml:para>Show only warnings.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: Append --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Append</maml:name> <maml:description> <maml:para>Determines if the build log will be appended to or overwrite the log file.Setting the switch appends the build log to the log file; Not setting the switch overwrites the contents of an existing log file. The default is not to append to the log file.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: DisableConsoleColor --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>DisableConsoleColor</maml:name> <maml:description> <maml:para>Use the default console colors for all logging messages.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: DisableMPLogging --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>DisableMPLogging</maml:name> <maml:description> <maml:para>Disable the multiprocessor logging style of output when running in non - multiprocessor mode.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: EnableMPLogging --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>EnableMPLogging</maml:name> <maml:description> <maml:para>Enable the multiprocessor logging style even when running in non - multiprocessor mode.This logging style is on by default.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Encoding --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Encoding</maml:name> <maml:description> <maml:para>Specifies the encoding for the file, for example, UTF-8, Unicode, or ASCII</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: ErrorsOnly --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ErrorsOnly</maml:name> <maml:description> <maml:para>Show only errors.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: ForceConsoleColor --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ForceConsoleColor</maml:name> <maml:description> <maml:para>Use ANSI console colors even if console does not support it.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: ForceNoAlign --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ForceNoAlign</maml:name> <maml:description> <maml:para>Does not align the text to the size of the console buffer.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: LogFile --> <command:parameter required="true" globbing="false" pipelineInput="false" position="0"> <maml:name>LogFile</maml:name> <maml:description> <maml:para>Path to the log file into which the build log will be written.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: NoItemAndPropertyList --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>NoItemAndPropertyList</maml:name> <maml:description> <maml:para>Don't show list of items and properties at the start of each project build.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: NoSummary --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>NoSummary</maml:name> <maml:description> <maml:para>Don't show error and warning summary at the end.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: PerformanceSummary --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>PerformanceSummary</maml:name> <maml:description> <maml:para>Show time spent in tasks, targets and projects.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: ShowCommandLine --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ShowCommandLine</maml:name> <maml:description> <maml:para>Show TaskCommandLineEvent messages.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: ShowEventId --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ShowEventId</maml:name> <maml:description> <maml:para>Show eventId for started events, finished events, and messages.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: ShowTimestamp --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>ShowTimestamp</maml:name> <maml:description> <maml:para>Display the Timestamp as a prefix to any message.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Summary --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Summary</maml:name> <maml:description> <maml:para>Show error and warning summary at the end.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Verbosity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="0"> <maml:name>Verbosity</maml:name> <maml:description> <maml:para>Overrides the Verbosity setting for this logger. Default verbosity is Detailed.</maml:para> <maml:para>Possible values: Quiet, Minimal, Normal, Detailed, Diagnostic</maml:para> </maml:description> <command:parameterValue required="true">LoggerVerbosity</command:parameterValue> <dev:type> <maml:name>Microsoft.Build.Framework.LoggerVerbosity</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>Detailed</dev:defaultValue> <command:parameterValueGroup> <command:parameterValue required="false" variableLength="false">Quiet</command:parameterValue> <command:parameterValue required="false" variableLength="false">Minimal</command:parameterValue> <command:parameterValue required="false" variableLength="false">Normal</command:parameterValue> <command:parameterValue required="false" variableLength="false">Detailed</command:parameterValue> <command:parameterValue required="false" variableLength="false">Diagnostic</command:parameterValue> </command:parameterValueGroup> </command:parameter> <!-- Parameter: WarningsOnly --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>WarningsOnly</maml:name> <maml:description> <maml:para>Show only warnings.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <!-- OutputType: ILogger --> <command:returnValue> <dev:type> <maml:name>Microsoft.Build.Framework.ILogger</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>New-FileLogger build.log -Verbosity Normal -PerformanceSummary</dev:code> </command:example> </command:examples> </command:command> <!-- Cmdlet: New-Logger --> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <command:details> <command:name>New-Logger</command:name> <command:verb>New</command:verb> <command:noun>Logger</command:noun> <maml:description> <maml:para>Create new logger.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Create new logger using class name and assembly. Parameters are equivalent of msbuild.exe's /l:<logger> switch.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>New-Logger</maml:name> <!-- Parameter: ClassName --> <command:parameter required="false" globbing="false" pipelineInput="false" position="0"> <maml:name>ClassName</maml:name> <maml:description> <maml:para>Logger class name. Can contain partial or full namespace.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Assembly --> <command:parameter required="false" globbing="false" pipelineInput="false" position="1"> <maml:name>Assembly</maml:name> <maml:description> <maml:para>Logger assembly name or file path.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Parameters --> <command:parameter required="false" globbing="false" pipelineInput="false" position="2"> <maml:name>Parameters</maml:name> <maml:description> <maml:para>Parameters passed to logger.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Verbosity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="3"> <maml:name>Verbosity</maml:name> <maml:description> <maml:para>Overrides the Verbosity setting for this logger. Default verbosity is Normal.</maml:para> <maml:para>Possible values: Quiet, Minimal, Normal, Detailed, Diagnostic</maml:para> </maml:description> <command:parameterValue required="true">LoggerVerbosity</command:parameterValue> <dev:type> <maml:name>Microsoft.Build.Framework.LoggerVerbosity</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>Normal</dev:defaultValue> <command:parameterValueGroup> <command:parameterValue required="false" variableLength="false">Quiet</command:parameterValue> <command:parameterValue required="false" variableLength="false">Minimal</command:parameterValue> <command:parameterValue required="false" variableLength="false">Normal</command:parameterValue> <command:parameterValue required="false" variableLength="false">Detailed</command:parameterValue> <command:parameterValue required="false" variableLength="false">Diagnostic</command:parameterValue> </command:parameterValueGroup> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: Assembly --> <command:parameter required="false" globbing="false" pipelineInput="false" position="1"> <maml:name>Assembly</maml:name> <maml:description> <maml:para>Logger assembly name or file path.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: ClassName --> <command:parameter required="false" globbing="false" pipelineInput="false" position="0"> <maml:name>ClassName</maml:name> <maml:description> <maml:para>Logger class name. Can contain partial or full namespace.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Parameters --> <command:parameter required="false" globbing="false" pipelineInput="false" position="2"> <maml:name>Parameters</maml:name> <maml:description> <maml:para>Parameters passed to logger.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Verbosity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="3"> <maml:name>Verbosity</maml:name> <maml:description> <maml:para>Overrides the Verbosity setting for this logger. Default verbosity is Normal.</maml:para> <maml:para>Possible values: Quiet, Minimal, Normal, Detailed, Diagnostic</maml:para> </maml:description> <command:parameterValue required="true">LoggerVerbosity</command:parameterValue> <dev:type> <maml:name>Microsoft.Build.Framework.LoggerVerbosity</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>Normal</dev:defaultValue> <command:parameterValueGroup> <command:parameterValue required="false" variableLength="false">Quiet</command:parameterValue> <command:parameterValue required="false" variableLength="false">Minimal</command:parameterValue> <command:parameterValue required="false" variableLength="false">Normal</command:parameterValue> <command:parameterValue required="false" variableLength="false">Detailed</command:parameterValue> <command:parameterValue required="false" variableLength="false">Diagnostic</command:parameterValue> </command:parameterValueGroup> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <!-- OutputType: ILogger --> <command:returnValue> <dev:type> <maml:name>Microsoft.Build.Framework.ILogger</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>New-Logger -ClassName FileLogger -Assembly Microsoft.Build.Engine -Parameters "LogFile=MyLog.log;Append;Verbosity=diagnostic;Encoding=UTF-8"</dev:code> </command:example> </command:examples> </command:command> <!-- Cmdlet: Invoke-MSBuild --> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <command:details> <command:name>Invoke-MSBuild</command:name> <command:verb>Invoke</command:verb> <command:noun>MSBuild</command:noun> <maml:description> <maml:para>Use MSBuild to build a project.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Builds the specified targets in the project file. If a project file is not specified, MSBuild searches the current working directory for a file that has a file extension that ends in "proj" and uses that file.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Invoke-MSBuild</maml:name> <!-- Parameter: Project --> <command:parameter required="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="0" aliases="FullName"> <maml:name>Project</maml:name> <maml:description> <maml:para>Project to build.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Target --> <command:parameter required="false" globbing="false" pipelineInput="false" position="1" aliases="t"> <maml:name>Target</maml:name> <maml:description> <maml:para>Build these targets in the project.</maml:para> </maml:description> <command:parameterValue required="true">string[]</command:parameterValue> <dev:type> <maml:name>System.String[]</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Configuration --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Configuration</maml:name> <maml:description> <maml:para>Set build Configuration property.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: DefaultLogger --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="dl"> <maml:name>DefaultLogger</maml:name> <maml:description> <maml:para>Possible values: None, Streams, Host</maml:para> </maml:description> <command:parameterValue required="true">DefaultLoggerType</command:parameterValue> <dev:type> <maml:name>PowerBuild.DefaultLoggerType</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>Streams</dev:defaultValue> <command:parameterValueGroup> <command:parameterValue required="false" variableLength="false">None</command:parameterValue> <command:parameterValue required="false" variableLength="false">Streams</command:parameterValue> <command:parameterValue required="false" variableLength="false">Host</command:parameterValue> </command:parameterValueGroup> </command:parameter> <!-- Parameter: DefaultLoggerParameters --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="dlp"> <maml:name>DefaultLoggerParameters</maml:name> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: DetailedSummary --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="ds"> <maml:name>DetailedSummary</maml:name> <maml:description> <maml:para>Shows detailed information at the end of the build about the configurations built and how they were scheduled to nodes.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: IgnoreProjectExtensions --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="ignore"> <maml:name>IgnoreProjectExtensions</maml:name> <maml:description> <maml:para>List of extensions to ignore when determining which project file to build.</maml:para> </maml:description> <command:parameterValue required="true">string[]</command:parameterValue> <dev:type> <maml:name>System.String[]</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Logger --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="l"> <maml:name>Logger</maml:name> <maml:description> <maml:para>Use this loggers to log events from MSBuild.</maml:para> </maml:description> <command:parameterValue required="true">ILogger[]</command:parameterValue> <dev:type> <maml:name>Microsoft.Build.Framework.ILogger[]</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: MaxCpuCount --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="m"> <maml:name>MaxCpuCount</maml:name> <maml:description> <maml:para>Specifies the maximum number of concurrent processes to build with.</maml:para> <maml:para>There is a bug in MSBuild 15.1 that causes build to fail if value is set above 1.</maml:para> </maml:description> <command:parameterValue required="true">int</command:parameterValue> <dev:type> <maml:name>System.Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>1</dev:defaultValue> </command:parameter> <!-- Parameter: NodeReuse --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="nr"> <maml:name>NodeReuse</maml:name> <maml:description> <maml:para>Enables or Disables the reuse of MSBuild nodes.</maml:para> </maml:description> <command:parameterValue required="true">bool</command:parameterValue> <dev:type> <maml:name>System.Boolean</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Platform --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Platform</maml:name> <maml:description> <maml:para>Set build Platform property.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Property --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="p"> <maml:name>Property</maml:name> <maml:description> <maml:para>Set or override these project-level properties.</maml:para> </maml:description> <command:parameterValue required="true">Hashtable</command:parameterValue> <dev:type> <maml:name>System.Collections.Hashtable</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: ToolsVersion --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="tv"> <maml:name>ToolsVersion</maml:name> <maml:description> <maml:para>The version of the MSBuild Toolset (tasks, targets, etc.) to use during build.This version will override the versions specified by individual projects.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>15.0</dev:defaultValue> </command:parameter> <!-- Parameter: Verbosity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="v"> <maml:name>Verbosity</maml:name> <maml:description> <maml:para>Display this amount of information in the event log.</maml:para> <maml:para>Possible values: Quiet, Minimal, Normal, Detailed, Diagnostic</maml:para> </maml:description> <command:parameterValue required="true">LoggerVerbosity</command:parameterValue> <dev:type> <maml:name>Microsoft.Build.Framework.LoggerVerbosity</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>Normal</dev:defaultValue> <command:parameterValueGroup> <command:parameterValue required="false" variableLength="false">Quiet</command:parameterValue> <command:parameterValue required="false" variableLength="false">Minimal</command:parameterValue> <command:parameterValue required="false" variableLength="false">Normal</command:parameterValue> <command:parameterValue required="false" variableLength="false">Detailed</command:parameterValue> <command:parameterValue required="false" variableLength="false">Diagnostic</command:parameterValue> </command:parameterValueGroup> </command:parameter> <!-- Parameter: WarningsAsErrors --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="err"> <maml:name>WarningsAsErrors</maml:name> <maml:description> <maml:para>List of warning codes to treats as errors. To treat all warnings as errors use the switch with empty list '-WarningsAsErrors @()'.</maml:para> </maml:description> <command:parameterValue required="true">string[]</command:parameterValue> <dev:type> <maml:name>System.String[]</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: WarningsAsMessages --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="nowarn"> <maml:name>WarningsAsMessages</maml:name> <maml:description> <maml:para>List of warning codes to treats as low importance messages.</maml:para> </maml:description> <command:parameterValue required="true">string[]</command:parameterValue> <dev:type> <maml:name>System.String[]</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: DefaultLogger --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="dl"> <maml:name>DefaultLogger</maml:name> <maml:description> <maml:para>Possible values: None, Streams, Host</maml:para> </maml:description> <command:parameterValue required="true">DefaultLoggerType</command:parameterValue> <dev:type> <maml:name>PowerBuild.DefaultLoggerType</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>Streams</dev:defaultValue> <command:parameterValueGroup> <command:parameterValue required="false" variableLength="false">None</command:parameterValue> <command:parameterValue required="false" variableLength="false">Streams</command:parameterValue> <command:parameterValue required="false" variableLength="false">Host</command:parameterValue> </command:parameterValueGroup> </command:parameter> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="dl"> <maml:name>dl</maml:name> <maml:description> <maml:para>Possible values: None, Streams, Host</maml:para> <maml:para>This is an alias of the DefaultLogger parameter.</maml:para> </maml:description> <command:parameterValue required="true">DefaultLoggerType</command:parameterValue> <dev:type> <maml:name>PowerBuild.DefaultLoggerType</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>Streams</dev:defaultValue> <command:parameterValueGroup> <command:parameterValue required="false" variableLength="false">None</command:parameterValue> <command:parameterValue required="false" variableLength="false">Streams</command:parameterValue> <command:parameterValue required="false" variableLength="false">Host</command:parameterValue> </command:parameterValueGroup> </command:parameter> <!-- Parameter: DefaultLoggerParameters --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="dlp"> <maml:name>DefaultLoggerParameters</maml:name> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="dlp"> <maml:name>dlp</maml:name> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <maml:description> <maml:para>This is an alias of the DefaultLoggerParameters parameter.</maml:para> </maml:description> </command:parameter> <!-- Parameter: DetailedSummary --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="ds"> <maml:name>DetailedSummary</maml:name> <maml:description> <maml:para>Shows detailed information at the end of the build about the configurations built and how they were scheduled to nodes.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="ds"> <maml:name>ds</maml:name> <maml:description> <maml:para>Shows detailed information at the end of the build about the configurations built and how they were scheduled to nodes.</maml:para> <maml:para>This is an alias of the DetailedSummary parameter.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: IgnoreProjectExtensions --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="ignore"> <maml:name>IgnoreProjectExtensions</maml:name> <maml:description> <maml:para>List of extensions to ignore when determining which project file to build.</maml:para> </maml:description> <command:parameterValue required="true">string[]</command:parameterValue> <dev:type> <maml:name>System.String[]</maml:name> <maml:uri /> </dev:type> </command:parameter> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="ignore"> <maml:name>ignore</maml:name> <maml:description> <maml:para>List of extensions to ignore when determining which project file to build.</maml:para> <maml:para>This is an alias of the IgnoreProjectExtensions parameter.</maml:para> </maml:description> <command:parameterValue required="true">string[]</command:parameterValue> <dev:type> <maml:name>System.String[]</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Logger --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="l"> <maml:name>Logger</maml:name> <maml:description> <maml:para>Use this loggers to log events from MSBuild.</maml:para> </maml:description> <command:parameterValue required="true">ILogger[]</command:parameterValue> <dev:type> <maml:name>Microsoft.Build.Framework.ILogger[]</maml:name> <maml:uri /> </dev:type> </command:parameter> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="l"> <maml:name>l</maml:name> <maml:description> <maml:para>Use this loggers to log events from MSBuild.</maml:para> <maml:para>This is an alias of the Logger parameter.</maml:para> </maml:description> <command:parameterValue required="true">ILogger[]</command:parameterValue> <dev:type> <maml:name>Microsoft.Build.Framework.ILogger[]</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: MaxCpuCount --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="m"> <maml:name>MaxCpuCount</maml:name> <maml:description> <maml:para>Specifies the maximum number of concurrent processes to build with.</maml:para> <maml:para>There is a bug in MSBuild 15.1 that causes build to fail if value is set above 1.</maml:para> </maml:description> <command:parameterValue required="true">int</command:parameterValue> <dev:type> <maml:name>System.Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>1</dev:defaultValue> </command:parameter> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="m"> <maml:name>m</maml:name> <maml:description> <maml:para>Specifies the maximum number of concurrent processes to build with.</maml:para> <maml:para>There is a bug in MSBuild 15.1 that causes build to fail if value is set above 1.</maml:para> <maml:para>This is an alias of the MaxCpuCount parameter.</maml:para> </maml:description> <command:parameterValue required="true">int</command:parameterValue> <dev:type> <maml:name>System.Int32</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>1</dev:defaultValue> </command:parameter> <!-- Parameter: NodeReuse --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="nr"> <maml:name>NodeReuse</maml:name> <maml:description> <maml:para>Enables or Disables the reuse of MSBuild nodes.</maml:para> </maml:description> <command:parameterValue required="true">bool</command:parameterValue> <dev:type> <maml:name>System.Boolean</maml:name> <maml:uri /> </dev:type> </command:parameter> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="nr"> <maml:name>nr</maml:name> <maml:description> <maml:para>Enables or Disables the reuse of MSBuild nodes.</maml:para> <maml:para>This is an alias of the NodeReuse parameter.</maml:para> </maml:description> <command:parameterValue required="true">bool</command:parameterValue> <dev:type> <maml:name>System.Boolean</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Project --> <command:parameter required="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="0" aliases="FullName"> <maml:name>Project</maml:name> <maml:description> <maml:para>Project to build.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <command:parameter required="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="0" aliases="FullName"> <maml:name>FullName</maml:name> <maml:description> <maml:para>Project to build.</maml:para> <maml:para>This is an alias of the Project parameter.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Property --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="p"> <maml:name>Property</maml:name> <maml:description> <maml:para>Set or override these project-level properties.</maml:para> </maml:description> <command:parameterValue required="true">Hashtable</command:parameterValue> <dev:type> <maml:name>System.Collections.Hashtable</maml:name> <maml:uri /> </dev:type> </command:parameter> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="p"> <maml:name>p</maml:name> <maml:description> <maml:para>Set or override these project-level properties.</maml:para> <maml:para>This is an alias of the Property parameter.</maml:para> </maml:description> <command:parameterValue required="true">Hashtable</command:parameterValue> <dev:type> <maml:name>System.Collections.Hashtable</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Target --> <command:parameter required="false" globbing="false" pipelineInput="false" position="1" aliases="t"> <maml:name>Target</maml:name> <maml:description> <maml:para>Build these targets in the project.</maml:para> </maml:description> <command:parameterValue required="true">string[]</command:parameterValue> <dev:type> <maml:name>System.String[]</maml:name> <maml:uri /> </dev:type> </command:parameter> <command:parameter required="false" globbing="false" pipelineInput="false" position="1" aliases="t"> <maml:name>t</maml:name> <maml:description> <maml:para>Build these targets in the project.</maml:para> <maml:para>This is an alias of the Target parameter.</maml:para> </maml:description> <command:parameterValue required="true">string[]</command:parameterValue> <dev:type> <maml:name>System.String[]</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: ToolsVersion --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="tv"> <maml:name>ToolsVersion</maml:name> <maml:description> <maml:para>The version of the MSBuild Toolset (tasks, targets, etc.) to use during build.This version will override the versions specified by individual projects.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>15.0</dev:defaultValue> </command:parameter> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="tv"> <maml:name>tv</maml:name> <maml:description> <maml:para>The version of the MSBuild Toolset (tasks, targets, etc.) to use during build.This version will override the versions specified by individual projects.</maml:para> <maml:para>This is an alias of the ToolsVersion parameter.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>15.0</dev:defaultValue> </command:parameter> <!-- Parameter: Verbosity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="v"> <maml:name>Verbosity</maml:name> <maml:description> <maml:para>Display this amount of information in the event log.</maml:para> <maml:para>Possible values: Quiet, Minimal, Normal, Detailed, Diagnostic</maml:para> </maml:description> <command:parameterValue required="true">LoggerVerbosity</command:parameterValue> <dev:type> <maml:name>Microsoft.Build.Framework.LoggerVerbosity</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>Normal</dev:defaultValue> <command:parameterValueGroup> <command:parameterValue required="false" variableLength="false">Quiet</command:parameterValue> <command:parameterValue required="false" variableLength="false">Minimal</command:parameterValue> <command:parameterValue required="false" variableLength="false">Normal</command:parameterValue> <command:parameterValue required="false" variableLength="false">Detailed</command:parameterValue> <command:parameterValue required="false" variableLength="false">Diagnostic</command:parameterValue> </command:parameterValueGroup> </command:parameter> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="v"> <maml:name>v</maml:name> <maml:description> <maml:para>Display this amount of information in the event log.</maml:para> <maml:para>Possible values: Quiet, Minimal, Normal, Detailed, Diagnostic</maml:para> <maml:para>This is an alias of the Verbosity parameter.</maml:para> </maml:description> <command:parameterValue required="true">LoggerVerbosity</command:parameterValue> <dev:type> <maml:name>Microsoft.Build.Framework.LoggerVerbosity</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>Normal</dev:defaultValue> <command:parameterValueGroup> <command:parameterValue required="false" variableLength="false">Quiet</command:parameterValue> <command:parameterValue required="false" variableLength="false">Minimal</command:parameterValue> <command:parameterValue required="false" variableLength="false">Normal</command:parameterValue> <command:parameterValue required="false" variableLength="false">Detailed</command:parameterValue> <command:parameterValue required="false" variableLength="false">Diagnostic</command:parameterValue> </command:parameterValueGroup> </command:parameter> <!-- Parameter: WarningsAsErrors --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="err"> <maml:name>WarningsAsErrors</maml:name> <maml:description> <maml:para>List of warning codes to treats as errors. To treat all warnings as errors use the switch with empty list '-WarningsAsErrors @()'.</maml:para> </maml:description> <command:parameterValue required="true">string[]</command:parameterValue> <dev:type> <maml:name>System.String[]</maml:name> <maml:uri /> </dev:type> </command:parameter> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="err"> <maml:name>err</maml:name> <maml:description> <maml:para>List of warning codes to treats as errors. To treat all warnings as errors use the switch with empty list '-WarningsAsErrors @()'.</maml:para> <maml:para>This is an alias of the WarningsAsErrors parameter.</maml:para> </maml:description> <command:parameterValue required="true">string[]</command:parameterValue> <dev:type> <maml:name>System.String[]</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: WarningsAsMessages --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="nowarn"> <maml:name>WarningsAsMessages</maml:name> <maml:description> <maml:para>List of warning codes to treats as low importance messages.</maml:para> </maml:description> <command:parameterValue required="true">string[]</command:parameterValue> <dev:type> <maml:name>System.String[]</maml:name> <maml:uri /> </dev:type> </command:parameter> <command:parameter required="false" globbing="false" pipelineInput="false" position="named" aliases="nowarn"> <maml:name>nowarn</maml:name> <maml:description> <maml:para>List of warning codes to treats as low importance messages.</maml:para> <maml:para>This is an alias of the WarningsAsMessages parameter.</maml:para> </maml:description> <command:parameterValue required="true">string[]</command:parameterValue> <dev:type> <maml:name>System.String[]</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Configuration --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Configuration</maml:name> <maml:description> <maml:para>Set build Configuration property.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Platform --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Platform</maml:name> <maml:description> <maml:para>Set build Platform property.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <maml:description> <maml:para>Project to build.</maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <!-- OutputType: BuildResult --> <command:returnValue> <dev:type> <maml:name>PowerBuild.BuildResult</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Invoke-MSBuild -Project Project.sln -Target Build -Property @{Configuration="Release"} -Verbosity Minimal</dev:code> </command:example> </command:examples> </command:command> <!-- Cmdlet: New-StructuredLogger --> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"> <command:details> <command:name>New-StructuredLogger</command:name> <command:verb>New</command:verb> <command:noun>StructuredLogger</command:noun> <maml:description> <maml:para>Create new structured logger.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Create new structured logger. For more details see MSBuildStructuredLog.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>New-StructuredLogger</maml:name> <!-- Parameter: LogFile --> <command:parameter required="true" globbing="false" pipelineInput="false" position="0"> <maml:name>LogFile</maml:name> <maml:description> <maml:para>Path to the log file into which the build log will be written. Logger supports two formats: *.xml (for large human-readable XML logs) and *.buildlog (compact binary logs). Depending on which file extension you pass to the logger it will either write XML or binary.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: LogFile --> <command:parameter required="true" globbing="false" pipelineInput="false" position="0"> <maml:name>LogFile</maml:name> <maml:description> <maml:para>Path to the log file into which the build log will be written. Logger supports two formats: *.xml (for large human-readable XML logs) and *.buildlog (compact binary logs). Depending on which file extension you pass to the logger it will either write XML or binary.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <!-- OutputType: ILogger --> <command:returnValue> <dev:type> <maml:name>Microsoft.Build.Framework.ILogger</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>New-StructuredLogger -LogFile 1.buildlog</dev:code> </command:example> </command:examples> </command:command> </helpItems> |