dotnet clean

       This article applies to: ✔️ .NET Core 3.1 SDK and later versions

NAME

       dotnet-clean - Cleans the output of a project.

SYNOPSIS

              dotnet clean [<PROJECT>|<SOLUTION>] [-c|--configuration <CONFIGURATION>]
                  [-f|--framework <FRAMEWORK>] [--interactive]
                  [--nologo] [-o|--output <OUTPUT_DIRECTORY>]
                  [-r|--runtime <RUNTIME_IDENTIFIER>] [-v|--verbosity <LEVEL>]

              dotnet clean -h|--help

DESCRIPTION

       The dotnet clean command cleans the output of the previous build.  It’s implemented as an MSBuild target,
       so  the  project  is  evaluated  when  the command is run.  Only the outputs created during the build are
       cleaned.  Both intermediate (obj) and final output (bin) folders are cleaned.

ARGUMENTS

       PROJECT | SOLUTION

       The MSBuild project or solution to clean.  If a project  or  solution  file  is  not  specified,  MSBuild
       searches the current working directory for a file that has a file extension that ends in proj or sln, and
       uses that file.

OPTIONS

       • -c|--configuration <CONFIGURATION>

         Defines  the  build  configuration.   The  default for most projects is Debug, but you can override the
         build configuration settings in your project.  This option is only required when cleaning if you speci‐
         fied it during build time.

       • -f|--framework <FRAMEWORK>

         The framework that was specified at build time.  The framework must be defined in the project file.  If
         you specified the framework at build time, you must specify the framework when cleaning.

       • -?|-h|--help

         Prints out a description of how to use the command.

       • --interactive

         Allows the command to stop and wait for user input or action.  For example, to complete authentication.
         Available since .NET Core 3.0 SDK.

       • --nologo

         Doesn’t display the startup banner or the copyright message.

       • -o|--output <OUTPUT_DIRECTORY>

         The directory that contains the build artifacts  to  clean.   Specify  the  -f|--framework  <FRAMEWORK>
         switch with the output directory switch if you specified the framework when the project was built.

       • -r|--runtime <RUNTIME_IDENTIFIER>

         Cleans  the  output folder of the specified runtime.  This is used when a self-contained deployment was
         created.

       • -v|--verbosity <LEVEL>

         Sets the verbosity level of the command.  Allowed values are q[uiet], m[inimal], n[ormal],  d[etailed],
         and  diag[nostic].   The  default  is  normal.   For more information, see <xref:Microsoft.Build.Frame‐
         work.LoggerVerbosity>.

EXAMPLES

       • Clean a default build of the project:

                dotnet clean

       • Clean a project built using the Release configuration:

                dotnet clean --configuration Release

                                                   2022-10-10                                    dotnet-clean(1)