Merge branch 'master' into patch-17

AndreaBarr · web-flow · commit 86f340453f10 · 2019-07-16T08:46:04.000-07:00
diff --git a/docset/windows/addsadministration/get-adgroup.md b/docset/windows/addsadministration/get-adgroup.md
@@ -215,7 +215,7 @@ The following syntax uses Backus-Naur form to show how to use the PowerShell Exp
 
 For a list of supported types for \<value\>, type `Get-Help about_ActiveDirectory_ObjectModel`.
 
-Note: PowerShell wildcards other than *, such as ?, are not supported by the *Filter* syntax.
+Note: PowerShell wildcards other than \*, such as ?, are not supported by the *Filter* syntax.
 
 Note: To query using LDAP query strings, use the *LDAPFilter* parameter.
 
diff --git a/docset/windows/addsadministration/search-adaccount.md b/docset/windows/addsadministration/search-adaccount.md
@@ -218,7 +218,7 @@ Accept wildcard characters: False
 Indicates that this cmdlet searches for accounts that have not logged in within a given time period or since a specified time.
 To specify a time period, use the *TimeSpan* parameter.
 To specify a specific time, use the *DateTime* parameter.
-Note that this attribute is only used when the domain is in Windows Server 2003 Domain Functional Level, so this parameter will only work in that mode.
+Note that this attribute is only used when the domain is in Windows Server 2003 Domain Functional Level or higher, so this parameter will only work in that mode.
 
 ```yaml
 Type: SwitchParameter
diff --git a/docset/windows/dism/add-windowscapability.md b/docset/windows/dism/add-windowscapability.md
@@ -11,7 +11,7 @@ ms.date: 12/21/2016
 ms.prod: w10
 ms.technology: powershell-windows
 ms.topic: reference
-online version: 
+online version: https://docs.microsoft.com/powershell/module/dism/add-windowscapability?view=win10-ps
 schema: 2.0.0
 title: Add-WindowsCapability
 ms.reviewer:
@@ -43,25 +43,32 @@ The **Add-WindowsCapability** cmdlet acquires a Windows capability package from
 
 ## EXAMPLES
 
-### Example 1: Add a Windows capability package to an image
+### Example 1: Add a Windows capability package to the running OS via the Windows Update client
 ```
-PS C:\> Add-WindowsCapability -Name "Language.TextToSpeech~~~fr-FR~0.0.1.0" -Path "C:\offline" -Source "C:\Windows\winsxs"
+PS C:\> Add-WindowsCapability -Online -Name "Msix.PackagingTool.Driver~~~~0.0.1.0"
 ```
+This command adds a Windows capability package to the running operating system. Because no source is specified, the Windows Update client will download the necessary package. It requires either an active Internet connection or an active network connection to the local Windows Server Update Services (WSUS) server.
 
-This command adds a Windows capability package to the operating system image specified by the *Name* parameter at the path C:\offline.
-The *Source* parameter specifies the location of required files.
+### Example 2: Add a Windows capability package to the running OS using a locally stored package file
+```
+PS C:\> Add-WindowsCapability -Online -Name "Msix.PackagingTool.Driver~~~~0.0.1.0" -Source "E:\" -LimitAccess
+```
+
+This command adds a Windows capability package specified by the *Name* parameter, to the running operating system. The *Source* parameter specifies the location of required files. For instance, if the running OS is a copy of Windows 10 version 1809, the `Msix-PackagingTool-Driver-Package~31bf3856ad364e35~amd64~~.cab` file must be present at `E:\`.
+
+If the package specified by the *Name* parameter is already installed, this command does not return an error message, regardless of whether the required files are present at `E:\`.
 
-### Example 2: Add a Windows capability package to the local host
+### Example 3: Add a Windows capability package to an image
 ```
-PS C:\> Add-WindowsCapability -Name "Language.TextToSpeech~~~fr-FR~0.0.1.0" -Online -LimitAccess -Source "C:\Windows\winsxs"
+PS C:\> Add-WindowsCapability -Path "C:\mount\Windows" -Name "Msix.PackagingTool.Driver~~~~0.0.1.0" -Source "E:\"
 ```
 
-This command adds a windows capabilities package the local host while the operating system continues to run.
+This command adds a Windows capability package specified by the *Name* parameter,  to the operating system image at the path C:\mount\Windows. The *Source* parameter specifies the location of required files. For instance, if the mount point contains a copy of Windows 10 version 1809, the `Msix-PackagingTool-Driver-Package~31bf3856ad364e35~amd64~~.cab` file must present at `E:\`.
 
 ## PARAMETERS
 
 ### -LimitAccess
-Indicates that this cmdlet does not access Windows Update for the source package.
+Indicates that this cmdlet does not query Windows Update for source packages when servicing a live OS. Only applies when the `-Online` switch is specified.
 
 ```yaml
 Type: SwitchParameter
@@ -92,14 +99,14 @@ Accepted values: Errors, Warnings, WarningsInfo
 
 Required: False
 Position: Named
-Default value: None
+Default value: 3
 Accept pipeline input: True (ByPropertyName)
 Accept wildcard characters: False
 ```
 
 ### -LogPath
 Specifies the full path and file name to log to.
-If not set, the default is `%WINDIR%\Logs\Dism\dism.log`.
+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.
@@ -185,13 +192,9 @@ Accept wildcard characters: False
 ```
 
 ### -Source
-Specifies the location of the files that are required to add a Windows capability package to an image.
-You can specify the Windows directory of a mounted image or a running Windows installation that is shared on the network.
-
-If you specify multiple *Source* arguments, the files are gathered from the first location where they are found and the rest of the locations are ignored.
-Separate source locations with a comma.
+Specifies the location of the files that are required to add a Windows capability package to an image. If you specify multiple *Source* arguments, the files are gathered from the first location where they are found and the rest of the locations are ignored. Separate source locations with a comma.
 
-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, if *LimitAccess* is not specified. When all fail, the cmdlet fails silently; no exceptions are thrown.
+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.
 
@@ -252,9 +255,10 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 ## NOTES
 
-## RELATED LINKS
+As of Windows 10 version 1709, you cannot use Windows Server Update Services (WSUS) to host Features on Demand (FOD) and language packs for Windows 10 clients. Instead, you can enforce a Group Policy setting that tells the clients to download them directly from Windows Update. You can also host FOD and language packs on a network share, but starting with Windows 10 version 1809, FOD and language packs can only be installed from Windows Update. For more information, see [How to make Features on Demand and language packs available when you're using WSUS/SCCM](https://docs.microsoft.com/windows/deployment/update/fod-and-lang-packs).
 
-[Get-WindowsCapability](./Get-WindowsCapability.md)
+## RELATED LINKS
 
-[Remove-WindowsCapability](./Remove-WindowsCapability.md)
+- [Get-WindowsCapability](./Get-WindowsCapability.md)
+- [Remove-WindowsCapability](./Remove-WindowsCapability.md)
 
diff --git a/docset/windows/failoverclusters/get-clusterlog.md b/docset/windows/failoverclusters/get-clusterlog.md
@@ -48,7 +48,7 @@ Mode                LastWriteTime     Length Name
 -a---          9/4/2008   3:53 PM    1261025 Cluster.log
 ```
 
-This command creates a log file for the local cluster in the cluster reports folder on each node of the cluster.
+This command creates a log file for the local cluster in the cluster reports folder (C:\Windows\Cluster\Reports) on each node of the cluster.
 
 ### Example 2: Create log files for each node and save them locally
 ```
@@ -70,7 +70,7 @@ Mode                LastWriteTime     Length Name
 -a---          9/4/2008   4:01 PM     104181 Cluster.log
 ```
 
-This command creates a log file for the local cluster in the cluster reports folder on each node of the cluster.
+This command creates a log file for the local cluster in the cluster reports folder (C:\Windows\Cluster\Reports) on each node of the cluster.
 The log covers the last 5 minutes.
 
 ## PARAMETERS
@@ -94,6 +94,7 @@ Accept wildcard characters: False
 ### -Destination
 Specifies the location to which to copy one or more cluster logs.
 To copy to the current folder, use `.` for this parameter input.
+Default location is C:\Windows\Cluster\Reports.
 
 ```yaml
 Type: String
diff --git a/docset/windows/netsecurity/new-netfirewallrule.md b/docset/windows/netsecurity/new-netfirewallrule.md
@@ -416,7 +416,7 @@ Specifies the ICMP type codes.
 The key encoding is specified by running the Set-NetFirewallSetting cmdlet with the *KeyEncoding* parameter. 
 The acceptable values for this parameter are:
 
-- ICMP type code: 0 through 255. 
+- ICMP type code: 0-255. 
 - ICMP type code pairs: 3:4. 
 - Keyword: Any. 
 A rule can be queried for this condition, modified by using the security filter object, or both.
@@ -483,8 +483,8 @@ The acceptable formats for this parameter are:
 - IPv4 Subnet (by network bit count):  1.2.3.4/24 
 - IPv6 Subnet (by network bit count):  fe80::1/48 
 - IPv4 Subnet (by network mask):  1.2.3.4/255.255.255.0 
-- IPv4 Range: 1.2.3.4 through 1.2.3.7 
-- IPv6 Range: fe80::1 through fe80::9 
+- IPv4 Range: 1.2.3.4-1.2.3.7 
+- IPv6 Range: fe80::1-fe80::9 
 Querying for rules with this parameter can only be performed using filter objects.
 See the Get-NetFirewallAddressFilter cmdlet for more information.
 
@@ -528,12 +528,12 @@ Accept wildcard characters: False
 Specifies that network packets with matching IP local port numbers match this rule. 
 The acceptable value is a port, range, or keyword and depends on the protocol. 
 If the *Protocol* parameter value is TCP or UDP, then the acceptable values for this parameter are: 
-- Port range: 0 through 65535. 
+- Port range: 0-65535. 
 - Port number: 80. 
 - Keyword: PlayToDiscovery or Any. 
 If the *Protocol* parameter value is ICMPv4 or ICMPv6, then the acceptable values for this parameter are: 
 - An ICMP type, code pair: 0, 8. 
-- Type and code: 0 through 255. 
+- Type and code: 0-255. 
 - Keyword: Any. 
 If the *Protocol* parameter is not specified, then the acceptable values for this parameter are: RPC, RPCEPMap, Teredo, IPHTTPSIn, IPHTTPSOut, or Any. 
 IPHTTPS is only supported on Windows Server 2012. 
@@ -784,7 +784,7 @@ Specifies that network packets with matching IP addresses match this rule.
 This parameter specifies the protocol for an IPsec rule. 
 The acceptable values for this parameter are:
 
-- Protocols by number:  0 through 255. 
+- Protocols by number:  0-255. 
 - Protocols by name:  TCP, UDP, ICMPv4, or ICMPv6. 
 If a port number is identified by using port1 or port2, then this parameter must be set to TCP or UDP. 
 The values ICMPv4 and ICMPv6 create a rule that exempts ICMP network traffic from the IPsec requirements of another rule. 
@@ -815,8 +815,8 @@ The acceptable formats for this parameter are:
 - IPv4 Subnet (by network bit count):  1.2.3.4/24 
 - IPv6 Subnet (by network bit count):  fe80::1/48 
 - IPv4 Subnet (by network mask):  1.2.3.4/255.255.255.0 
-- IPv4 Range: 1.2.3.4 through 1.2.3.7 
-- IPv6 Range: fe80::1 through fe80::9 
+- IPv4 Range: 1.2.3.4-1.2.3.7 
+- IPv6 Range: fe80::1-fe80::9 
 - Keyword: Any, LocalSubnet, DNS, DHCP, WINS, DefaultGateway, Internet, Intranet, IntranetRemoteAccess, PlayToDevice. NOTE: Keywords can be restricted to IPv4 or IPv6 by appending a 4 or 6 (for example, keyword "LocalSubnet4" means that all local IPv4 addresses are matching this rule).
 
 Querying for rules with this parameter can only be performed using filter objects.
@@ -859,12 +859,12 @@ This parameter value is the second end point of an IPsec rule.
 The acceptable value is a port, range, or keyword and depends on the protocol. 
 If the protocol is TCP or UDP, then the acceptable values for this parameter are: 
 
-- Port range: 0 through 65535 
+- Port range: 0-65535 
 - Port number: 80 
 - Keyword: Any 
 If the protocol is ICMPv4 or ICMPv6, then the acceptable values for this parameter are: 
 - An ICMP type, code pair: 0, 8 
-- Type and code: 0 through 255 
+- Type and code: 0-255 
 - Keyword: Any. 
 
 If a protocol is not specified, then the acceptable values for this parameter are: Any, RPC, RPC-EPMap, or IPHTTPS. 
diff --git a/docset/winserver2012r2-ps/addsadministration/Search-ADAccount.md b/docset/winserver2012r2-ps/addsadministration/Search-ADAccount.md
@@ -224,7 +224,7 @@ Accept wildcard characters: False
 Indicates that this cmdlet searches for accounts that have not logged in within a given time period or since a specified time.
 To specify a time period, use the **TimeSpan** parameter.
 To specify a specific time, use the **DateTime** parameter.
-Note that this attribute is only used when the domain is in Windows Server 2003 Domain Functional Level, so this parameter will only work in that mode.
+Note that this attribute is only used when the domain is in Windows Server 2003 Domain Functional Level or higher, so this parameter will only work in that mode.
 
 ```yaml
 Type: SwitchParameter
