Merge pull request MicrosoftDocs#2591 from PatAltimore/patricka-dism

Dism module update for WS2022

Author: tiburd

docset/winserver2022-ps/dism/Add-AppxProvisionedPackage.md

@@ -2,7 +2,7 @@
 description: Use this topic to help manage Windows and Windows Server technologies with Windows PowerShell.
 external help file: Microsoft.Dism.PowerShell.dll-Help.xml
 Module Name: System.Object[]
-ms.date: 12/21/2016
+ms.date: 10/07/2021
 online version: https://docs.microsoft.com/powershell/module/dism/add-appxprovisionedpackage?view=windowsserver2022-ps&wt.mc_id=ps-gethelp
 schema: 2.0.0
 title: Add-AppxProvisionedPackage
@@ -18,16 +18,18 @@ Adds an app package (.appx) that will install for each new user to a Windows ima
 ### Offline
 ```
 Add-AppxProvisionedPackage [-FolderPath <String>] [-PackagePath <String>] [-DependencyPackagePath <String[]>]
- [-LicensePath <String>] [-SkipLicense] [-CustomDataPath <String>] -Path <String> [-WindowsDirectory <String>]
- [-SystemDrive <String>] [-LogPath <String>] [-ScratchDirectory <String>] [-StubPackageOption <StubPackageOption>] [-LogLevel <LogLevel>] [-Regions <String>]
+ [-OptionalPackagePath <String[]>] [-LicensePath <String[]>] [-SkipLicense] [-CustomDataPath <String>]
+ [-Regions <String>] [-StubPackageOption <StubPackageOption>] -Path <String> [-WindowsDirectory <String>]
+ [-SystemDrive <String>] [-LogPath <String>] [-ScratchDirectory <String>] [-LogLevel <LogLevel>]
  [<CommonParameters>]
 ```
 
 ### Online
 ```
 Add-AppxProvisionedPackage [-FolderPath <String>] [-PackagePath <String>] [-DependencyPackagePath <String[]>]
- [-LicensePath <String>] [-SkipLicense] [-CustomDataPath <String>] [-Online] [-WindowsDirectory <String>]
- [-SystemDrive <String>] [-LogPath <String>] [-ScratchDirectory <String>] [-StubPackageOption <StubPackageOption>] [-LogLevel <LogLevel>] [-Regions <String>]
+ [-OptionalPackagePath <String[]>] [-LicensePath <String[]>] [-SkipLicense] [-CustomDataPath <String>]
+ [-Regions <String>] [-StubPackageOption <StubPackageOption>] [-Online] [-WindowsDirectory <String>]
+ [-SystemDrive <String>] [-LogPath <String>] [-ScratchDirectory <String>] [-LogLevel <LogLevel>]
  [<CommonParameters>]
 ```
 
@@ -122,7 +124,7 @@ Accept wildcard characters: False
 Specifies the location of the .xml file containing your application license.
 
 ```yaml
-Type: String
+Type: String[]
 Parameter Sets: (All)
 Aliases: 
 
@@ -185,6 +187,23 @@ Accept pipeline input: True (ByPropertyName)
 Accept wildcard characters: False
 ```
 
+### -OptionalPackagePath
+Specifies the path to an optional package that will also be provisioned. For more information on
+optional packages, see
+[Optional packages and related set authoring](/windows/msix/package/optional-packages).
+
+```yaml
+Type: String[]
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: True (ByPropertyName)
+Accept wildcard characters: False
+```
+
 ### -PackagePath
 Specifies the location of the app package (.appx) to add to the Windows image.
 This package will be added for every new user account.
@@ -221,7 +240,7 @@ Accept wildcard characters: False
 ```
 
 ### -Regions
-Specifies what regions an app package (.appx or .appxbundle) must be provisioned in. The region argument can either be “all”, indicating that the app should be provisioned for all regions, or it can be a semi-colon delimited list of regions. The regions will be in the form of [ISO 3166-1 Alpha-2 or ISO 3166-1 Alpha-3 codes](https://en.wikipedia.org/wiki/ISO_3166-1). For example, the United States can be specified as either "US" or "USA" (case-insensitive). When a list of regions is not specified, the package will be provisioned only if it is pinned to start layout.
+Specifies what regions an app package (.appx or .appxbundle) must be provisioned in. The region argument can either be "all", indicating that the app should be provisioned for all regions, or it can be a semi-colon delimited list of regions. The regions will be in the form of [ISO 3166-1 Alpha-2 or ISO 3166-1 Alpha-3 codes](https://en.wikipedia.org/wiki/ISO_3166-1). For example, the United States can be specified as either "US" or "USA" (case-insensitive). When a list of regions is not specified, the package will be provisioned only if it is pinned to start layout.
 
 Note: Option is available on client OS. 
 
@@ -285,7 +304,7 @@ Aliases:
 Required: False
 Position: Named
 Default value: None
-Accept pipeline input: InstallFull, InstallStub
+Accept pipeline input: True (ByPropertyName)
 Accept wildcard characters: False
 ```
 

docset/winserver2022-ps/dism/Add-WindowsCapability.md

@@ -2,7 +2,7 @@
 description: Use this topic to help manage Windows and Windows Server technologies with Windows PowerShell.
 external help file: Microsoft.Dism.PowerShell.dll-Help.xml
 Module Name: System.Object[]
-ms.date: 12/21/2016
+ms.date: 08/24/2021
 online version: https://docs.microsoft.com/powershell/module/dism/add-windowscapability?view=windowsserver2022-ps&wt.mc_id=ps-gethelp
 schema: 2.0.0
 title: Add-WindowsCapability
@@ -17,14 +17,15 @@ Installs a Windows capability package on the specified operating system image.
 
 ### Online
 ```powershell
-Add-WindowsCapability -Online -Name <String> [-LimitAccess] [-Source <String[]>] [-WindowsDirectory <String>]
- [-SystemDrive <String>] [-LogPath <String>] [-ScratchDirectory <String>] [-LogLevel <LogLevel>]
- [<CommonParameters>]
+Add-WindowsCapability [-Name <String>] [-LimitAccess] [-Source <String[]>] [-Online]
+ [-WindowsDirectory <String>] [-SystemDrive <String>] [-LogPath <String>] [-ScratchDirectory <String>]
+ [-LogLevel <LogLevel>] [<CommonParameters>]
 ```
 
 ### Offline
 ```powershell
-Add-WindowsCapability -Path <String> -Name <String> [-Source <String[]>] [-WindowsDirectory <String>] [-SystemDrive <String>] [-LogPath <String>] [-ScratchDirectory <String>]
+Add-WindowsCapability [-Name <String>] [-LimitAccess] [-Source <String[]>] -Path <String>
+ [-WindowsDirectory <String>] [-SystemDrive <String>] [-LogPath <String>] [-ScratchDirectory <String>]
  [-LogLevel <LogLevel>] [<CommonParameters>]
 ```
 
@@ -63,7 +64,7 @@ Indicates that this cmdlet does not query Windows Update for source packages whe
 ```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
-Aliases: 
+Aliases:
 
 Required: False
 Position: Named
@@ -94,7 +95,7 @@ If not set, the default is `"$env:WINDIR\Logs\Dism\dism.log"`.
 In Windows PE, the default directory is the RAMDISK scratch space which can be as low as 32 MB.
 The log file will automatically be archived.
 The archived log file will be saved with .bak appended to the file name and a new log file will be generated.
-Each time the log file is archived the .bak file will be overwritten. 
+Each time the log file is archived the .bak file will be overwritten.
 When using a network share that is not joined to a domain, use the net use command together with domain credentials to set access permissions before you set the log path for the DISM log.
 
 ```yaml
@@ -115,7 +116,7 @@ Specifies the identity of the capability to add to an operating system image.
 ```yaml
 Type: String
 Parameter Sets: (All)
-Aliases: 
+Aliases:
 
 Required: True
 Position: Named
@@ -130,7 +131,7 @@ Indicates that the cmdlet operates on a running operating system on the local ho
 ```yaml
 Type: SwitchParameter
 Parameter Sets: Online
-Aliases: 
+Aliases:
 
 Required: True
 Position: Named
@@ -146,7 +147,7 @@ If the directory named Windows is not a subdirectory of the root directory, *Win
 ```yaml
 Type: String
 Parameter Sets: Offline
-Aliases: 
+Aliases:
 
 Required: True
 Position: Named
@@ -159,14 +160,14 @@ Accept wildcard characters: False
 Specifies a temporary directory that will be used when extracting files for use during servicing.
 The directory must exist locally.
 If not specified, the `"$env:Temp"` directory will be used, with a subdirectory name of a randomly generated hexadecimal value for each run of DISM.
-Items in the scratch directory are deleted after each operation. 
+Items in the scratch directory are deleted after each operation.
 You should not use a network share location as a scratch directory to expand a package (.cab or .msu file) for installation.
 The directory used for extracting files for temporary usage during servicing should be a local directory.
 
 ```yaml
 Type: String
 Parameter Sets: (All)
-Aliases: 
+Aliases:
 
 Required: False
 Position: Named
@@ -180,12 +181,12 @@ Specifies the location of the files that are required to add a Windows capabilit
 
 If you do not specify a *Source*, the default location set by Group Policy is used. If that fails, Windows Update is also used for online images, unless *LimitAccess* is specified. When all fail, the cmdlet fails silently; no exceptions are thrown.
 
-*Source* can only be used when servicing images that are running at least Windows® 8 or Windows Server® 2012.
+*Source* can only be used when servicing images that are running at least Windows 8 or Windows Server 2012.
 
 ```yaml
 Type: String[]
 Parameter Sets: (All)
-Aliases: 
+Aliases:
 
 Required: False
 Position: Named
@@ -202,7 +203,7 @@ Use -SystemDrive to service an installed Windows image from a Windows PE environ
 ```yaml
 Type: String
 Parameter Sets: (All)
-Aliases: 
+Aliases:
 
 Required: False
 Position: Named
@@ -219,7 +220,7 @@ If not specified, the default is the Windows directory in the root of the offlin
 ```yaml
 Type: String
 Parameter Sets: (All)
-Aliases: 
+Aliases:
 
 Required: False
 Position: Named

docset/winserver2022-ps/dism/Add-WindowsImage.md

@@ -2,7 +2,7 @@
 description: Use this topic to help manage Windows and Windows Server technologies with Windows PowerShell.
 external help file: Microsoft.Dism.PowerShell.dll-Help.xml
 Module Name: System.Object[]
-ms.date: 12/21/2016
+ms.date: 08/25/2021
 online version: https://docs.microsoft.com/powershell/module/dism/add-windowsimage?view=windowsserver2022-ps&wt.mc_id=ps-gethelp
 schema: 2.0.0
 title: Add-WindowsImage
@@ -17,17 +17,17 @@ Adds an additional image to an existing image (.wim) file.
 
 ```
 Add-WindowsImage -ImagePath <String> -CapturePath <String> [-ConfigFilePath <String>] [-Description <String>]
- -Name <String> [-CheckIntegrity] [-NoRpFix] [-Setbootable] [-Verify] [-WIMBoot] [-LogPath <String>]
- [-ScratchDirectory <String>] [-LogLevel <LogLevel>] [<CommonParameters>]
+ -Name <String> [-CheckIntegrity] [-NoRpFix] [-Setbootable] [-Verify] [-WIMBoot] [-SupportEa]
+ [-LogPath <String>] [-ScratchDirectory <String>] [-LogLevel <LogLevel>] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
 The **Add-WindowsImage** cmdlet adds an additional image to an existing image (.wim) file.
 **Add-WindowsImage** compares new files to the resources in the existing .wim file, specified by the *Name* parameter and the *ImagePath* parameter, and stores only a single copy of each unique file so that each file is only captured once.
 The .wim file can have only one assigned compression type.
-Therefore, you can only append files with the same compression type. 
+Therefore, you can only append files with the same compression type.
 
-The **Add-WindowsImage** cmdlet does not apply to virtual hard disk (VHD) files. 
+The **Add-WindowsImage** cmdlet does not apply to virtual hard disk (VHD) files.
 
 It's important to note that you'll need to ensure you have enough disk space before you run **Add-WindowsImage**.
 If you run out of disk space while the image is being appended, you might corrupt the .wim file.
@@ -49,7 +49,7 @@ Specifies the path to the location of the new files that will be compared to the
 ```yaml
 Type: String
 Parameter Sets: (All)
-Aliases: 
+Aliases:
 
 Required: True
 Position: Named
@@ -65,7 +65,7 @@ CheckIntegrity stops the operation if DISM detects that the .wim file is corrupt
 ```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
-Aliases: 
+Aliases:
 
 Required: False
 Position: Named
@@ -81,7 +81,7 @@ For more information, see [DISM Configuration List and WimScript.ini Files](http
 ```yaml
 Type: String
 Parameter Sets: (All)
-Aliases: 
+Aliases:
 
 Required: False
 Position: Named
@@ -96,7 +96,7 @@ Specifies the description of the image to be captured.
 ```yaml
 Type: String
 Parameter Sets: (All)
-Aliases: 
+Aliases:
 
 Required: False
 Position: Named
@@ -111,7 +111,7 @@ Specifies the location of the WIM file containing the Windows image you want to
 ```yaml
 Type: String
 Parameter Sets: (All)
-Aliases: 
+Aliases:
 
 Required: True
 Position: Named
@@ -148,7 +148,7 @@ If not set, the default is `%WINDIR%\Logs\Dism\dism.log`.
 In Windows PE, the default directory is the RAMDISK scratch space which can be as low as 32 MB.
 The log file will automatically be archived.
 The archived log file will be saved with .bak appended to the file name and a new log file will be generated.
-Each time the log file is archived the .bak file will be overwritten. 
+Each time the log file is archived the .bak file will be overwritten.
 When using a network share that is not joined to a domain, use the net use command together with domain credentials to set access permissions before you set the log path for the DISM log.
 
 ```yaml
@@ -169,7 +169,7 @@ Specifies the name of an image in a WIM file.
 ```yaml
 Type: String
 Parameter Sets: (All)
-Aliases: 
+Aliases:
 
 Required: True
 Position: Named
@@ -186,7 +186,7 @@ If the parameter is not specified, reparse points that resolve to paths outside
 ```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
-Aliases: 
+Aliases:
 
 Required: False
 Position: Named
@@ -199,14 +199,14 @@ Accept wildcard characters: False
 Specifies a temporary directory that will be used when extracting files for use during servicing.
 The directory must exist locally.
 If not specified, the `\Windows\%Temp%` directory will be used, with a subdirectory name of a randomly generated hexadecimal value for each run of DISM.
-Items in the scratch directory are deleted after each operation. 
+Items in the scratch directory are deleted after each operation.
 You should not use a network share location as a scratch directory to expand a package (.cab or .msu file) for installation.
 The directory used for extracting files for temporary usage during servicing should be a local directory.
 
 ```yaml
 Type: String
 Parameter Sets: (All)
-Aliases: 
+Aliases:
 
 Required: False
 Position: Named
@@ -223,7 +223,22 @@ Only one volume image can be marked as bootable in a .wim file.
 ```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
-Aliases: 
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: True (ByPropertyName)
+Accept wildcard characters: False
+```
+
+### -SupportEa
+Appends an image with extended attributes.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
 
 Required: False
 Position: Named
@@ -233,14 +248,14 @@ Accept wildcard characters: False
 ```
 
 ### -Verify
-Checks for errors and file duplication. 
- During an apply operation, for example, using the **Add-WindowsImage** cmdlet, the size and the hash of the file being applied are checked against the image file to verify they are both equal. 
+Checks for errors and file duplication.
+ During an apply operation, for example, using the **Add-WindowsImage** cmdlet, the size and the hash of the file being applied are checked against the image file to verify they are both equal.
  During a capture operation, for example, when using the **New-WindowsImage** cmdlet, after the files is captured into a Windows image, the file is written to a temporary file and compared on a bit-by-bit basis with the original file.
 
 ```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
-Aliases: 
+Aliases:
 
 Required: False
 Position: Named
@@ -255,7 +270,7 @@ Specifies that the offline image to be added will be formatted to install on a W
 ```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
-Aliases: 
+Aliases:
 
 Required: False
 Position: Named