Merge pull request #7450 from umbraco/cms/17-unattended-telemetry

Documented `UnattendedTelemetryLevel` setting available for unattended installs

Author: eshanrnh

17/umbraco-cms/fundamentals/setup/install/install-umbraco-with-templates.md

@@ -98,6 +98,8 @@ Template options:
   --password <password>                      Used to specify the password of the default admin user when using unattended install on
                                              development (stored as plain text).
                                              Type: string
+  --telemetry-level <telemetry-level>        Used to specify the level of telemetry the installation will report (Minimal, Basic or Detailed).
+                                             Type: string
   --no-nodes-view-path <no-nodes-view-path>  Path to a custom view presented with the Umbraco installation contains no published
                                              content.
                                              Type: string

17/umbraco-cms/fundamentals/setup/install/unattended-install.md

@@ -8,7 +8,7 @@ This article will give you the details you need to install Umbraco unattended.
 
 ## Get clean install of Umbraco
 
-In order to get a clean instance of Umbraco, follow our installation guide for how to [Install an Umbraco project template](install-umbraco-with-templates.md#install-umbraco-with-net-cli).
+In order to get a clean instance of Umbraco, follow our installation guide for how to [Install an Umbraco project template](install-umbraco-with-templates.md#install-using-net-cli).
 
 ## Configure your database
 
@@ -65,7 +65,8 @@ The unattended installs feature is disabled by default. In order to enable it, y
         "InstallUnattended": true,
         "UnattendedUserName": "FRIENDLY_NAME",
         "UnattendedUserEmail": "EMAIL",
-        "UnattendedUserPassword": "PASSWORD"
+        "UnattendedUserPassword": "PASSWORD",
+        "UnattendedTelemetryLevel": "Detailed"
       }
     }
   }
@@ -74,6 +75,8 @@ The unattended installs feature is disabled by default. In order to enable it, y
 
 Remember to set the value of `InstallUnattended` to `true`.
 
+The `UnattendedTelemetryLevel` can be set to `Minimal`, `Basic`, or `Detailed`. If omitted, `Detailed` is the default.
+
 Alternatively you may set your configuration with Environment Variables or other means. Learn more about this in the [Microsoft .Net Core config documentation](https://docs.microsoft.com/en-us/aspnet/core/fundamentals/configuration/?view=aspnetcore-5.0#environment-variables).
 
 The keys for this would then be as follows:
@@ -83,6 +86,7 @@ Umbraco__CMS__Unattended__InstallUnattended
 Umbraco__CMS__Unattended__UnattendedUserName
 Umbraco__CMS__Unattended__UnattendedUserEmail
 Umbraco__CMS__Unattended__UnattendedUserPassword
+Umbraco__CMS__Unattended__UnattendedTelemetryLevel
 ```
 
 ## Initialize the unattended install
@@ -122,7 +126,8 @@ Having intellisense will help you to add your connection string and information
                 "InstallUnattended": true,
                 "UnattendedUserName": "FRIENDLY_NAME",
                 "UnattendedUserEmail": "EMAIL",
-                "UnattendedUserPassword": "PASSWORD"
+                "UnattendedUserPassword": "PASSWORD",
+                "UnattendedTelemetryLevel": "Detailed"
             }
         }
     }
@@ -136,7 +141,7 @@ We have added support for unattended installs with Name, Email and Password, and
 ### CLI
 
 ```powershell
-dotnet new umbraco -n MyNewProject --friendly-name "Friendly User" --email [email protected] --password password1234 --connection-string "Server=(localdb)\Umbraco;Database=MyDatabase;Integrated Security=true" --version 10.0.0
+dotnet new umbraco -n MyNewProject --friendly-name "Friendly User" --email [email protected] --password password1234 --telemetry-level Detailed --connection-string "Server=(localdb)\Umbraco;Database=MyDatabase;Integrated Security=true" --version 10.0.0
 ```
 
 ### Visual Studio

17/umbraco-cms/reference/configuration/unattendedsettings.md

@@ -23,7 +23,8 @@ It's important to know that the install feature will only work if there is a con
         "UpgradeUnattended": true,
         "UnattendedUserName": "A.N. Other",
         "UnattendedUserEmail": "[email protected]",
-        "UnattendedUserPassword": "APasswordMeetingRequirements"
+        "UnattendedUserPassword": "APasswordMeetingRequirements",
+        "UnattendedTelemetryLevel": "Detailed"
       }
     }
   }
@@ -56,6 +57,10 @@ This setting is used to specify the email address of the default admin user.
 
 This setting is used to specify the password of the default admin user.
 
+## Unattended telemetry level
+
+This setting is used to specify the level of telemetry the installation will report. The `UnattendedTelemetryLevel` can be set to `Minimal`, `Basic`, or `Detailed`. If omitted, `Detailed` is the default.
+
 ### Package migrations unattended
 
 Gets or sets a value indicating whether unattended package migrations are enabled.