Initial docs for DNIM

docfx.json

@@ -222,6 +222,7 @@
                 "_vblang/spec/*.md": "language-reference",
                 "docs/architecture/**/*.md": "concept-article",
                 "docs/azure/migration/**/*.md": "upgrade-and-migration-article",
+                "docs/core/additional-tools/dnim*.md": "reference",
                 "docs/core/compatibility/**/*.md": "concept-article",
                 "docs/core/deploying/native-aot/warnings/**.md": "error-reference",
                 "docs/core/deploying/single-file/warnings/**.md": "error-reference",

docs/core/additional-tools/dnim-cli-layout.md

@@ -0,0 +1,59 @@
+---
+title: dnim layout command
+description: The layout command creates a cache for offline deployments.
+author: joeloff
+ms.date: 08/11/2026
+---
+
+# dnim layout
+
+## Name
+
+`dnim-win-[x86|x64|arm64] layout` - Creates or updates a cache for offline deployments.
+
+## Synopsis
+
+```dotnetcli
+dnim-win-[x86|x64|arm64] layout <DIRECTORY> [-a|--accept-license]
+    [--include-installers]
+    [--include-previews]
+    [-l|--log-file <LOG_FILE>] 
+    [--latest]
+    [-v|--verbosity <quiet|normal|diagnostic>]
+
+dnim-win-[x86|x64|arm64] layout -?|-h|--help
+```
+
+## Description
+
+The command creates or updates a cache used for offline deployments inside network restricted environments. The command requires internet access to download the necessary files and will verify the signatures of any installers that are downloaded. Adminitrators should place the files on a machine that is accessible from client devices inside the network.
+
+## Options
+
+- [!INCLUDE [accept-license](includes/dnim-cli-accept-license.md)]
+
+- [!INCLUDE [include-installers](includes/dnim-cli-include-installers.md)]
+
+- [!INCLUDE [include-previews](includes/dnim-cli-include-previews.md)]
+
+- [!INCLUDE [log-file](includes/dnim-cli-log-file.md)]
+
+- [!INCLUDE [latest](includes/dnim-cli-latest.md)]
+
+- [!INCLUDE [verbosity](includes/dnim-cli-verbosity.md)]
+
+## Examples
+
+- Create an offline deployment in `C:\dnim\layout` that only includes the release metadata (no installers).
+
+  ```console
+  dnim-win-[x86|x64|arm64] layout C:\dnim\layout
+  ```
+
+- Create an offline deployment in `C:\dnim\layout` that includes the latest installers.
+
+  ```console
+  dnim-win-[x86|x64|arm64] layout C:\dnim\layout --include-installers --latest
+  ```
+
+## See also

docs/core/additional-tools/dnim-cli-query-products.md

@@ -0,0 +1,89 @@
+---
+title: dnim query products command
+description: The query releases command provides information about specific .NET products.
+author: joeloff
+ms.date: 08/11/2026
+ai-usage: ai-assisted
+---
+
+# dnim query products
+
+## Name
+
+`dnim-win-[x86|x64|arm64] query products` - Queries release information about specific .NET products.
+
+## Synopsis
+
+```dotnetcli
+dnim-win-[x86|x64|arm64] query products [-a|--accept-license] 
+    [--epv|--except-product-version <PRODUCT_VERSION>] 
+    [--esp|--except-support-phase <active|eol|golive|maintenance|preview>]
+    [-o|--output-file <OUTPUT_FILE>] [--offline <LAYOUT_DIRECTORY>]
+    [--output-format <text|csv|html|json>] [--pv|--product-version <PRODUCT_VERSION>]
+    [--sp|--support-phase <active|eol|golive|maintenance|preview>]
+    [-v|--verbosity <quiet|normal|diagnostic>]
+
+dnim-win-[x86|x64|arm64] query products -?|-h|--help
+```
+
+## Description
+
+The command provides a summary of .NET products, including the latest versions, support phase and expected end-of-life date.
+
+> [!IMPORTANT]
+> The information provided by this command depends on the published releases JSON data.
+
+## Options
+
+- [!INCLUDE [accept-license](includes/dnim-cli-accept-license.md)]
+
+- [!INCLUDE [except-product-version](includes/dnim-cli-except-product-version.md)]
+
+- [!INCLUDE [except-support-phase](includes/dnim-cli-except-support-phase.md)]
+
+- [!INCLUDE [output-file](includes/dnim-cli-output-file.md)]
+
+- [!INCLUDE [offline](includes/dnim-cli-offline.md)]
+
+- [!INCLUDE [output-format](includes/dnim-cli-output-format.md)]
+
+- [!INCLUDE [product-version](includes/dnim-cli-product-version.md)]
+
+- [!INCLUDE [support-phase](includes/dnim-cli-support-phase.md)]
+
+- [!INCLUDE [verbosity](includes/dnim-cli-verbosity.md)]
+
+## Results
+
+The example below lists all products whose support phase is not `eol`. The security update column indicates whether the latest release addressed security vulnerabilities. The [`query releases`](dnim-cli-query-releases.md) command can be used to obtain a list of vulnerabilities addressed by the latest release.
+
+| Version | Support | Release type | Latest release | Latest release date | Latest SDK | Latest runtime | End of support | Security update |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| 11.0 | GoLive | STS | 11.0.0-rc.1 | 9/8/2026 | 11.0.100-rc.1.26425.128 | 11.0.0-rc.1.26425.128 | n/a | True |
+| 10.0 | Active | LTS | 10.0.12 | 9/8/2026 | 10.0.401 | 10.0.12 | 11/14/2028 | True |
+| 9.0 | Maintenance | STS | 9.0.20 | 9/8/2026 | 9.0.318 | 9.0.20 | 11/10/2026 | True |
+| 8.0 | Maintenance | LTS | 8.0.31 | 9/8/2026 | 8.0.425 | 8.0.31 | 11/10/2026 | True |
+
+## Examples
+
+- Display information for all .NET products.
+
+  ```console
+  dnim-win-[x86|x64|arm64] query products
+  ```
+
+- Display information for all products that are not end-of-life:
+
+  ```console
+  dnim-win-[x86|x64|arm64] query products --esp eol
+  ```
+
+- Only display information for the .NET 7.0 and 9.0 products.
+
+  ```console
+  dnim-win-[x86|x64|arm64] query products --pv 7.0 --pv 9.0
+  ```
+
+## See also
+
+The [`query-releases`](dnim-cli-query-releases.md) command.

docs/core/additional-tools/dnim-cli-query-releases.md

@@ -0,0 +1,89 @@
+---
+title: dnim query prreleases command
+description: The query releases command provides information about specific .NET releases.
+author: joeloff
+ms.date: 08/11/2026
+ai-usage: ai-assisted
+---
+
+# dnim query releases
+
+## Name
+
+`dnim-win-[x86|x64|arm64] query releases` - Queries release information about specific .NET products.
+
+## Synopsis
+
+```dotnetcli
+dnim-win-[x86|x64|arm64] query releases [-a|--accept-license] 
+    [--epv|--except-product-version <PRODUCT_VERSION>] 
+    [--esp|--except-support-phase <active|eol|golive|maintenance|preview>]
+    [-o|--output-file <OUTPUT_FILE>] [--offline <LAYOUT_DIRECTORY>]
+    [--output-format <text|csv|html|json>] [--pv|--product-version <PRODUCT_VERSION>]
+    [--sp|--support-phase <active|eol|golive|maintenance|preview>]
+    [-v|--verbosity <quiet|normal|diagnostic>]
+
+dnim-win-[x86|x64|arm64] query releases -?|-h|--help
+```
+
+## Description
+
+The command can be used to obtain information for specific .NET releases.
+
+> [!IMPORTANT]
+> The information provided by this command depends on the published releases JSON data.
+
+## Options
+
+- [!INCLUDE [accept-license](includes/dnim-cli-accept-license.md)]
+
+- [!INCLUDE [except-product-version](includes/dnim-cli-except-product-version.md)]
+
+- [!INCLUDE [except-support-phase](includes/dnim-cli-except-support-phase.md)]
+
+- [!INCLUDE [output-file](includes/dnim-cli-output-file.md)]
+
+- [!INCLUDE [offline](includes/dnim-cli-offline.md)]
+
+- [!INCLUDE [output-format](includes/dnim-cli-output-format.md)]
+
+- [!INCLUDE [product-version](includes/dnim-cli-product-version.md)]
+
+- [!INCLUDE [support-phase](includes/dnim-cli-support-phase.md)]
+
+- [!INCLUDE [verbosity](includes/dnim-cli-verbosity.md)]
+
+## Results
+
+The example below shows the latest release information for .NET Core 3.1.
+
+```console
+Version: 3.1.32
+Release date: 12/13/2022
+Release notes: https://github.com/dotnet/core/blob/main/release-notes/3.1/3.1.32/3.1.32.md
+Security: True
+CVEs:
+  CVE-2022-41089, https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2022-41089
+SDK 3.1.426
+  ASP.NET Core Runtime 3.1.32
+  .NET Core Runtime 3.1.32
+  Desktop Runtime 3.1.32
+```
+
+## Examples
+
+- Display all releases that addressed a specific CVE:
+
+  ```console
+  dnim-win-[x86|x64|arm64] query releases --cve CVE-2026-71328
+  ```
+
+- Display the latest releases available for all products that are not end-of-life.
+
+  ```console
+  dnim-win-[x86|x64|arm64] query release --esp eol --latest
+  ```
+
+## See also
+
+The [`query products`](dnim-cli-query-products.md) command.

docs/core/additional-tools/dnim-cli-scan.md

@@ -0,0 +1,91 @@
+---
+title: dnim scan command
+description: The scan command identifies .NET installations.
+author: joeloff
+ms.date: 08/11/2026
+ai-usage: ai-assisted
+---
+
+# dnim scan
+
+## Name
+
+`dnim-win-[x86|x64|arm64] scan` - Detects, classifies, and reports .NET installations on a device.
+
+## Synopsis
+
+```dotnetcli
+dnim-win-[x86|x64|arm64] scan [-a|--accept-license] [-b|--include-bin-deployed-installs]
+    [--epv|--except-product-version <PRODUCT_VERSION>] 
+    [--esp|--except-support-phase <active|eol|golive|maintenance|preview>]
+    [-l|--log-file <LOG_FILE>] [-o|--output-file <OUTPUT_FILE>] [--offline <LAYOUT_DIRECTORY>]
+    [--output-format <text|csv|html|json>] [--pv|--product-version <PRODUCT_VERSION>]
+    [--sp|--support-phase <active|eol|golive|maintenance|preview>]
+    [-v|--verbosity <quiet|normal|diagnostic>]
+
+dnim-win-[x86|x64|arm64] scan -?|-h|--help
+```
+
+## Description
+
+The `scan` command detects, classifies and reports .NET installations on Windows. MSIs and bundles are detected by default. Bin deployed (xcopy/zip) installs under `Program Files` can be detected using the `--include-bin-deployed-installs` option.
+
+Results can be filtered using the product version and support phase options to only include installations matching the specified criteria. Results are written to both the console and diagnostic log. Additional output formats are available and include JSON, HTML and CSV.
+
+## Options
+
+- [!INCLUDE [accept-license](includes/dnim-cli-accept-license.md)]
+
+- [!INCLUDE [bin-deployed-installs](includes/dnim-cli-include-bin-deployed-installs.md)]
+
+- [!INCLUDE [except-product-version](includes/dnim-cli-except-product-version.md)]
+
+- [!INCLUDE [except-support-phase](includes/dnim-cli-except-support-phase.md)]
+
+- [!INCLUDE [log-file](includes/dnim-cli-log-file.md)]
+
+- [!INCLUDE [output-file](includes/dnim-cli-output-file.md)]
+
+- [!INCLUDE [offline](includes/dnim-cli-offline.md)]
+
+- [!INCLUDE [output-format](includes/dnim-cli-output-format.md)]
+
+- [!INCLUDE [product-version](includes/dnim-cli-product-version.md)]
+
+- [!INCLUDE [support-phase](includes/dnim-cli-support-phase.md)]
+
+- [!INCLUDE [verbosity](includes/dnim-cli-verbosity.md)]
+
+## Results
+
+The results presents a summary of each installation, including its type (MSI, bundle, etc.), the .NET product to which it belongs and its current support phase. It may also include information about its origin. In the example below there are three installations: two bundles and one MSI. The targeting pack MSI is shared between both SDK installs and two instances of Visual Studio: 17.14.37502 and 17.14.37110.
+
+| Display Name | Product | Release | Type | Support | Installed By |
+| --- | --- | --- | --- | --- | --- |
+| Microsoft .NET SDK 6.0.136 (x64) | 6.0 | 6.0.136 | Bundle | EOL | |
+| Microsoft .NET SDK 6.0.428 (x64) | 6.0 | 6.0.428 | Bundle | EOL | |
+| Microsoft Windows Desktop Targeting Pack - 6.0.36 (x64) | 6.0 | 6.0.36 | Msi | EOL | VS 17.14.37502, VS 17.14.37110, Microsoft .NET SDK 6.0.428 (x64), Microsoft .NET SDK 6.0.136 (x64) |
+
+## Examples
+
+- Scan and report all .NET installations:
+
+  ```console
+  dnim-win-[x86|x64|arm64] scan
+  ```
+
+- Scan and report .NET installations that are in active support:
+
+  ```console
+  dnim-win-[x86|x64|arm64] scan --sp active
+  ```
+
+- Scan for end-of-life (EOL) installations of .NET and write the results to an HTML file:
+
+  ```console
+  dnim-win-[x86|x64|arm64] scan --sp eol -o report.html --output-format html
+  ```
+
+## See also
+
+[.NET Installs](dnim-net-installs.md)