diff --git a/reference/7.4/Microsoft.PowerShell.Core/About/about_Profiles.md b/reference/7.4/Microsoft.PowerShell.Core/About/about_Profiles.md index 4410f3866b2..95b652100c8 100644 --- a/reference/7.4/Microsoft.PowerShell.Core/About/about_Profiles.md +++ b/reference/7.4/Microsoft.PowerShell.Core/About/about_Profiles.md @@ -1,7 +1,7 @@ --- description: Describes how to create and use a PowerShell profile. Locale: en-US -ms.date: 03/18/2024 +ms.date: 05/01/2026 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_profiles?view=powershell-7.4&WT.mc_id=ps-gethelp schema: 2.0.0 title: about_Profiles @@ -312,6 +312,16 @@ Invoke-Command -Session $s -ScriptBlock { After running this command, the commands that the profile adds to the session are available in `$s`. +## Profiles for MSIX-based installations + +For MSIX-based installations of PowerShell, the **AllUsersAllHosts** and +**AllUsersCurrentHost** profile scripts must reside in the `$PSHOME` directory. +Because the MSIX package is installed in a read-only location, you can't create +or modify profile scripts in `$PSHOME`. Therefore, user customization through +these all-users profiles isn't supported for MSIX-based installations, and you +can only create and use the **CurrentUserAllHosts** and +**CurrentUserCurrentHost** profiles. + ## See also - [about_Automatic_Variables][01] diff --git a/reference/7.5/Microsoft.PowerShell.Core/About/about_Profiles.md b/reference/7.5/Microsoft.PowerShell.Core/About/about_Profiles.md index ca642c88e39..9226619369b 100644 --- a/reference/7.5/Microsoft.PowerShell.Core/About/about_Profiles.md +++ b/reference/7.5/Microsoft.PowerShell.Core/About/about_Profiles.md @@ -1,7 +1,7 @@ --- description: Describes how to create and use a PowerShell profile. Locale: en-US -ms.date: 03/18/2024 +ms.date: 05/01/2026 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_profiles?view=powershell-7.5&WT.mc_id=ps-gethelp schema: 2.0.0 title: about_Profiles @@ -312,6 +312,16 @@ Invoke-Command -Session $s -ScriptBlock { After running this command, the commands that the profile adds to the session are available in `$s`. +## Profiles for MSIX-based installations + +For MSIX-based installations of PowerShell, the **AllUsersAllHosts** and +**AllUsersCurrentHost** profile scripts must reside in the `$PSHOME` directory. +Because the MSIX package is installed in a read-only location, you can't create +or modify profile scripts in `$PSHOME`. Therefore, user customization through +these all-users profiles isn't supported for MSIX-based installations, and you +can only create and use the **CurrentUserAllHosts** and +**CurrentUserCurrentHost** profiles. + ## See also - [about_Automatic_Variables][01] diff --git a/reference/7.6/Microsoft.PowerShell.Core/About/about_Profiles.md b/reference/7.6/Microsoft.PowerShell.Core/About/about_Profiles.md index 66666eda168..cdba65ff1c6 100644 --- a/reference/7.6/Microsoft.PowerShell.Core/About/about_Profiles.md +++ b/reference/7.6/Microsoft.PowerShell.Core/About/about_Profiles.md @@ -1,7 +1,7 @@ --- description: Describes how to create and use a PowerShell profile. Locale: en-US -ms.date: 03/18/2024 +ms.date: 05/01/2026 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_profiles?view=powershell-7.6&WT.mc_id=ps-gethelp schema: 2.0.0 title: about_Profiles @@ -312,6 +312,16 @@ Invoke-Command -Session $s -ScriptBlock { After running this command, the commands that the profile adds to the session are available in `$s`. +## Profiles for MSIX-based installations + +For MSIX-based installations of PowerShell, the **AllUsersAllHosts** and +**AllUsersCurrentHost** profile scripts must reside in the `$PSHOME` directory. +Because the MSIX package is installed in a read-only location, you can't create +or modify profile scripts in `$PSHOME`. Therefore, user customization through +these all-users profiles isn't supported for MSIX-based installations, and you +can only create and use the **CurrentUserAllHosts** and +**CurrentUserCurrentHost** profiles. + ## See also - [about_Automatic_Variables][01] diff --git a/reference/7.7/Microsoft.PowerShell.Core/About/about_Profiles.md b/reference/7.7/Microsoft.PowerShell.Core/About/about_Profiles.md index f9596b0d20c..f96b2e68081 100644 --- a/reference/7.7/Microsoft.PowerShell.Core/About/about_Profiles.md +++ b/reference/7.7/Microsoft.PowerShell.Core/About/about_Profiles.md @@ -1,7 +1,7 @@ --- description: Describes how to create and use a PowerShell profile. Locale: en-US -ms.date: 03/18/2024 +ms.date: 05/01/2026 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_profiles?view=powershell-7.7&WT.mc_id=ps-gethelp schema: 2.0.0 title: about_Profiles @@ -312,6 +312,16 @@ Invoke-Command -Session $s -ScriptBlock { After running this command, the commands that the profile adds to the session are available in `$s`. +## Profiles for MSIX-based installations + +For MSIX-based installations of PowerShell, the **AllUsersAllHosts** and +**AllUsersCurrentHost** profile scripts must reside in the `$PSHOME` directory. +Because the MSIX package is installed in a read-only location, you can't create +or modify profile scripts in `$PSHOME`. Therefore, user customization via the +**AllUsersAllHosts** and **AllUsersCurrentHost** profiles isn't supported for +MSIX-based installations, and you can only create and customize the +**CurrentUserAllHosts** and **CurrentUserCurrentHost** profiles. + ## See also - [about_Automatic_Variables][01] diff --git a/reference/docs-conceptual/install/install-powershell-on-windows.md b/reference/docs-conceptual/install/install-powershell-on-windows.md index c432e779340..6cc0abc1a93 100644 --- a/reference/docs-conceptual/install/install-powershell-on-windows.md +++ b/reference/docs-conceptual/install/install-powershell-on-windows.md @@ -1,6 +1,6 @@ --- description: How to install PowerShell on Windows -ms.date: 04/22/2026 +ms.date: 05/01/2026 title: Install PowerShell 7 on Windows --- # Install PowerShell 7 on Windows @@ -206,9 +206,9 @@ Add-AppxPackage -Path ".\PowerShell-7.6.1.msixbundle" #### Limitations of a MSIX-based installation Store-based installations are installed for a single user. There is no option to install it for all -users. By default, Microsoft Store packages run in an application sandbox that virtualizes access to -some filesystem and registry locations. Changes to virtualized file and registry locations don't -persist outside of the application sandbox. +users. Microsoft Store packages run in an application sandbox that virtualizes access to some +filesystem and registry locations. Changes to virtualized file and registry locations don't persist +outside of the application sandbox. Store-based installations don't support PowerShell remoting. The application sandbox blocks all changes to the application's root folder. Any system-level configuration settings stored in @@ -224,11 +224,15 @@ need write access to `$PSHOME`. - `Enable-ExperimentalFeature -Scope AllUsers` - `Set-ExecutionPolicy -Scope LocalMachine` -For more information, see [Understanding how packaged desktop apps run on Windows][06]. +For MSIX-based installations, you can't create or modify the all-users profile scripts +`$PROFILE.AllUsersAllHosts` and `$PROFILE.AllUsersCurrentHost` because those profiles must be +stored in `$PSHOME`. Current-user profiles are still supported. + +The PowerShell package is exempt from file and registry virtualization. Changes to virtualized file +and registry locations now persist outside of the application sandbox. However, changes to the +application's root folder are still blocked. -Beginning in PowerShell 7.2, the PowerShell package is now exempt from file and registry -virtualization. Changes to virtualized file and registry locations now persist outside of the -application sandbox. However, changes to the application's root folder are still blocked. +For more information, see [Understanding how packaged desktop apps run on Windows][06]. > [!IMPORTANT] > You must be running on Windows build 1903 or higher for this exemption to work.