Skip to content

Commit 7e5308a

Browse files
Document --bl parameter for dotnet build (#50249)
* Fix linting and addressed feedback * Fix command syntax for dotnet build options --------- Co-authored-by: Meaghan Osagie (Lewis) <[email protected]>
1 parent 2bf43f2 commit 7e5308a

File tree

1 file changed

+14
-1
lines changed

1 file changed

+14
-1
lines changed

docs/core/tools/dotnet-build.md

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ ms.date: 09/24/2025
1515

1616
```dotnetcli
1717
dotnet build [<PROJECT>|<SOLUTION>|<FILE>] [-a|--arch <ARCHITECTURE>]
18-
[--artifacts-path <ARTIFACTS_DIR>]
18+
[--artifacts-path <ARTIFACTS_DIR>] [-bl|--binaryLogger:<FILE>]
1919
[-c|--configuration <CONFIGURATION>] [--disable-build-servers]
2020
[-f|--framework <FRAMEWORK>] [--force] [--interactive]
2121
[--no-dependencies] [--no-incremental] [--no-restore] [--nologo]
@@ -81,6 +81,19 @@ Running `dotnet build` is equivalent to running `dotnet msbuild -restore`; howev
8181

8282
- [!INCLUDE [artifacts-path](../../../includes/cli-artifacts-path.md)]
8383

84+
- **`-bl|--binaryLogger:<FILE>`**
85+
86+
Enables the binary logger and optionally specifies the output file name.
87+
If no file name is provided, the default is `msbuild.binlog` in the current directory.
88+
89+
The binary log contains detailed build information and can be opened with the
90+
[MSBuild Structured Log Viewer](https://msbuildlog.com).
91+
92+
```dotnetcli
93+
dotnet build -bl
94+
dotnet build -bl:build-log.binlog
95+
```
96+
8497
- [!INCLUDE [configuration](../../../includes/cli-configuration.md)]
8598

8699
- [!INCLUDE [disable-build-servers](../../../includes/cli-disable-build-servers.md)]

0 commit comments

Comments
 (0)