PowerShell · jshigetomi · Apr 3, 2025 · Apr 3, 2025 · Apr 3, 2025 · Apr 4, 2025
diff --git a/Draft-Accepted/RFC0066-PowerShell-User-Content-Location b/Draft-Accepted/RFC0066-PowerShell-User-Content-Location
@@ -0,0 +1,66 @@
+---
+RFC: RFC0066
+Author: Justin Chung
+Status: Draft
+SupercededBy: N/A
+Version: 1.0
+Area: Core
+Comments Due: 05/03/2025
+Plan to implement: Yes
+---
+
+# PowerShell User Content Location
+
+This RFC proposes moving the current PowerShell user content location out of OneDrive to the AppData directory on Windows machines.
+
+## Motivation
+
+- PowerShell currently places profile, modules, and configuration files in the user's Documents folder, which is against established conventions for shell configurations and tools.
+- PowerShell content files in OneDrive causes unnecessary syncing of configuration files, leading to various issues.
+- There is strong community demand for changing this behavior as the current setup is problematic for many users.
+- Changing the default location would align PowerShell with other developer tools and improve usability.
+
+    As a user,
+    I can customize the location of where PowerShell user content is installed,
+    so that I can choose to sync with OneDrive.
+
+## User Experience
+
+- On startup PowerShell will create a directory in AppData and a configuration file.
+- In the configuration file the user scoped PSModulePath will point to AppData/PowerShell/Modules.
+- Users can opt out of this new location by specifying a desired user scoped module path in the configuration file.
+
+## Specification
+
+- This change will only apply to PowerShell on Windows.
+- This will be an experimental feature.
+- The PowerShell user content folder will be located in the AppData.
- The PowerShell user content folder will be located in the AppData.
+- The PowerShell user content folder will be located in the `"$env:LOCALAPPDATA\PowerShell"`.
- The PowerShell user content folder will be located in the AppData.
+- The PowerShell user content folder will be located in the `"$env:LOCALAPPDATA\PowerShell"`.
+- A configuration file in the PowerShell user content folder will determine the location of the user scoped PSModulePath.
+- The user will be responsible for specifying thier desired install location using PSResourceGet.
+- The location of Modules is configurable
+- The location of this folder is not configurable.
+- The proposed directory structure:
+
+    C:\Users\UserName\AppData\Local\PowerShell\
+    ├── Modules                  (Configurable)
+    ├── Scripts                  (Not Configurable)
+    ├── Profiles                 (Not Configurable)
+    └── PSModulePathConfig.json  (Not Configurable)
+
+- The proposed json file:
+
+    {
+        "PSModulePath" : "C:\\Users\\chungjustin\\PowerShell"
+    }
-    {
-        "PSModulePath" : "C:\\Users\\chungjustin\\PowerShell"
-    }
+  ```json
+  {
+      "PSModulePath" : "C:\\Users\\chungjustin\\PowerShell"
+  }
+  ```
-    {
-        "PSModulePath" : "C:\\Users\\chungjustin\\PowerShell"
-    }
+  ```json
+  {
+      "PSModulePath" : "C:\\Users\\chungjustin\\PowerShell"
+  }
+  ```
+
+## Alternate Proposals and Considerations
+
+- The following functionalities will be affected:
+  - Secret Management.
+- Use the following script to relocate the PowerShell contents folder:
+
+```pwsh
+$newPath = "C:\Custom\PowerShell\Modules"
+$currentUserModulePath = [System.Environment]::GetFolderPath('MyDocuments') + "\PowerShell\Modules"
+Move-Item -Path $currentUserModulePath -Destination $newPath -Force
+```