Merge branch 'main' into patch-1

.devcontainer/Dockerfile

@@ -0,0 +1,4 @@
+FROM mcr.microsoft.com/devcontainers/base:ubuntu
+RUN wget https://github.com/errata-ai/vale/releases/download/v2.26.0/vale_2.26.0_Linux_64-bit.tar.gz && \
+    tar -xvzf vale_2.26.0_Linux_64-bit.tar.gz -C bin && \
+    export PATH=./bin:"$PATH"

.devcontainer/devcontainer.json

@@ -0,0 +1,42 @@
+{
+	"build": {
+		"dockerfile": "Dockerfile"
+	},
+	"features": {
+		"ghcr.io/devcontainers/features/git:1": {},
+		"ghcr.io/devcontainers/features/github-cli:1": {},
+		"ghcr.io/devcontainers/features/powershell:1": {
+			"modules": "Documentarian,Documentarian.Vale,Documentarian.MicrosoftDocs,Documentarian.ModuleAuthor"
+		}
+	},
+	"customizations": {
+		"vscode": {
+			"extensions": [
+				"chrischinchilla.vale-vscode",
+				"davidanson.vscode-markdownlint",
+				"docsmsft.docs-images",
+				"docsmsft.docs-linting",
+				"docsmsft.docs-markdown",
+				"docsmsft.docs-preview",
+				"docsmsft.docs-yaml",
+				"eamodio.gitlens",
+				"marvhen.reflow-markdown",
+				"ms-vscode.powershell",
+				"ms-vscode.wordcount",
+				"nhoizey.gremlins",
+				"redhat.vscode-yaml",
+				"shuworks.vscode-table-formatter",
+				"streetsidesoftware.code-spell-checker",
+				"tyriar.sort-lines",
+				"usernamehw.errorlens",
+				"wmaurer.change-case"
+			],
+			"settings": {
+				"terminal.integrated.defaultProfile.linux": "pwsh",
+				"vale.valeCLI.path": "",
+				"vale.valeCLI.config": ""
+			}
+		}
+	},
+	"postStartCommand": "vale sync"
+}

.gitattributes

@@ -9,6 +9,9 @@
 # Declare files that will always have CRLF line endings on checkout.
 *.sln text eol=crlf
 
+# Ensure devcontainer files are always LF
+.devcontainer/** eol=lf
+
 # Denote all files that are truly binary and should not be modified.
 *.png binary
 *.jpg binary

.github/ISSUE_TEMPLATE/00-bug.yml

@@ -2,7 +2,7 @@ name: "🐛 Report a documentation issue"
 description: >-
   Report an issue with current documentation.
 labels:
-  - doc-bug
+  - issue-doc-bug
   - needs-triage
 body:
   - type: markdown

.github/ISSUE_TEMPLATE/01-article.yml

@@ -2,7 +2,7 @@ name: "💡 Suggest a new document or idea"
 description: >-
   Suggest a new document or major rewrite of an existing one.
 labels:
-  - doc-idea
+  - issue-doc-idea
   - needs-triage
 body:
   - type: checkboxes

.github/ISSUE_TEMPLATE/02-quality.yml

@@ -1,6 +1,8 @@
 name: "🦾 Commit to a Quality Contribution"
 description: >-
   File an issue to take part in the PowerShell Docs Quality Contributions project.
+labels:
+  - project-quality
 title: "Quality: "
 body:
   - type: markdown

.github/workflows/quality.issue.yml

@@ -19,17 +19,6 @@ jobs:
           regex: "Quality: Foo"
           flags: gm
 
-  project:
-    name: Add to project
-    needs: quality
-    if: needs.quality.outputs.check == 'true'
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/add-to-project@v0.3.0
-        with:
-          project-url: https://github.com/orgs/MicrosoftDocs/projects/15/views/1
-          github-token: ${{ secrets.quality_token }}
-
   assign:
     name: Assign to author
     needs: quality

.github/workflows/quality.pr.yml

@@ -24,7 +24,7 @@ jobs:
         run: |
           $Check = "${{ contains(github.event.pull_request.title, 'Quality:') }}"
           "Check: $Check"
-          "::set-output name=check::$Check"
+          "check=$Check" >> $env:GITHUB_OUTPUT
 
   project:
     name: Add pull request to project
@@ -33,7 +33,6 @@ jobs:
       needs.check.outputs.title == 'true'
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/add-to-project@v0.3.0
+      - uses: actions-ecosystem/action-add-labels@v1
         with:
-          project-url: https://github.com/orgs/MicrosoftDocs/projects/15/views/1
-          github-token: ${{ secrets.quality_token }}
+          labels: project-quality

.vscode/cspell/winmodules/dictionaries/winps.txt

@@ -1,2 +1,18 @@
 ADCS
+Cmdletization
+Dcpromo
+Dedup
+DSRM
+Hotspot
+hotspots
+krbtgt
 NTDS
+reoptimized
+rescan
+RODC
+Sysvol
+Unoptimization
+unoptimization
+unoptimizes
+unoptimize
+unoptimized

SECURITY.md

@@ -0,0 +1,41 @@
+<!-- BEGIN MICROSOFT SECURITY.MD V0.0.8 BLOCK -->
+
+## Security
+
+Microsoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, which include [Microsoft](https://github.com/microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), [Xamarin](https://github.com/xamarin), and [our GitHub organizations](https://opensource.microsoft.com/).
+
+If you believe you have found a security vulnerability in any Microsoft-owned repository that meets [Microsoft's definition of a security vulnerability](https://aka.ms/opensource/security/definition), please report it to us as described below.
+
+## Reporting Security Issues
+
+**Please do not report security vulnerabilities through public GitHub issues.**
+
+Instead, please report them to the Microsoft Security Response Center (MSRC) at [https://msrc.microsoft.com/create-report](https://aka.ms/opensource/security/create-report).
+
+If you prefer to submit without logging in, send email to [secure@microsoft.com](mailto:secure@microsoft.com).  If possible, encrypt your message with our PGP key; please download it from the [Microsoft Security Response Center PGP Key page](https://aka.ms/opensource/security/pgpkey).
+
+You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Additional information can be found at [microsoft.com/msrc](https://aka.ms/opensource/security/msrc). 
+
+Please include the requested information listed below (as much as you can provide) to help us better understand the nature and scope of the possible issue:
+
+  * Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.)
+  * Full paths of source file(s) related to the manifestation of the issue
+  * The location of the affected source code (tag/branch/commit or direct URL)
+  * Any special configuration required to reproduce the issue
+  * Step-by-step instructions to reproduce the issue
+  * Proof-of-concept or exploit code (if possible)
+  * Impact of the issue, including how an attacker might exploit the issue
+
+This information will help us triage your report more quickly.
+
+If you are reporting for a bug bounty, more complete reports can contribute to a higher bounty award. Please visit our [Microsoft Bug Bounty Program](https://aka.ms/opensource/security/bounty) page for more details about our active programs.
+
+## Preferred Languages
+
+We prefer all communications to be in English.
+
+## Policy
+
+Microsoft follows the principle of [Coordinated Vulnerability Disclosure](https://aka.ms/opensource/security/cvd).
+
+<!-- END MICROSOFT SECURITY.MD BLOCK -->

docset/docfx.json

@@ -67,7 +67,6 @@
       "ROBOTS": "INDEX, FOLLOW",
       "breadcrumb_path": "/powershell/windows/bread/toc.json",
       "ms.prod": "w10",
-      "ms.technology": "windows",
       "ms.topic": "managed-reference",
       "ms.author": "jgerend",
       "author": "JasonGerend",

docset/docs-conceptual/winserver2016-ps/get-started.md

@@ -71,7 +71,6 @@ computer. For more information, see
 | Iscsi | [iSCSI](/powershell/module/iscsi) |
 | IscsiTarget | [iSCSI Target](/powershell/module/iscsitarget) |
 | KDS | [Key Distribution Server](/powershell/module/kds) |
-| Microsoft.Windows.ServerManager.Migration | [Server Migration](/powershell/module/Microsoft.Windows.ServerManager.Migration) |
 | MMAgent | [Memory Management Agent](/powershell/module/mmagent) |
 | Mpio | [MPIO](/powershell/module/mpio) |
 | MSDTC | [Distributed Transaction Coordinator](/powershell/module/msdtc) |

docset/docs-conceptual/winserver2016-ps/module-compatibility.md

@@ -1,25 +1,25 @@
 ---
 description: This article lists the status of PowerShell 7 with Powershell modules published for other Microsoft products.
-ms.date: 10/04/2021
+ms.date: 06/05/2023
 title: PowerShell 7 module compatibility
 ---
 # PowerShell 7 module compatibility
 
 This article contains a list of PowerShell modules published by Microsoft. These modules provide
-management and support for various Microsoft products and services. They have been updated
-to work natively with PowerShell 7, or tested for compatibility with PowerShell 7. This list will be
-updated with new information as more modules are identified and tested.
+management and support for various Microsoft products and services. They have been updated to work
+natively with PowerShell 7, or tested for compatibility with PowerShell 7. This list will be updated
+with new information as more modules are identified and tested.
 
-If you have information to share or issues with specific modules, please file an issue in the
-[WindowsCompatibility repo](https://github.com/PowerShell/WindowsCompatibility).
+If you have information to share or issues with specific modules, please submit feedback in the
+Windows Feedback Hub. For more information, see
+[Send feedback to Microsoft with the Feedback Hub app][06].
 
 ## Windows management modules
 
 The Windows management modules are installed in different ways, dependent on the Edition of Windows,
 and how the module was packaged for that Edition.
 
-On Windows Server, use the feature name with the
-[Install-WindowsFeature](/powershell/module/servermanager/install-windowsfeature) cmdlet as an
+On Windows Server, use the feature name with the [Install-WindowsFeature][05] cmdlet as an
 Administrator. For example:
 
 ```powershell
@@ -46,8 +46,8 @@ administrator**.
 
   For more information see:
 
-  - [Get-WindowsOptionalFeature](/powershell/module/dism/get-windowsoptionalfeature)
-  - [Enable-WindowsOptionalFeature](/powershell/module/dism/enable-windowsoptionalfeature)
+  - [Get-WindowsOptionalFeature][04]
+  - [Enable-WindowsOptionalFeature][02]
 
 - For Windows Capabilities
 
@@ -66,8 +66,8 @@ administrator**.
 
   For more information see:
 
-  - [Get-WindowsCapability](/powershell/module/dism/get-windowscapability)
-  - [Add-WindowsCapability](/powershell/module/dism/add-windowscapability)
+  - [Get-WindowsCapability][03]
+  - [Add-WindowsCapability][01]
 
 ### Module list
 
@@ -204,3 +204,11 @@ This module has some minor compatibility issues with formatted output in PowerSh
 the `Get-WindowsFeature` cmdlet returns the proper object with all properties, but the default
 display formatting makes some properties appear to be empty. The actual values are available in the
 object properties using `Select-Object` or by direct member access.
+
+<!-- link references -->
+[01]: /powershell/module/dism/add-windowscapability
+[02]: /powershell/module/dism/enable-windowsoptionalfeature
+[03]: /powershell/module/dism/get-windowscapability
+[04]: /powershell/module/dism/get-windowsoptionalfeature
+[05]: /powershell/module/servermanager/install-windowsfeature
+[06]: https://support.microsoft.com/windows/send-feedback-to-microsoft-with-the-feedback-hub-app-f59187f8-8739-22d6-ba93-f66612949332

docset/docs-conceptual/winserver2019-ps/get-started.md

@@ -70,7 +70,6 @@ computer. For more information, see
 | Iscsi | [iSCSI](/powershell/module/iscsi) |
 | IscsiTarget | [iSCSI Target](/powershell/module/iscsitarget) |
 | KDS | [Key Distribution Server](/powershell/module/kds) |
-| Microsoft.Windows.ServerManager.Migration | [Server Migration](/powershell/module/Microsoft.Windows.ServerManager.Migration/) |
 | MMAgent | [Memory Management Agent](/powershell/module/mmagent) |
 | Mpio | [MPIO](/powershell/module/mpio) |
 | MSDTC | [Distributed Transaction Coordinator](/powershell/module/msdtc) |

docset/docs-conceptual/winserver2019-ps/module-compatibility.md

@@ -1,25 +1,25 @@
 ---
 description: This article lists the status of PowerShell 7 with Powershell modules published for other Microsoft products.
-ms.date: 10/04/2021
+ms.date: 06/05/2023
 title: PowerShell 7 module compatibility
 ---
 # PowerShell 7 module compatibility
 
 This article contains a list of PowerShell modules published by Microsoft. These modules provide
-management and support for various Microsoft products and services. They have been updated
-to work natively with PowerShell 7, or tested for compatibility with PowerShell 7. This list will be
-updated with new information as more modules are identified and tested.
+management and support for various Microsoft products and services. They have been updated to work
+natively with PowerShell 7, or tested for compatibility with PowerShell 7. This list will be updated
+with new information as more modules are identified and tested.
 
-If you have information to share or issues with specific modules, please file an issue in the
-[WindowsCompatibility repo](https://github.com/PowerShell/WindowsCompatibility).
+If you have information to share or issues with specific modules, please submit feedback in the
+Windows Feedback Hub. For more information, see
+[Send feedback to Microsoft with the Feedback Hub app][06].
 
 ## Windows management modules
 
 The Windows management modules are installed in different ways, dependent on the Edition of Windows,
 and how the module was packaged for that Edition.
 
-On Windows Server, use the feature name with the
-[Install-WindowsFeature](/powershell/module/servermanager/install-windowsfeature) cmdlet as an
+On Windows Server, use the feature name with the [Install-WindowsFeature][05] cmdlet as an
 Administrator. For example:
 
 ```powershell
@@ -46,8 +46,8 @@ administrator**.
 
   For more information see:
 
-  - [Get-WindowsOptionalFeature](/powershell/module/dism/get-windowsoptionalfeature)
-  - [Enable-WindowsOptionalFeature](/powershell/module/dism/enable-windowsoptionalfeature)
+  - [Get-WindowsOptionalFeature][04]
+  - [Enable-WindowsOptionalFeature][02]
 
 - For Windows Capabilities
 
@@ -66,8 +66,8 @@ administrator**.
 
   For more information see:
 
-  - [Get-WindowsCapability](/powershell/module/dism/get-windowscapability)
-  - [Add-WindowsCapability](/powershell/module/dism/add-windowscapability)
+  - [Get-WindowsCapability][03]
+  - [Add-WindowsCapability][01]
 
 ### Module list
 
@@ -204,3 +204,11 @@ This module has some minor compatibility issues with formatted output in PowerSh
 the `Get-WindowsFeature` cmdlet returns the proper object with all properties, but the default
 display formatting makes some properties appear to be empty. The actual values are available in the
 object properties using `Select-Object` or by direct member access.
+
+<!-- link references -->
+[01]: /powershell/module/dism/add-windowscapability
+[02]: /powershell/module/dism/enable-windowsoptionalfeature
+[03]: /powershell/module/dism/get-windowscapability
+[04]: /powershell/module/dism/get-windowsoptionalfeature
+[05]: /powershell/module/servermanager/install-windowsfeature
+[06]: https://support.microsoft.com/windows/send-feedback-to-microsoft-with-the-feedback-hub-app-f59187f8-8739-22d6-ba93-f66612949332

docset/docs-conceptual/winserver2022-ps/get-started.md

@@ -70,7 +70,6 @@ computer. For more information, see
 | Iscsi | [iSCSI](/powershell/module/iscsi) |
 | IscsiTarget | [iSCSI Target](/powershell/module/iscsitarget) |
 | KDS | [Key Distribution Server](/powershell/module/kds) |
-| Microsoft.Windows.ServerManager.Migration | [Server Migration](/powershell/module/Microsoft.Windows.ServerManager.Migration/) |
 | MMAgent | [Memory Management Agent](/powershell/module/mmagent) |
 | Mpio | [MPIO](/powershell/module/mpio) |
 | MSDTC | [Distributed Transaction Coordinator](/powershell/module/msdtc) |